Gestisci gli aggiornamenti Google

Per garantire la massima precisione possibile del profilo della tua attività, Google utilizza informazioni provenienti da fonti quali segnalazioni degli utenti e contenuti concessi in licenza. Se le informazioni fornite dai proprietari delle attività sono segnalate come non è corretta, Google invia una notifica ai proprietari della scheda. I proprietari della scheda possono quindi accettare o rifiutare i aggiornamenti.

In qualità di proprietario di una scheda, l'API My Business Business Information ti consente di esaminare questi aggiornamenti per verificare le informazioni sull'attività siano accurate. Questa guida descrive come accettare o rifiutare gli aggiornamenti.

Per gestire i tuoi aggiornamenti Google, completa i seguenti passaggi:

  1. Trovare le sedi con aggiornamenti in attesa
  2. Esaminare i campi aggiornati
  3. Accettare o rifiutare gli aggiornamenti
  4. Esamina i risultati

Trovare le sedi con aggiornamenti in attesa

Prima di poter accettare o rifiutare gli aggiornamenti, devi individuare le sedi che dispongono di aggiornamenti Google disponibili. Il modo migliore per ottenere gli aggiornamenti Google per le sedi è Gestisci le notifiche in tempo reale con Cloud Pub/Sub. Se ricevi un GOOGLE_UPDATE notifica sul tuo argomento Pub/Sub, sia pronta per la revisione. Il campo locationName della notifica fornisce il nome risorsa della località con Google Updates.

In alternativa, puoi vedere la chiamata locations.get e ispezionare Metadata per la presenza del flag hasGoogleUpdated. Se "isGoogleUpdated": true, l'ID luogo associato a questa posizione è aggiornato.

Richiesta

Di seguito è riportato un locations.get esempio di richiesta:

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

Richiesta

Di seguito è riportato un locations.get esempio di risposta:

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

Rivedi i campi degli aggiornamenti

Per esaminare i campi specifici per cui sono presenti Google Updates, chiama locations.getGoogleUpdated. Un diffMask che descrive in dettaglio i campi aggiornati da Google è presente corpo della risposta.

Richiesta

Di seguito è riportato un locations.getGoogleUpdated esempio di richiesta:

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

Risposta

Di seguito è riportato un locations.getGoogleUpdated un esempio di risposta. Mostra un aggiornamento disponibile nel campo phoneNumbers.primaryPhone. Il valore in questa risposta è il valore di aggiornamento suggerito:

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

Accetta o rifiuta gli aggiornamenti

Per accettare o rifiutare un aggiornamento, esegui un locations.patch con i campi updateMask impostati come nel campo diffMask che hai ottenuti in precedenza. Inoltre, associa anche i valori preferiti per ogni campo.

Accettare una richiesta

Il seguente è un locations.patch esempio di richiesta:

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

Risposta

Di seguito è riportato un locations.patch esempio di risposta:

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

Rifiutare una richiesta

Di seguito è riportato un locations.patch esempio di richiesta:

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

Risposta

Di seguito è riportato un locations.patch esempio di risposta:

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

Esaminare i risultati

Se la patch viene applicata correttamente, il campo diffMask nella locations.getGoogleUpdated risposta mostra i valori come "diffMask": "". Inoltre, il flag "hasGoogleUpdated" all'interno di Metadata mostra il valore come false oppure non è presente alcun valore.

Se i valori del campo non sono chiari, contattare il nostro team di assistenza con la richiesta e la risposta per getGoogleUpdated. La deve includere la risposta prima del locations.patch la chiamata di patch e la chiamata getGoogleUpdated.