Gestire gli aggiornamenti Google

Per garantire la massima precisione possibile del profilo della tua attività, Google utilizza informazioni provenienti da fonti come segnalazioni degli utenti e contenuti concessi in licenza. Se le informazioni fornite dai proprietari delle attività vengono segnalate come non corrette, Google invia una notifica ai proprietari delle schede. I proprietari delle schede 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 di Google, completa i seguenti passaggi:

  1. Trovare sedi con aggiornamenti in attesa
  2. Esamina 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 scoprire per quali sedi sono disponibili gli aggiornamenti Google. Il modo migliore per ricevere gli aggiornamenti di Google per le sedi è gestire le notifiche in tempo reale con Cloud Pub/Sub. Se ricevi una GOOGLE_UPDATE notifica sull'argomento Pub/Sub, una modifica è pronta per la revisione. Il campo locationName della notifica fornisce il nome della risorsa della località con gli aggiornamenti di Google.

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

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 di pubblicazione (ciò che i clienti vedono su Google Maps e nella Ricerca) differiscono dai valori preferiti locali. Ciò è in genere dovuto agli aggiornamenti di Google o ai 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 pubblicato su Google Maps e sulla Ricerca. Non devi intraprendere alcuna azione in merito a 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"
}

Accettare o rifiutare gli aggiornamenti

Per risolvere i campi elencati in diffMask, devi accettare o rifiutare gli aggiornamenti utilizzando una richiesta locations.patch:

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

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

Accettare 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"
     },
    ...
}

Rifiutare 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 posizione viene patchata correttamente, il campo diffMask nella risposta locations.getGoogleUpdated 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 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.