Schema XML

Questa sezione descrive lo schema XML utilizzato per il feed di dati delle recensioni dei commercianti.

Elemento di primo livello: <feed>

Descrizione

L'elemento contenitore più in alto che contiene tutti gli altri elementi del feed.

Attributi

Nome Formato Occorrenze Descrizione
xmlns xs:stringa Obbligatorio (1) Imposta in modo hardcoded il seguente valore:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:stringa Obbligatorio (1) Imposta in modo hardcoded il seguente valore:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:stringa Obbligatorio (1) Imposta il valore seguente come hardcoded, lasciando uno 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 elementi <merchant>.
deleted_merchants - -- Facoltativo (0‐1) Elemento contenitore per elementi <deleted_merchant>.
reviews - -- Facoltativo (0‐1) Elemento contenitore per elementi <review>.
deleted_reviews - -- Facoltativo (0‐1) Elemento contenitore per 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 relative a 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 oggi e un feed 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 dal commerciante.
merchant_url xs:qualsiasiURI Obbligatorio (1) URL del sito web principale del commerciante.
Non utilizzare un URL di reindirizzamento per questo valore. In altre parole, il valore deve indirizzare direttamente al sito del commerciante.

Esempio: 

<merchant_url>
  http://store.google.com
</merchant_url>
rating_url xs:qualsiasiURI Obbligatorio (1) URL alla 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. Questo non dovrebbe cambiare.
last_update_timestamp DateTimeWithTimeZone Obbligatorio (1) Ora/data dell'ultimo aggiornamento del commerciante. Se uno qualsiasi dei campi nell'elemento <merchant> viene aggiornato per un determinato ID commerciante, anche questo valore deve essere modificato.

<deleted_merchants>

Descrizione

Contenitore per i commercianti che sono stati eliminati.

Contiene

Nome Formato Occorrenze Descrizione
deleted_merchant - -- Obbligatorio (1-n) Contiene elementi relativi a un singolo commerciante eliminato.

<deleted_merchant>

Descrizione

Commerciante che è stato eliminato.

Attributi

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

Contiene

Nome Formato Occorrenze Descrizione
last_update_timestamp DateTimeWithTimeZone Obbligatorio (1) Ora/data 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) Identificatore della recensione nel sistema. Deve essere univoco e stabile in tutti i feed.

Esempio: 

<review id=132739 mid=1234>
mid ID Obbligatorio (1) Identificatore del commerciante a cui è destinata questa 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) La data e l'ora in cui la recensione è stata inviata dall'utente. Questo non dovrebbe cambiare.

Esempio: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>
last_update_timestamp DateTimeWithTimeZone Obbligatorio (1) Ora/data in cui le informazioni nell'elemento <review> sono state modificate l'ultima volta. Se uno qualsiasi dei campi nell'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 Codice paese Obbligatorio (1) Paese del revisore. Se disponibile, è il paese in cui il prodotto è stato spedito o in cui è stato effettuato il servizio. Altrimenti, utilizza il paese in cui si trova il recensore al momento della creazione della recensione. Il codice paese deve essere in formato ISO 3166-1 alpha-2.

Esempio: 

  <country_code>
    US
  </country_code>
title xs:stringa Facoltativo (0‐1) Il titolo della recensione. Il titolo deve essere testo normale, senza tag HTML.

Esempio: 

  <title>
    Great prices
  </title>
content xs:stringa Obbligatorio (1) I contenuti della recensione. Deve essere qualsiasi testo in formato libero fornito dall'utente e non deve essere troncato. I contenuti devono essere testo normale, senza tag HTML al suo interno. Ad esempio, un'interruzione di riga deve essere rappresentata da un carattere del feed di riga, non da un tag <br>. Se vengono fornite più risposte a domande diverse, tutte devono essere incluse, con il contesto minimo in cui le risposte hanno senso. Il contesto non deve essere fornito se le domande non hanno ricevuto 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 del contenitore per le valutazioni del commerciante 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 tale elemento.
collection_method CollectionMethodType Obbligatorio (1) Il metodo utilizzato per raccogliere la recensione. Il valore deve essere uno dei seguenti:
  • non richiesto: l'utente non ha risposto a una richiesta specifica quando ha inviato la recensione.
  • point_of_sale: l'utente ha inviato la recensione in risposta a una richiesta quando l'utente ha effettuato un ordine.
  • after_fulfillment: l'utente ha inviato la recensione in risposta a una richiesta dopo l'evasione dell'ordine dell'utente.

Esempio: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

Descrizione

Contiene le valutazioni del recensore del commerciante. 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 tale elemento.

Contiene

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

Nome Formato Occorrenze Descrizione
overall RatingRange Obbligatorio (1) Valutazione complessiva del recensore per un commerciante.

Esempio: 

  <overall min="1" max="10">9</overall>
customer_service RatingRange Facoltativo (0‐1) Valutazione del recensore sulla qualità dell'assistenza clienti di questo commerciante.

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 correlati a una singola recensione eliminata.

<deleted_review>

Descrizione

Controlla che è stato eliminato.

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