Specyfikacja Atom 1.0

Dokument ten zawiera wskazówki dotyczące tworzenia plików danych o produktach XML w formacie Atom 1.0. Podlinkowaliśmy standardowe atrybuty do odpowiednich sekcji w oficjalnej specyfikacji Atom 1.0, aby pomóc Ci odnaleźć dodatkowe informacje o komponentach zawartych w naszych przykładach. Chociaż udostępniamy przykładowe pliki Atom 1.0, informacje o Atom 1.0 ograniczyliśmy do minimum. Więcej informacji o tym standardzie znajdziesz w specyfikacji pod adresem Atom Syndication Format.

Aby pobrać przykładowy plik Atom 1.0, kliknij tutaj.

Sekcja 1: Atom 1.0

W oparciu o specyfikację Atom 1.0, na poziomie wstępnym jest pięć predefiniowanych elementów – tytuł, identyfikator, link, streszczenie i aktualizacja. Chociaż są one opcjonalne w standardzie Atom 1.0, pliki danych produktów ich wymagają.

Pliki danych produktów wymagają także dodatkowych elementów, takich jak cena czy stan. Aby można było uwzględnić inne szczegółowe informacje o produkcie, rozszerzyliśmy Atom 1.0 o przestrzeń nazw Google Merchant Center. Jej zdefiniowanie umożliwia dodanie elementów zwanych „atrybutami”, a także zwiększa ilość informacji, jakie można dodać o każdym z produktów za pomocą pliku danych.

Poniżej znajduje się przykład podstawowego dokumentu Atom 1.0 zawierającego jedną pozycję:

<?xml version="1.0"?>
<plik danych xmlns="http://www.w3.org/2005/Atom"

xmlns:g="http://base.google.com/ns/1.0">
<title>Nazwa pliku danych</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <updated>2006-06-11T18:30:02Z</updated> <author> <name>Google</name> </author>
<id>tag:example.com,2006-06-11:/support/products</id> <entry> 
<title>Czerwony wełniany sweter</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Wygodny i miękki sweter, który ogrzeje Cię w zimowe wieczory.</summary> 

<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>
</entry> </plik danych>

 

Dwie główne zmiany w tym przykładzie to dodatkowa deklaracja przestrzeni nazw i uwzględnienie 3 atrybutów (link do zdjęcia [image_link], cena [price] i stan [condition]).

Deklaracja przestrzeni nazw Google Merchant Center

Poniższa deklaracja przestrzeni nazw jest wymagana, aby możliwe było korzystanie z atrybutów zdefiniowanych w przestrzeni nazw Google Merchant Center.

xmlns:g="http://base.google.com/ns/1.0"

Oprócz deklaracji przestrzeni nazw Google Merchant Center konieczne jest również dodanie prefiksu do każdego tagu atrybutu. Ma to na celu odróżnienie atrybutów zdefiniowanych w naszej przestrzeni nazw od elementów zdefiniowanych w Atom 1.0. Prefiks wybrany do tej deklaracji przestrzeni nazw to „g”:

<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>

Atrybuty w przestrzeni nazw Google Merchant Center muszą zawierać ten prefiks, w przeciwnym razie zostaną zignorowane wraz z przypisanymi do nich wartościami.

Atrybuty

Możesz zastosować dowolną liczbę atrybutów. Podanie dodatkowych informacji o Twoich produktach za ich pomocą znacznie zwiększy szanse Twoich produktów na pojawienie się w wynikach wyszukiwania. Dodatkowo wiele atrybutów zdefiniowanych w przestrzeni nazw Google Merchant Center można w ramach jednego produktu wykorzystać więcej niż raz. Dzięki temu możesz dodać więcej istotnych informacji o produktach w pliku danych.

Sekcja 2. Ważna lista kontrolna

Przed przesłaniem pliku zalecamy sprawdzenie jego prawidłowego formatowania zgodnie z poniższą listą:

1. Nazwa pliku musi być zakończona rozszerzeniem .xml.
2. Nazwa pliku danych zarejestrowana na koncie Google Merchant Center musi być taka sama jak rzeczywista nazwa pliku.
3. Pamiętaj o umieszczeniu deklaracji przestrzeni nazw. Wartości muszą zgadzać się z poniższymi.
   1. Przestrzeń nazw Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. Przestrzeń nazw atrybutów niestandardowych: xmlns:[prefiks]="http://base.google.com/cns/1.0", gdzie [prefiks] zastępuje prefiks zawarty w pliku.
4. Sprawdź, czy prefiks w tagach atrybutów w Google Merchant Center i niestandardowym Google Merchant Center zgadza się z prefiksem zdefiniowanym w deklaracji przestrzeni nazw.
5. Usuń atrybuty niezawierające żadnych wartości.

Sekcja 3: Uwagi końcowe

Przykładowy wpis w dokumencie został uproszczony, by lepiej zobrazować podstawy tworzenia pliku danych w formacie XML dla Google Merchant Center. Chociaż akceptujemy pliki danych zawierające inne elementy zdefiniowane w standardzie Atom 1.0 lub w Twojej własnej przestrzeni nazw, wszelkie informacje w nich zawarte będą ignorowane podczas przetwarzania i nie pojawią się w reklamach ani bezpłatnych informacjach o produkcie. Na tym etapie przetwarzane będą jedynie dane zawarte w domyślnych elementach Atom 1.0 oraz w atrybutach w przestrzeniach nazw Google Merchant Center i niestandardowego Google Merchant Center.