Specificații Atom 1.0

Acest document oferă îndrumări privind crearea unui feed XML de date despre produse, în formatul Atom 1.0. Am asociat atributele standard cu secțiunile respective din specificația oficială Atom 1.0 pentru a vă ajuta să găsiți informații suplimentare despre componentele din exemplele noastre. Deși oferim exemple de fișiere Atom 1.0, furnizăm detalii minime despre Atom 1.0. Dacă sunteți interesat să aflați mai multe despre acest standard, vă recomandăm să consultați această specificație accesând Atom Syndication Format.

Pentru a descărca un exemplu de fișier Atom 1.0, dați clic aici.

Secțiunea 1: Atom 1.0

Conform specificației Atom 1.0, există cinci elemente predefinite la nivelul de bază: title, id, link, summary și updated Deși aceste elemente sunt opționale în standardul Atom 1.0, acestea sunt obligatorii pentru feedurile de date despre produse.

Feedurile de date despre produse necesită și elemente suplimentare, precum price și condition. Pentru a include informații mai detaliate despre un element, am extins Atom 1.0 adăugând spațiul de nume Google Merchant Center. Definirea spațiului de nume Google Merchant Center vă permite să folosiți elemente suplimentare, numite „atribute”, și să furnizați o cantitate mai mare de informații despre fiecare produs dintr-un feed.

Mai jos, se află un exemplu de document Atom 1.0 simplu, care conține un singur articol:

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

xmlns:g="http://base.google.com/ns/1.0">
<title>The name of your data feed</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>Red wool sweater</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Comfortable and soft, this sweater will keep you warm on those cold winter nights.</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> </feed>

 

Două elemente majore adăugate în acest exemplu sunt declarația privind spațiul de nume și includerea a patru atribute (link imagine [image_link], preț [price] și condiție [condition]).

Declarație privind spațiul de nume Google Merchant Center

Următoarea declarație privind spațiul de nume este necesară pentru utilizarea atributelor definite exclusiv în spațiul de nume Google Merchant Center.

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

În plus față de declararea spațiului de nume Google Merchant Center, trebuie să includeți și un prefix în fiecare etichetă a unui atribut. Adăugăm acest prefix la atribute pentru a face distincția între atributele definite în spațiul nostru de nume și elementele definite în Atom 1.0. Prefixul selectat pentru această declarație privind spațiul de nume este „g”:

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

Atributele din spațiul de nume Google Merchant Center trebuie să includă acest prefix. În caz contrar, atributele și toate valorile pe care le conțin vor fi ignorate.

Atribute

Puteți folosi un număr nelimitat de atribute relevante, specifice produselor. Trimiterea de informații suplimentare despre articole folosind aceste atribute va mări considerabil șansele produselor de a apărea în rezultate. În plus, multe atribute definite în spațiul de nume Google Merchant Center pot fi folosite de mai multe ori pentru un singur produs. Astfel, puteți să adăugați mai multe informații disponibile despre un produs din feed.

Secțiunea 2: listă de verificare importantă

Înainte de a trimite feedul, vă recomandăm să parcurgeți lista de mai jos pentru a vă asigura că fișierul este formatat corect:

1. numele fișierului dvs. trebuie să se încheie cu extensia .xml;
2. numele fișierului de feed pe care îl înregistrați în contul dvs. Google Merchant Center trebuie să corespundă numelui atribuit fișierului dvs;
3. nu uitați să includeți declarațiile privind spațiile de nume. Aceste valori trebuie să corespundă întocmai celor indicate.
   1. Spațiul de nume Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. Spațiul de nume pentru atribute personalizate: xmlns:[prefix]="http://base.google.com/cns/1.0", unde [prefix] va fi prefixul inclus în fișierul dvs.
4. verificați dacă prefixul inclus în etichetele atributelor Google Merchant Center și Custom Google Merchant Center corespunde prefixului definit în declarația privind spațiul de nume;
5. Eliminați atributele care nu conțin nicio valoare.

Secțiunea 3: Notă finală

Exemplul inclus în acest document a fost simplificat pentru a scoate în evidență elementele de bază ale creării unui feed de date XML pentru Google Merchant Center. Deși acceptăm feeduri care conțin alte elemente definite în standardul Atom 1.0 sau în propriul dvs. spațiu de nume, orice informație inclusă în aceste elemente va fi ignorată în timpul procesării și nu va apărea în anunțuri sau în înregistrările de produse gratuite. În acest moment, vom procesa numai datele conținute în elementele implicite Atom 1.0 și în atributele din spațiile de nume Google Merchant Center și Custom Google Merchant Center.