Gestire 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à vengono segnalate come errate, Google invia una notifica ai proprietari delle schede. I proprietari della scheda possono quindi accettare o rifiutare gli aggiornamenti.

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

Per gestire gli aggiornamenti Google, completa i seguenti passaggi:

  1. Trova le sedi con aggiornamenti in attesa
  2. Esamina i campi aggiornati
  3. Accetta o rifiuta gli aggiornamenti
  4. Esamina i risultati

Trova le località con aggiornamenti in attesa

Prima di poter accettare o rifiutare gli aggiornamenti, devi scoprire quali sedi hanno aggiornamenti Google disponibili. Il modo migliore per ricevere gli aggiornamenti Google per le sedi è gestire le notifiche in tempo reale con Cloud Pub/Sub. Se ricevi una notifica GOOGLE_UPDATE sul tuo argomento Pub/Sub, significa che una modifica è pronta per la revisione. Il campo locationName della notifica fornisce il nome della risorsa della sede con gli aggiornamenti Google.

In alternativa, puoi visualizzare la chiamata locations.get e ispezionare Metadata per verificare la presenza del flag hasGoogleUpdated. Se "isGoogleUpdated": true, l'ID luogo associato a questa località contiene aggiornamenti.

Richiesta

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

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

Richiesta

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

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

Rivedi i campi aggiornati

Per esaminare i campi specifici che hanno aggiornamenti Google, chiama locations.getGoogleUpdated.

Questo metodo restituisce due maschere importanti nel corpo della risposta:

  • diffMask: indica i campi in cui i dati pubblicati (ciò che i clienti vedono su Google Maps e nella Ricerca) differiscono dai valori preferiti locali. In genere, questo è dovuto ad aggiornamenti Google o a contenuti generati dagli utenti. Devi accettare o rifiutare questi campi per risolvere la discrepanza.
  • pendingMask: indica i campi per i quali hai inviato un aggiornamento in precedenza, ma l'aggiornamento è ancora in fase di elaborazione e non è ancora stato inviato a Google Maps e alla Ricerca. Non è necessario intervenire su questi campi.

Richiesta

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

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

Risposta

Di seguito è riportato un esempio di risposta locations.getGoogleUpdated. 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 risolvere i campi elencati in diffMask, devi accettare o rifiutare gli aggiornamenti utilizzando una richiesta locations.patch:

  • Accetta un aggiornamento: applica una patch alla località utilizzando il nuovo valore restituito nella risposta getGoogleUpdated. In questo modo, il record locale viene aggiornato in modo che corrisponda ai dati di pubblicazione.
  • Rifiutare un aggiornamento: applica una patch alla sede utilizzando il valore preferito originale. In questo modo, i dati preferiti vengono riaffermati tramite la pipeline di aggiornamento e i dati di pubblicazione vengono sovrascritti.

In entrambi i casi, imposta updateMask in modo che copra i campi che vuoi risolvere.

Accetta una richiesta

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

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

Risposta

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

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

Rifiuta una richiesta

Di seguito è riportato un esempio di richiesta 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"
     },
    ...
}

Risposta

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

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

Esaminare i risultati

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

Se i valori dei campi non sono chiari, contatta il nostro team di assistenza con la richiesta e la risposta per getGoogleUpdated. La richiesta deve includere la risposta prima della chiamata locations.patch, della chiamata patch e della chiamata getGoogleUpdated.