Examiner la sémantique des flux
La sémantique du flux d'avis est légèrement nuancée :
Pour les flux d'avis instantanés :
- Si un fournisseur de services du flux d'avis n'existe pas dans la base de données des fournisseurs Local Services, ses avis ne seront pas ingérés.
- Si un fournisseur de services figurant dans le flux d'avis existe actuellement dans la base de données des fournisseurs Annonces Local Services, ses avis seront traités comme suit :
- Pour tout avis figurant dans le flux, s'il n'existe pas dans le stockage LSA, il doit être créé.
- Pour tout avis figurant dans le flux, s'il existe un avis correspondant dans le stockage LSA, il sera mis à jour avec les nouvelles informations.
- Pour tout avis ne figurant pas dans le flux, s'il existe un avis correspondant dans le stockage LSA, il sera supprimé.
- Si un fournisseur de services ne figure pas dans le flux d'avis, mais qu'il existe actuellement dans la base de données des fournisseurs LSA, ses avis seront supprimés et il cessera de diffuser des annonces.
- Notez qu'un fournisseur sans avis doit également avoir une entrée (au lieu d'être omis) dans les flux d'avis pour pouvoir diffuser des annonces (voir l'exemple de flux d'avis : listingId 2).
Notez que les flux partiels ne sont pas acceptés pour les flux d'avis. Un flux d'avis correspondant est requis pour chaque flux de fiche.
Gestion des erreurs dans les avis
Si une fiche d'avis est incorrecte, nous ne la traiterons pas et continuerons de traiter les autres fiches valides.
Si un flux d'avis n'est pas valide (par exemple, s'il n'est pas conforme au schéma), nous cesserons de traiter l'intégralité du flux d'avis.
Examiner les champs
| Nom du champ | Type | Description | Exemple | Obligatoire | Contraintes |
|---|---|---|---|---|---|
| serviceProviderId | Total | Identifiant unique d'une fiche (un fournisseur de services) | 12345 | Oui | Doit tenir dans un int64 |
| ratingCount | entier | Nombre d'avis de consommateurs validés | 10 | Oui | Cette valeur doit être égale ou supérieure à zéro. |
| auteur | chaîne | Nom de l'auteur de l'avis | "Jack L." | Non | |
| reviewId | chaîne | Identifiant unique de l'avis. Si chaque avis ne comporte pas d'identifiant unique, vous devez demander à un tiers de générer un identifiant unique pour chaque avis (par exemple, le hachage du texte de l'avis et de l'utilisateur), au moins unique parmi tous les avis d'un même fournisseur. | "123" | Oui | |
| reviewText | chaîne | Texte de l'avis rédigé par l'auteur | "Bravo !" | Non | |
| rating | entier | Note (doit être un entier compris entre 1 et 5) | 4 | Oui | Veuillez saisir un nombre entier compris entre 1 et 5. |
| serviceLocationCity | chaîne | Ville où le service a été effectué | "New York" | Non | |
| reviewTimestampMicros | entier | Horodatage de la rédaction de l'avis, au format microsecondes. | 1.45142E+15 | Non | |
| serviceTimestampMicros | entier | Code temporel indiquant la fin du service, au format microsecondes. | 1.45132E+15 | Non | |
| language | chaîne | Langue du texte de l'avis, sous la forme d'un code de langue ISO 639-1 (deux lettres en minuscules). Doit correspondre à une langue de ciblage du fournisseur. | "en" | Non | Doit correspondre à une langue de ciblage spécifiée pour le fournisseur associé. Si aucune valeur n'est spécifiée, la valeur par défaut est "en". |
| catégorie | objet | structure des catégories | Non | ||
| category->categoryId | enum | catégorie du service (dans la taxonomie LSA) | "garage_door_pro" | Non | |
| category->task | enum | Type de tâche du service (dans la taxonomie LSA) | "Réparer une porte de garage" | Non | |
| confirmedCustomer | booléen | Si l'avis provient d'un client confirmé (avec un prospect) | TRUE | Non |