Riferimento schema XML

Lo schema XML per i feed delle recensioni prodotto di Google definisce la struttura accettabile del feed XML. Gli schemi XML utilizzano l'estensione del file .xsd. Come i file DTD, uno schema XML definisce gli elementi e gli attributi che possono essere visualizzati in un documento XML.

Puoi scoprire di più sugli schemi XML in questa introduzione allo schema XML.

Lo schema XML per i feed delle recensioni prodotto è pubblicato qui: http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

Di seguito è riportata una descrizione della struttura del feed definita da questo schema. In questa descrizione, i nomi dei tipi con il prefisso xs: si riferiscono ai tipi di schema XML integrati che si trovano nello spazio dei nomi XML http://www.w3.org/2001/XMLSchema.

Il nostro sistema si aspetta sempre un feed completo. Tutte le recensioni inviate in precedenza, ma non incluse nel feed completo successivo, verranno eliminate. Pertanto, devi sempre inviare tutte le recensioni quando invii il feed.

Elemento <feed> di primo livello

L'elemento <feed> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<version> Obbligatorio (1) xs:string Indica la versione dello schema del feed delle recensioni prodotto utilizzata. Al momento è supportato solo <version>2.4</version>.
<aggregator> Facoltativo (1) aggregatorType Un publisher può utilizzare un aggregatore di recensioni per gestire le recensioni e fornire i feed. Questo elemento indica l'utilizzo di un aggregatore e contiene informazioni sull'aggregatore.
<publisher> Obbligatorio (1) publisherType Le informazioni sull'editore, che può essere un rivenditore, un produttore, una società di servizi di recensioni o qualsiasi entità che pubblica recensioni prodotto.
<reviews> Facoltativo (1) xs:sequence Contiene le recensioni del prodotto.

<feed> definisce i vincoli di unicità sugli elementi utilizzati nel feed.

Elementi secondari

<aggregator>

Un editore può utilizzare un aggregatore di recensioni per gestire le recensioni e fornire i feed. Questo elemento indica l'utilizzo di un aggregatore e contiene informazioni sull'aggregatore. L'elemento <aggregator> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<name> Obbligatorio (1) nonEmptyStringType Il nome dell'aggregatore delle recensioni prodotto.

<publisher>

Le informazioni sull'editore, che può essere un rivenditore, un produttore, una società di servizi di recensioni o qualsiasi entità che pubblica recensioni prodotto.L'elemento <publisher> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<name> Obbligatorio (1) nonEmptyStringType Il nome del publisher delle recensioni prodotto.
<favicon> Facoltativo (1) httpUrlType Un link alla favicon aziendale dell'editore. Le dimensioni dell'immagine devono essere quelle del favicon: 16x16 pixel. Il formato dell'immagine deve essere GIF, JPG o PNG.

<reviews>

Contiene le recensioni prodotto. L'elemento <reviews> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<review> Obbligatorio (da 1 a illimitato) reviewType Una singola recensione prodotto univoca. Se una recensione riguarda più prodotti nell'inventario del publisher, specifica la recensione una sola volta e includi più elementi <product> nell'elemento <products>.

<review>

Una singola recensione prodotto univoca. Se una recensione riguarda più prodotti nell'inventario dell'editore, specifica la recensione una sola volta e includi più elementi <product> nell'elemento <products>.L'elemento <review> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<review_id> Obbligatorio (1) nonEmptyStringType L'identificatore univoco permanente per la recensione prodotto nel sistema del publisher.
<reviewer> Obbligatorio (1) reviewerType L'autore della recensione prodotto.
<is_verified_purchase> Facoltativo (1) xs:boolean Indica se è stato verificato che l'autore della recensione ha acquistato il prodotto.
<is_incentivized_review> Facoltativo (1) xs:boolean Indica se il recensore ha ricevuto incentivi per recensire il prodotto.
<review_timestamp> Obbligatorio (1) xs:dateTime

Il timestamp che indica quando è stata scritta la recensione.

Esempi:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> Facoltativo (1) nonEmptyStringType Il titolo della recensione.
<content> Obbligatorio (1) nonEmptyStringType Il contenuto della recensione.
<review_language> Facoltativo (1) xs:string La lingua della recensione (BCP 47).
<review_country> Facoltativo (1) xs:string Il codice paese (ISO 3166-1) dell'autore della recensione.
<pros> Facoltativo (1) xs:sequence Contiene i pro in base all'opinione del recensore. Ometti il testo boilerplate come "pro:" a meno che non sia stato scritto dall'autore della recensione.
<cons> Facoltativo (1) xs:sequence Contiene gli svantaggi in base all'opinione del recensore. Ometti il testo standard come "contro:" a meno che non sia stato scritto dall'autore della recensione.
<reviewer_images> Facoltativo (1) xs:sequence Contiene link a immagini del prodotto fornite dall'autore della recensione.
<review_url> Obbligatorio (1) reviewUrlType L'URL della pagina di destinazione della recensione.
<ratings> Obbligatorio (1) xs:sequence Contiene le valutazioni associate alla recensione.
<products> Obbligatorio (1) xs:sequence Contiene i prodotti associati alla recensione.
<is_spam> Facoltativo (1) xs:boolean Indica se la recensione è contrassegnata come spam nel sistema del publisher.
<collection_method> Facoltativo (1) collectionMethodType

Il metodo utilizzato per raccogliere la recensione. Il valore deve essere uno dei seguenti:

unsolicited
L'utente non stava rispondendo a una richiesta specifica quando ha inviato la recensione.
post_fulfillment
L'utente ha inviato la recensione in risposta a una richiesta dopo l'evasione dell'ordine.
<transaction_id> Facoltativo (1) nonEmptyStringType Un identificatore univoco permanente della transazione associata alla recensione nel sistema del publisher. Questo ID può essere utilizzato per indicare che più recensioni sono associate alla stessa transazione.

<reviewer>

L'autore della recensione prodotto. L'elemento <reviewer> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<name> Obbligatorio (1) reviewerNameType

Il nome dell'autore della recensione.

Esempio:

<name>Jane</name>
<reviewer_id> Facoltativo (1) nonEmptyStringType

Un identificatore unico permanente per l'autore della recensione nel sistema del publisher.

Esempio:

<reviewer_id>14295</reviewer_id>

<name>

Il nome dell'autore della recensione. L'elemento <name> è un'estensione di nonEmptyStringType e contiene il nome o l'alias dell'autore della recensione. L'elemento <name> contiene questi attributi.

Attributo Occorrenza Tipo Descrizione
is_anonymous Facoltativo xs:boolean

Indica se il recensore è anonimo.

Esempio:

<name is_anonymous="true">Anonymous</name>

<pros>

Contiene i pro in base all'opinione del recensore. L'elemento <pros> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<pro> Obbligatorio (da 1 a illimitato) nonEmptyStringType

Un pro individuale basato sull'opinione del recensore. I vantaggi devono essere elencati nello stesso ordine in cui vengono visualizzati. Ometti il testo boilerplate come "Pro:" a meno che non sia stato scritto dall'autore della recensione.

Esempio:

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

Contiene gli svantaggi in base all'opinione del recensore. L'elemento <cons> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<con> Obbligatorio (da 1 a illimitato) nonEmptyStringType

Un aspetto negativo individuale basato sull'opinione del recensore. Gli svantaggi devono essere elencati nello stesso ordine in cui vengono visualizzati. Ometti il testo boilerplate come "contro:" a meno che non sia stato scritto dall'autore della recensione.

Esempio:

<cons>
  <con>Pricey</con>
</cons>

<review_url>

L'URL della pagina di destinazione della recensione. L'elemento <review_url> è un'estensione di httpUrlType e contiene il link alla pagina di destinazione della recensione. L'elemento <review_url> contiene questi attributi.

Attributo Occorrenza Tipo Descrizione
type Obbligatorio xs:string

Il tipo deve essere uno dei seguenti:

singleton
La pagina delle recensioni contiene solo questa recensione.
group
La pagina delle recensioni contiene un gruppo di recensioni, inclusa questa.

Esempio:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

Contiene immagini del prodotto fornite dall'autore della recensione. Il tag <reviewer_images> contiene molti elementi <reviewer_image>.

Elemento Occorrenza Tipo Descrizione
<reviewer_image> Obbligatorio (da 1 a illimitato) reviewImageType

Un'immagine del prodotto recensito creata dall'autore della recensione.

<reviewer_image>

Un singolo elemento immagine recensione.

Elemento Occorrenza Tipo Descrizione
<url> Obbligatorio (1) httpUrlType

Un URL a un'immagine del prodotto recensito creata dall'autore della recensione. L'URL non deve terminare con un'estensione di file immagine.

Esempio:

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

Contiene le valutazioni associate alla recensione. L'elemento <ratings> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<overall> Obbligatorio (1) ratingType La valutazione complessiva del prodotto da parte dell'autore della recensione.

<overall>

La valutazione complessiva del prodotto da parte dell'autore della recensione. L'elemento <overall> estende un xs:decimal simpleType e acquisisce la valutazione assegnata dall'autore della recensione. Il valore deve essere compreso nell'intervallo inclusivo definito dagli attributi min e max. L'elemento <overall> contiene questi attributi.

Attributo Occorrenza Tipo Descrizione
min Obbligatorio xs:integer Il numero minimo possibile per la valutazione. Deve essere la valutazione peggiore possibile e non deve essere un valore per nessuna valutazione.
max Obbligatorio xs:integer Il numero massimo possibile per la valutazione. Il valore dell'attributo max deve essere maggiore del valore dell'attributo min.

<products>

Contiene i prodotti associati alla recensione. L'elemento <products> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<product> Obbligatorio (da 1 a illimitato) productType Un prodotto associato alla recensione.

<product>

Un prodotto associato alla recensione. L'elemento <product> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<product_ids> Facoltativo (1) productIdsType Gli identificatori associati a un prodotto.
<product_name> Facoltativo (1) nonEmptyStringType Nome descrittivo di un prodotto.
<product_url> Obbligatorio (1) httpUrlType L'URL del prodotto. Questo URL può avere lo stesso valore dell'elemento <review_url>, se l'URL della recensione e quello del prodotto sono identici.

<product_ids>

Gli identificatori associati a un prodotto. L'elemento <product_ids> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<gtins> Obbligatorio (per tutte le recensioni associate a prodotti con un GTIN noto)

Facoltativo per tutte le altre recensioni (1)		 gtinsType Contiene i GTIN (Global Trade Item Number) associati a un prodotto. Sono supportati i sottotipi di GTIN (ad es. UPC, EAN, ISBN, JAN).
<mpns> Obbligatorio (per tutte le recensioni associate a prodotti con un MPN noto)

Facoltativo per tutte le altre recensioni (1)		 mpnsType Contiene i codici MPN (Manufacturer Part Number) associati a un prodotto.
<skus> Obbligatorio (per tutte le recensioni associate a prodotti con uno SKU noto)

Facoltativo per tutte le altre recensioni (1)		 skusType Contiene gli SKU (Stock Keeping Unit, articoli gestiti a magazzino) associati a un prodotto. Spesso corrisponde all'ID offerta prodotto nel feed dei prodotti.
<brands> Obbligatorio (per tutte le recensioni associate a prodotti con un brand noto)

Facoltativo per tutte le altre recensioni (1)		 brandsType Contiene i nomi dei brand associati a un prodotto.
<asins> Facoltativo (1) asinsType Contiene gli ASIN (Amazon Standard Identification Numbers) associati a un prodotto.

<gtins>

Contiene i GTIN (Global Trade Item Number) associati a un prodotto. L'elemento <gtins> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<gtin> Obbligatorio (da 1 a illimitato) nonEmptyStringType Il codice Global Trade Item Number del prodotto. Sono supportati i sottotipi di GTIN (ad es. UPC, EAN, ISBN, JAN).

<mpns>

Contiene i codici MPN (Manufacturer Part Number) associati a un prodotto. L'elemento <mpns> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<mpn> Obbligatorio (da 1 a illimitato) nonEmptyStringType Il codice MPN (Manufacturer Part Number) del prodotto.

<skus>

Contiene gli SKU (Stock Keeping Unit, articoli gestiti a magazzino) associati a un prodotto. L'elemento <skus> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<sku> Obbligatorio (da 1 a illimitato) nonEmptyStringType Il codice identificativo dell'articolo nell'inventario dell'editore.

<brands>

Contiene i nomi dei brand associati a un prodotto. L'elemento <brands> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<brand> Obbligatorio (da 1 a illimitato) nonEmptyStringType Il nome della marca del prodotto.

<asins>

Contiene gli ASIN (Amazon Standard Identification Numbers) associati a un prodotto. L'elemento <asins> contiene questi elementi nell'ordine elencato.

Elemento Occorrenza Tipo Descrizione
<asin> Obbligatorio (da 1 a illimitato) nonEmptyStringType Il numero di identificazione standard Amazon del prodotto. Ogni ASIN è composto da 10 caratteri alfanumerici.