Gérer les mises à jour Google

Pour que votre profil d'établissement soit aussi précis que possible, Google utilise des informations provenant de différentes sources, telles que les rapports d'utilisateurs et les contenus sous licence. Si les informations fournies nous sont signalées comme étant incorrectes, nous en informons le propriétaire de la fiche. Celui-ci peut alors accepter ou refuser les mises à jour.

En tant que propriétaire d'une fiche, l'API My Business Business Information vous permet de vérifier que les informations sur votre établissement sont exactes. Ce guide vous explique comment accepter ou refuser les mises à jour.

Pour gérer vos mises à jour Google, complétez les étapes suivantes :

  1. Rechercher des établissements avec des mises à jour en attente
  2. Vérifier les champs mis à jour
  3. Accepter ou refuser des mises à jour
  4. Examiner les résultats

Rechercher des établissements avec des mises à jour en attente

Vous devez commencer par identifier les établissements pour lesquels il existe des mises à jour Google. Pour ce faire, le meilleur moyen est de gérer vos notifications en temps réel à l'aide de Cloud Pub/Sub. Si vous recevez une notification GOOGLE_UPDATE sur votre thème Pub/Sub, cela signifie qu'une modification est en attente d'examen de votre part. Le champ locationName de la notification indique le nom de la ressource associée à l'établissement pour lequel des mises à jour Google sont disponibles.

Vous pouvez également afficher l'appel locations.get et inspecter le Metadata pour détecter la présence de l'indicateur hasGoogleUpdated. Si "isGoogleUpdated": true, l'identifiant de lieu associé à cet établissement comporte des mises à jour.

Requête

Voici un exemple de requête locations.get :

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}

Requête

Voici un exemple de réponse locations.get :

{
  "name": "locations/{locationId}",
  "title": "Test Business",
  "phoneNumbers": {
      "primaryPhone": "02 9374 4000"
   },
  ...
  "metadata": {
    "hasGoogleUpdated": true,
    ...
  }
  ...
}

Champs de mises à jour à examiner

Pour examiner les champs spécifiques contenant des mises à jour Google, appelez locations.getGoogleUpdated. Un diffMask qui détaille les champs mis à jour par Google se trouve dans le corps de la réponse.

Requête

Voici un exemple de requête locations.getGoogleUpdated :

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated

Réponse

Voici un exemple de réponse locations.getGoogleUpdated. Dans cet exemple, une mise à jour est disponible dans le champ phoneNumbers.primaryPhone. La valeur incluse dans cette réponse correspond à celle suggérée par la mise à jour :

{
  "location": {
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
  },
  "diffMask": "phoneNumbers.primaryPhone"
}

Accepter ou refuser des mises à jour

Pour accepter ou refuser une mise à jour, effectuez un appel locations.patch avec les champs updateMask définis de la même manière que dans le diffMask obtenu précédemment. Faites également correspondre les valeurs préférées pour chaque champ.

Accepter une requête

Voici un exemple de requête locations.patch :

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
}

Réponse

Voici un exemple de réponse locations.patch :

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
}

Refuser une requête

Voici un exemple de requête locations.patch :

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

Réponse

Voici un exemple de réponse locations.patch :

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

Examiner les résultats

Si le correctif a été correctement appliqué à votre établissement, le champ diffMask de la réponse locations.getGoogleUpdated affiche les valeurs en tant que "diffMask": "". En outre, l'indicateur "hasGoogleUpdated" dans Metadata indique la valeur false (ou n'affiche aucune valeur).

Si les valeurs des champs ne sont pas claires, contactez notre équipe d'assistance en envoyant la requête et la réponse pour getGoogleUpdated. La requête doit inclure la réponse avant l'appel locations.patch, l'appel du correctif et l'appel getGoogleUpdated.