Schema XML

Questa sezione descrive lo schema XML utilizzato per il feed di dati delle recensioni del commerciante.

Elemento di primo livello: <feed>

Descrizione

L'elemento contenitore principale che contiene tutti gli altri elementi nel feed.

Attributi

Nome Formato Occorrenze Descrizione
xmlns xs:string Obbligatorio (1) Codifica il seguente valore:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string Obbligatorio (1) Codifica il seguente valore:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string Obbligatorio (1) Codifica in modo permanente il seguente valore, lasciando un singolo spazio vuoto tra gli URL:
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

Esempio

<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">

Contiene

Nome Formato Occorrenze Descrizione
merchants       -- Facoltativo (0-1) Elemento contenitore per gli elementi <merchant>.
deleted_merchants       -- Facoltativo (0-1) Elemento contenitore per gli elementi <deleted_merchant>.
reviews       -- Facoltativo (0-1) Elemento contenitore per gli elementi <review>.
deleted_reviews       -- Facoltativo (0-1) Elemento contenitore per gli elementi <deleted_review>.

<merchants>

Descrizione

Contenitore per gli elementi <merchant>.

Contiene

Nome Formato Occorrenze Descrizione
merchant       -- Obbligatorio (1-n) Elemento ripetuto per ogni commerciante.

<merchant>

Descrizione

Ogni elemento <merchant> contiene informazioni e recensioni per un commerciante.

Attributi

Nome Formato Occorrenze Descrizione
id Id Obbligatorio (1) Deve essere univoco e stabile in tutti i feed. In altre parole, se un feed di oggi e un feed di 90 giorni fa si riferiscono allo stesso commerciante, devono avere lo stesso ID.

Esempio

<merchant id="2739">

Contiene

Includi i seguenti elementi all'interno dell'elemento commerciante.

Nome Formato Occorrenze Descrizione
name NonEmptyString Obbligatorio (1) Nome visualizzato leggibile per il commerciante.
merchant_url xs:anyURI Obbligatorio (1) URL del sito web principale del commerciante.
Non utilizzare un URL di reindirizzamento per questo valore. In altre parole, il valore deve rimandare direttamente al sito del commerciante.

Esempio: 

<merchant_url>
  http://store.google.com
</merchant_url>

rating_url xs:anyURI Obbligatorio (1) URL della pagina di destinazione che ospita le recensioni per questo commerciante.
Non utilizzare un URL di reindirizzamento.

Esempio: 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>

create_timestamp DateTimeWithTimeZone Obbligatorio (1) Ora/data di creazione del commerciante. Non dovrebbe mai cambiare.
last_update_timestamp DateTimeWithTimeZone Obbligatorio (1) Data/ora dell'ultimo aggiornamento del commerciante. Se uno dei campi dell'elemento <merchant> viene aggiornato per un determinato ID commerciante, anche questo valore deve cambiare.

<deleted_merchants>

Descrizione

Contenitore per i commercianti eliminati.

Contiene

Nome Formato Occorrenze Descrizione
deleted_merchant       -- Obbligatorio (1-n) Contiene uno o più elementi correlati a un singolo commerciante eliminato.

<deleted_merchant>

Descrizione

Commerciante eliminato.

Attributi

Nome Formato Occorrenze Descrizione
id Id Obbligatorio (1) Specifica l'ID di un commerciante da eliminare dal feed. L'ID deve corrispondere all'attributo id di un elemento <merchant> in qualsiasi file di feed precedente.

Contiene

Nome Formato Occorrenze Descrizione
last_update_timestamp DateTimeWithTimeZone Obbligatorio (1) Data/ora in cui un commerciante è stato rimosso dal sistema.

Esempio: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

Esempio

<deleted_merchant id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp>
</deleted_merchant>

<reviews>

Descrizione

Contenitore per gli elementi <review>.

Contiene

Nome Formato Occorrenze Descrizione
review       -- Obbligatorio (1-n) Elemento ripetuto per ogni recensione.

<review>

Descrizione

Contenitore per i dettagli relativi a una recensione.

Attributi

Nome Formato Occorrenze Descrizione
id Id Obbligatorio (1) L'identificatore di una recensione nel tuo sistema. Deve essere univoco e stabile in tutti i feed.

Esempio: 

<review id=132739 mid=1234>

mid Id Obbligatorio (1) L'identificatore del commerciante a cui si riferisce la recensione.

Contiene

Includi i seguenti elementi all'interno dell'elemento recensione.

Nome Formato Occorrenze Descrizione
reviewer_name NonEmptyString Facoltativo (0-1) Nome visualizzato dell'autore della recensione, a condizione che la recensione debba avere un autore con nome. Le recensioni anonime non devono includere questo campo.

Esempio: 

<reviewer_name>
  Joel
</reviewer_name>

create_timestamp DateTimeWithTimeZone Obbligatorio (1) Ora/data in cui la recensione è stata inviata dall'utente. Non dovrebbe mai cambiare.

Esempio: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>

last_update_timestamp DateTimeWithTimeZone Obbligatorio (1) Data/ora dell'ultima modifica delle informazioni nell'elemento <review>. Se uno dei campi dell'elemento <review> viene aggiornato per un determinato ID recensione, anche questo valore deve cambiare.

Esempio: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

country_code CountryCode Obbligatorio (1) Paese del recensore. Se disponibile, questo è il paese in cui è stato spedito il prodotto o in cui è stato fornito il servizio. In caso contrario, utilizza il paese in cui si trova l'autore della recensione al momento della creazione della stessa. Il codice paese deve essere nel formato ISO 3166-1 alpha-2.

Esempio: 

  <country_code>
    US
  </country_code>

title xs:string Facoltativo (0-1) Il titolo della recensione. Il titolo deve essere in formato di testo normale, senza tag HTML.

Esempio: 

  <title>
    Great prices
  </title>

content xs:string Obbligatorio (1) Il contenuto della recensione. Deve essere un testo in formato libero fornito dall'utente e non deve essere troncato. I contenuti devono essere in testo normale senza tag HTML. Ad esempio, un'interruzione di riga deve essere rappresentata da un carattere di avanzamento riga, non da un tag <br>. Se vengono fornite più risposte a domande diverse, tutte le risposte devono essere incluse, con il contesto minimo per dare un senso alle risposte. Il contesto non deve essere fornito se le domande sono rimaste senza risposta.

Esempio: 

  <content>
    I like this store!
    My order arrived on time and I got
    a great price.
  </content>

Esempio: 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings           -- Obbligatorio (1) Elemento contenitore per le valutazioni del commerciante da parte dell'autore della recensione. Se non è disponibile alcuna valutazione per l'elemento <overall>, l'intera recensione associata deve essere esclusa dal feed perché l'elemento <overall> è obbligatorio e la recensione non verrà accettata senza.
collection_method CollectionMethodType Obbligatorio (1) Il metodo utilizzato per raccogliere la recensione. Il valore deve essere uno dei seguenti:
  • non richiesta: l'utente non stava rispondendo a una richiesta specifica quando ha inviato la recensione.
  • point_of_sale: l'utente ha inviato la recensione in risposta a una richiesta quando ha effettuato un ordine.
  • after_fulfillment: l'utente ha inviato la recensione in risposta a una richiesta dopo l'evasione dell'ordine.

Esempio: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Descrizione

Contiene le valutazioni del commerciante da parte del recensore. Se non è disponibile alcuna valutazione per l'elemento <overall>, l'intera recensione associata deve essere esclusa dal feed perché l'elemento <overall> è obbligatorio e la recensione non verrà accettata senza.

Contiene

Includi i seguenti elementi all'interno dell'elemento delle valutazioni.

Nome Formato Occorrenze Descrizione
overall RatingRange Obbligatorio (1) Valutazione complessiva di un commerciante da parte di un recensore.

Esempio: 

  <overall min="1" max="10">9</overall>

customer_service RatingRange Facoltativo (0-1) Valutazione della qualità del servizio clienti per questo commerciante da parte dell'autore della recensione.

Esempio: 

  <customer_service min="1" max="5">3</customer_service>

<deleted_reviews>

Descrizione

Contenitore per le recensioni eliminate.

Contiene

Nome Formato Occorrenze Descrizione
deleted_review       -- Obbligatorio (1-n) Contiene elementi relativi a una singola recensione eliminata.

<deleted_review>

Descrizione

Recensione eliminata.

Attributi

Nome Formato Occorrenze Descrizione
id Id Obbligatorio (1) Specifica l'ID di una recensione da eliminare dal feed. L'ID deve corrispondere all'attributo id di un elemento <review> in qualsiasi file di feed.

Contiene

Nome Formato Occorrenze Descrizione
last_update_timestamp DateTimeWithTimeZone Obbligatorio (1) Ora in cui una recensione è stata rimossa dal sistema.

Esempio: 

  <last_update_timestamp>
    2016-04-03T18:37:32Z
  </last_update_timestamp>

Esempio

<deleted_review id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp>
</deleted_review>