Riferimento schema XML

Libro: /product-review-feeds/_book.yaml

Titolo: Riferimento schema XML

Lo schema XML per i feed di recensione dei prodotti di Google definisce la struttura accettabile del tuo feed XML. Gli schemi XML utilizzano l'estensione del file .xsd. Analogamente ai 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 da questo primi di schema XML.

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

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

Il nostro sistema prevede sempre un feed completo. Le recensioni inviate in precedenza, ma non incluse nel successivo feed completo, verranno eliminate. Di conseguenza, devi sempre inviare tutte le tue recensioni quando invii il feed.

Elemento <feed> di primo livello

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

Elemento Occorrenza Tipo Descrizione
<version> Obbligatorio (1) xs:string Indica quale versione dello schema del feed delle recensioni prodotto viene utilizzata. Al momento è supportato solo <version>2.3</version>.
<aggregator> Facoltativo (1) aggregatorType 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.
<publisher> Obbligatorio (1) publisherType Le informazioni relative all'editore, che possono essere un rivenditore, un produttore, una società di servizi di recensioni o qualsiasi entità che pubblica recensioni dei prodotti.
<reviews> Facoltativo (1) xs:sequence Contiene le recensioni prodotto.

<feed> definisce i vincoli di univocità per gli elementi utilizzati nel feed.

Elementi secondari

<aggregator>

Un editore potrebbe 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 possono 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 indicato.

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

<reviews>

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

Elemento Occorrenza Tipo Descrizione
<review> Obbligatorio (1 senza limiti) reviewType Recensione di un singolo prodotto unico. Se una recensione riguarda più prodotti nell'inventario del publisher, specifica la recensione una volta e includi più elementi <product> nell'elemento <products>.

<review>

Recensione di un singolo prodotto unico. Se una recensione riguarda più prodotti nell'inventario del publisher, specifica la recensione una sola volta e includi più <product> elementi nell'elemento <products>.L'elemento <review> contiene questi elementi nell'ordine indicato.

Elemento Occorrenza Tipo Descrizione
<review_id> Facoltativo (1) nonEmptyStringType L'identificatore univoco permanente per la recensione del prodotto nel sistema dell'editore.
<reviewer> Obbligatorio (1) reviewerType L'autore della recensione del 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 I contenuti della recensione.
<pros> Facoltativo (1) xs:sequence Contiene i fornitori in base all'opinione del recensore. Ometti testo boilerplate come "pro:" a meno che non sia stato scritto dal recensore.
<cons> Facoltativo (1) xs:sequence Contiene i contro in base all'opinione del recensore. Ometti testo boilerplate come "con:" a meno che non sia stato scritto dal recensore.
<reviewer_images> Facoltativo (1) xs:sequence Contiene link alle immagini del prodotto fornite dal recensore.
<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 dell'editore.
<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 dell'utente.
<transaction_id> Facoltativo (1) nonEmptyStringType Un identificatore univoco permanente per la transazione associata alla recensione nel sistema dell'editore. Questo ID può essere utilizzato per indicare che più recensioni sono associate alla stessa transazione.

<reviewer>

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

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 univoco permanente per l'autore della recensione nel sistema dell'editore.

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 del revisore. 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 fornitori in base all'opinione del recensore. L'elemento <pros> contiene questi elementi nell'ordine indicato.

Elemento Occorrenza Tipo Descrizione
<pro> Obbligatorio (1 senza limiti) nonEmptyStringType

Un singolo professionista in base all'opinione del recensore. I fornitori dovrebbero essere elencati nello stesso ordine in cui vengono visualizzati. Ometti testo boilerplate come "pro:" a meno che non sia stato scritto dal recensore.

Esempio:

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

<cons>

Contiene i contro in base all'opinione del recensore. L'elemento <cons> contiene questi elementi nell'ordine indicato.

Elemento Occorrenza Tipo Descrizione
<con> Obbligatorio (1 senza limiti) nonEmptyStringType

Una singola truffa in base all'opinione del recensore. I contro devono essere elencati nello stesso ordine in cui vengono visualizzati. Ometti testo boilerplate come "con:" a meno che non sia stato scritto dal recensore.

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 singola 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 fornito dal recensore. Il tag <reviewer_images> contiene molti elementi <reviewer_image>.

Elemento Occorrenza Tipo Descrizione
<reviewer_image> Obbligatorio (1 senza limiti) reviewImageType

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

<reviewer_image>

Un singolo elemento immagine di recensione.

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

Un URL che rimanda a un'immagine del prodotto recensito creato dall'autore della recensione. L'URL non deve terminare con un'estensione del 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 indicato.

Elemento Occorrenza Tipo Descrizione
<overall> Obbligatorio (1) ratingType La valutazione generale del recensore del prodotto.

<overall>

La valutazione generale del recensore del prodotto. L'elemento <overall> estende un xs:decimal simpleType e acquisisce la valutazione assegnata dal recensore. Il valore deve essere compreso nell'intervallo compreso tra gli 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. Questa dovrebbe 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 indicato.

Elemento Occorrenza Tipo Descrizione
<product> Obbligatorio (1 senza limiti) productType Un prodotto associato alla recensione.

<product>

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

Elemento Occorrenza Tipo Descrizione
<product_ids> Facoltativo (1) productIdsType I codici identificativi 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>

I codici identificativi associati a un prodotto. L'elemento <product_ids> contiene questi elementi nell'ordine indicato.

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

Facoltativo (vivamente consigliato) per tutte le altre recensioni (1)		 gtinsType Contiene i GTIN (Global Trade Item Number) associati a un prodotto.
<mpns> Obbligatorio (include il codice MPN per facilitare la corrispondenza delle recensioni se il prodotto associato alla recensione non ha un GTIN assegnato. Deve essere inviato insieme al brand)

Facoltativo per tutte le altre recensioni (1)		 mpnsType Contiene MPN (Manufacturer Part Number) associati a un prodotto.
<skus> Obbligatorio (è necessario includere lo SKU per facilitare la corrispondenza delle recensioni, se il prodotto associato alla recensione non ha un GTIN o MPN assegnato. Deve essere inviato con il brand)

Facoltativo per tutte le altre recensioni (1)		 skusType Contiene SKU (codice identificativo dell'articolo) associati a un prodotto. Spesso corrisponde all'ID offerta del prodotto nel feed dei prodotti.
<brands> Obbligatorio (il brand deve essere incluso per facilitare la corrispondenza delle recensioni se il prodotto associato alla recensione non ha un GTIN assegnato. Deve essere inviato con il codice MPN.

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

<gtins>

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

Elemento Occorrenza Tipo Descrizione
<gtin> Obbligatorio (1 senza limiti) nonEmptyStringType Il Global Trade Item Number del prodotto.

<mpns>

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

Elemento Occorrenza Tipo Descrizione
<mpn> Obbligatorio (1 senza limiti) nonEmptyStringType Il codice MPN del prodotto.

<skus>

Contiene SKU (codice identificativo dell'articolo) associati a un prodotto. L'elemento <skus> contiene questi elementi nell'ordine indicato.

Elemento Occorrenza Tipo Descrizione
<sku> Obbligatorio (1 senza limiti) nonEmptyStringType L'unità di gestione dell'inventario del prodotto nell'inventario del publisher.

<brands>

Contiene nomi di brand associati a un prodotto. L'elemento <brands> contiene questi elementi nell'ordine indicato.

Elemento Occorrenza Tipo Descrizione
<brand> Obbligatorio (1 senza limiti) nonEmptyStringType Il nome della marca del prodotto.

<asins>

Contiene ASIN (Amazon Standard Identification Number) associati a un prodotto. L'elemento contiene questi elementi nell'ordine indicato.

Elemento Occorrenza Tipo Descrizione
<asin> Obbligatorio (1 senza limiti) nonEmptyStringType Il numero di identificazione standard Amazon del prodotto. Ogni ASIN contiene 10 caratteri alfanumerici e