Acest document oferă îndrumări privind crearea unei surse 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 te ajuta să găsești 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ă dorești să afli mai multe despre acest standard, îți recomandăm să consulți această specificație accesând Atom Syndication Format.
Pentru a descărca un exemplu de fișier Atom 1.0, dă clic aici.
Secțiunea 1: Atom 1.0
Conform specificației Atom 1.0, există cinci elemente predefinite la nivelul de bază: title [titlu], id [cod], link [link], summary [rezumat] și updated [actualizat]. Deși aceste elemente sunt opționale în standardul Atom 1.0, acestea sunt obligatorii pentru sursele de date despre produse.
Sursele de date despre produse necesită și elemente suplimentare, precum price [preț] și condition [condiție]. 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 îți permite să folosești elemente suplimentare, numite „atribute”, și să furnizezi o cantitate mai mare de informații despre fiecare produs dintr-o sursă de date despre produse.
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>Denumirea sursei de date despre produse</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>Pulover roșu de lână</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Confortabil și moale, acest pulover te va încălzi în nopțile reci de iarnă.</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ă incluzi ș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
Poț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, poți să adaugi mai multe informații disponibile despre un produs din sursa de date despre produse.
Secțiunea 2: listă de verificare importantă
Înainte de a trimite sursa de date despre produse, îți recomandăm să parcurgi următoarea listă pentru a te asigura că fișierul tău este formatat corespunzător:
numele fișierului tău trebuie să se încheie cu extensia .xml;
numele fișierului cu sursa de date despre produse pe care îl înregistrezi în contul tău Google Merchant Center trebuie să corespundă numelui atribuit fișierului tău;
nu uita să incluzi declarațiile privind spațiile de nume. Aceste valori trebuie să corespundă întocmai celor indicate.
- Spațiul de nume Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - 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 tău.
verifică dacă prefixul inclus în etichetele atributelor Google Merchant Center și ale atributelor personalizate din Google Merchant Center corespunde prefixului definit în declarația privind spațiul de nume;
elimină 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 unei surse XML de date despre produse pentru Google Merchant Center. Deși acceptăm sursele de date despre produse care conțin alte elemente definite în standardul Atom 1.0 sau în propriul spațiu de nume, toate informațiile pe care le conțin aceste elemente vor fi ignorate în timpul procesării și nu vor apărea în anunțurile tale și în înregistrările de produs gratuite. În acest moment, vom procesa numai datele conținute în elementele Atom 1.0 prestabilite și în atributele din spațiul de nume Google Merchant Center și spațiul de nume personalizat din Google Merchant Center.