Specyfikacja Atom 0.3

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

Sekcja 1: Atom 0.3

Zgodnie ze specyfikacją Atom 0.3 na poziomie wstępnym są 4 predefiniowane elementy – title [tytuł], link [link], id [identyfikator] i modified [modyfikacja]. Chociaż są one opcjonalne w standardzie Atom 0.3, pliki danych ich wymagają.

Pliki danych wymagają także dodatkowych elementów, takich jak price [cena] czy condition [stan]. Aby można było uwzględnić te elementy oraz inne szczegółowe informacje o produkcie, rozszerzyliśmy Atom 0.3 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 0.3 zawierającego jedną pozycję:

<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"

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" /> <modified>2005-10-11T18:30:02Z</modified> <author> <name>Google</name> </author> <id>tag:google.com,2005-10-15:/support/products</id> <entry> <title>Czerwony wełniany sweter</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Wygodny i miękki sweter, który ogrzeje Cię w zimowe wieczory.</summary> <id>tag:google.com,2005-10-15:/support/products</id> <issued>2005-10-13T18:30:02Z</issued> <modified>2005-10-13T18:30:02Z</modified>

<g:image_link>http://www.example.com/image1.jpg</g:image_link> <g:price>25</g:price> <g:condition>nowy</g:condition>

</entry> </feed>

Dwie główne zmiany w tym przykładzie to dodatkowa deklaracja przestrzeni nazw (w 3 wierszu) 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 0.3. Prefiks wybrany do tej deklaracji przestrzeni nazw to „g”:

<g:image_link>http://www.example.com/image1.jpg</g:image_link>

Atrybuty w obszarze nazw 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 zawierające inne elementy zdefiniowane w standardzie Atom 0.3 lub w Twoim własnym obszarze nazw, wszelkie informacje w nich zawarte będą ignorowane podczas przetwarzania i nie pojawią się na liście. Na tym etapie przetwarzane będą jedynie dane zawarte w domyślnych elementach Atom 0.3 oraz w atrybutach w przestrzeniach nazw Merchant Center i niestandardowego Merchant Center.