Specifiche Atom 1.0

Il presente documento fornisce le istruzioni per la creazione di un feed di dati di prodotto XML nel formato Atom 1.0. Abbiamo collegato gli attributi standard alle rispettive sezioni nelle specifiche Atom 1.0 ufficiali per aiutarti a trovare ulteriori informazioni sui componenti partendo dai nostri esempi. Anche se sono presenti esempi di file Atom 1.0, abbiamo fornito dettagli minimi sul formato Atom 1.0. Se ti interessa saperne di più su questo standard, ti suggeriamo di esaminare le specifiche riportate nel documento The Atom Syndication Format.

Per scaricare un file di esempio Atom 1.0, fai clic qui.

Sezione 1: Atom 1.0

In base alle specifiche Atom 1.0, ci sono cinque elementi predefiniti a livello di voce: title, id, link, summary e updated. Benché questi elementi siano opzionali nello standard Atom 1.0, i feed di dati di prodotto li richiedono.

I feed di dati di prodotto richiedono inoltre elementi aggiuntivi come price e condition. Per includere informazioni più dettagliate su un articolo, abbiamo esteso Atom 1.0 aggiungendo lo spazio dei nomi di Google Merchant Center. La definizione dello spazio dei nomi di Google Merchant Center ti consente di utilizzare elementi aggiuntivi, denominati "attributi" e aumentare la quantità di informazioni che puoi fornire su ogni prodotto di un feed.

Di seguito è riportato un documento Atom 1.0 di esempio contenente un singolo articolo:

<?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>

 

Le due principali modifiche in questo esempio sono l'aggiunta della dichiarazione dello spazio dei nomi e l'inclusione di tre attributi (link immagine [image_link], prezzo [price] e condizione [condition]).

Dichiarazione dello spazio dei nomi di Google Merchant Center

La seguente dichiarazione dello spazio dei nomi è necessaria al fine di utilizzare attributi definiti solo nello spazio dei nomi di Google Merchant Center.

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

Oltre a dichiarare lo spazio dei nomi di Google Merchant Center, è necessario includere anche un prefisso all'interno del tag di ogni attributo. Aggiungiamo questo prefisso agli attributi per distinguere gli attributi definiti nel nostro spazio dei nomi dagli elementi definiti in Atom 1.0. Il prefisso scelto per questa dichiarazione dello spazio dei nomi è "g":

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

Gli attributi nello spazio dei nomi di Google Merchant Center devono includere questo prefisso, altrimenti essi, e qualsiasi valore contengano, saranno ignorati.

Attributi

Puoi utilizzare tutti gli attributi pertinenti che risultino appropriati per i tuoi prodotti. L'aggiunta di informazioni supplementari sui tuoi prodotti tramite questi attributi aumenterà notevolmente le probabilità che i tuoi prodotti vengano visualizzati nei risultati. Inoltre, molti attributi definiti nello spazio dei nomi di Google Merchant Center possono essere utilizzati più di una volta in un singolo prodotto. Ciò ti permette di aggiungere nel tuo feed ulteriori informazioni disponibili su un prodotto.

Sezione 2: elenco di controllo importante

Prima di inviare il feed, ti consigliamo vivamente di esaminare il seguente elenco per assicurarti che il file sia formattato correttamente:

1. Il nome del file deve terminare con l'estensione .xml.
2. Il nome file del feed che registri nel tuo account Google Merchant Center deve corrispondere al nome che assegni al file.
3. Ricordati di includere le dichiarazioni dello spazio dei nomi. Questi valori devono corrispondere esattamente come indicato.
   1. Spazio dei nomi di Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. Spazio dei nomi degli attributi personalizzati: xmlns:[prefix]="http://base.google.com/cns/1.0", dove [prefix] è sostituito dal prefisso che hai incluso nel tuo file.
4. Verifica che il prefisso incluso nei tag degli attributi di Google Merchant Center e Google Merchant Center personalizzato corrisponda al prefisso definito nella dichiarazione dello spazio dei nomi.
5. Rimuovi gli attributi che non contengono valori.

Sezione 3: nota finale

La voce di esempio inclusa in questo documento è stata semplificata per consentire una maggiore attenzione alle nozioni di base della creazione di un feed di dati XML di Google Merchant Center. Sebbene siano accettati i feed contenenti altri elementi definiti nello standard Atom 1.0 o nel tuo spazio dei nomi, durante l'elaborazione qualsiasi informazione contenuta in tali elementi verrà ignorata e non verrà visualizzata negli annunci o nelle schede di prodotto gratuite. Al momento elaboriamo solo i dati contenuti negli elementi Atom 1.0 predefiniti e negli attributi all'interno dello spazio dei nomi di Google Merchant Center e Google Merchant Center personalizzato.