Esaminare la semantica dei feed
La semantica del feed delle recensioni è leggermente diversa:
Per i feed di revisione degli snapshot:
- Qualsiasi fornitore di servizi nel feed delle recensioni, se al momento non esiste nel database dei fornitori di annunci di Servizi locali, le recensioni del fornitore non verranno inserite.
- Qualsiasi fornitore di servizi nel feed delle recensioni, se il fornitore esiste attualmente nel
database dei fornitori di annunci di Servizi locali, le recensioni del fornitore verranno elaborate come
segue:
- Per qualsiasi recensione nel feed, se la recensione corrispondente non esiste nello spazio di archiviazione LSA, deve essere creata.
- Per qualsiasi recensione nel feed, se esiste una recensione corrispondente nello spazio di archiviazione LSA, la recensione verrà aggiornata con le nuove informazioni.
- Per qualsiasi recensione non presente nel feed, se esiste una recensione corrispondente nello spazio di archiviazione LSA, la recensione verrà eliminata.
- Qualsiasi fornitore di servizi non presente nel feed delle recensioni, se attualmente esiste nel database dei fornitori di annunci di Servizi locali, le sue recensioni verranno eliminate e il fornitore non pubblicherà più annunci.
- Tieni presente che anche un fornitore con 0 recensioni deve avere una voce (anziché essere omesso) nei feed delle recensioni per poter essere pubblicato (vedi Esempio di feed delle recensioni - listingId 2)
Tieni presente che l'incrementale non è supportato per i feed delle recensioni. Per ogni feed del profilo è necessario un feed delle recensioni corrispondente.
Gestione degli errori nelle recensioni
Se un elemento del feed delle recensioni non è valido, ne salteremo l'elaborazione e continueremo a elaborare gli elementi del feed validi rimanenti.
Se un feed delle recensioni non è valido (ad es. non è conforme allo schema), interromperemo l'elaborazione dell'intero feed.
Campi di revisione
| Nome campo | Tipo | Descrizione | Esempio | Obbligatorio | Vincoli |
|---|---|---|---|---|---|
| serviceProviderId | numero | Identificatore univoco di una scheda (un fornitore di servizi) | 12345 | Sì | Deve rientrare in int64 |
| ratingCount | integer | Numero di valutazioni dei consumatori verificate | 10 | Sì | Deve essere pari a zero o maggiore. |
| autore | stringa | Il nome dell'autore della recensione | "Jack L." | No | |
| reviewId | stringa | L'ID univoco della recensione. Se ogni recensione non è dotata di un ID univoco, è necessario che la terza parte generi un ID univoco per ogni recensione (ad es.hash del testo della recensione e dell'utente), almeno univoco tra tutte le recensioni di un fornitore. | "123" | Sì | |
| reviewText | stringa | Testo della recensione scritto dall'autore | "Ottimo lavoro!" | No | |
| classificazione | integer | Valutazione (deve essere un numero intero compreso tra 1 e 5) | 4 | Sì | Deve essere un numero intero compreso tra 1 e 5. |
| serviceLocationCity | stringa | Città in cui è stato eseguito il servizio | "New York" | No | |
| reviewTimestampMicros | integer | Timestamp di scrittura della recensione in formato microsecondi. | 1.45142E+15 | No | |
| serviceTimestampMicros | integer | Timestamp di completamento del servizio nel formato microsecondi. | 1.45132E+15 | No | |
| language | stringa | Lingua del testo della recensione nel codice lingua ISO 639-1 (minuscolo, due lettere). Deve corrispondere a una lingua di targeting del fornitore. | “en” | No | Deve corrispondere a una lingua di targeting specificata per il fornitore associato. Se non specificato, il valore predefinito è "en". |
| category | oggetto | struttura delle categorie | No | ||
| category->categoryId | enum | categoria del servizio (nella tassonomia LSA) | "garage_door_pro" | No | |
| categoria->attività | enum | Tipo di lavoro (attività) del servizio (nella tassonomia LSA) | "Riparare una porta di garage" | No | |
| confirmedCustomer | booleano | Se la recensione proviene da un cliente confermato (con un lead) | VERO | No |