Gestisci gli aggiornamenti Google

Per garantire la massima precisione possibile del profilo dell'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 della scheda potranno quindi accettare o rifiutare gli aggiornamenti.

In qualità di proprietario di una scheda, l'API My Business Business Information consente di esaminare questi aggiornamenti per garantire 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. Trovare sedi con aggiornamenti in attesa
  2. Esaminare i campi aggiornati
  3. Accettare o rifiutare gli aggiornamenti
  4. Esamina i risultati

Trova 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 Google per le località è gestire le notifiche in tempo reale con Cloud Pub/Sub. Se ricevi una notifica GOOGLE_UPDATE sul tuo argomento Pub/Sub, è pronta una modifica per la revisione. Il campo locationName nella notifica fornisce il nome della risorsa della località con gli Aggiornamenti Google.

In alternativa, puoi vedere la chiamata locations.get e ispezionare Metadata per verificare la presenza del flag hasGoogleUpdated. Se "isGoogleUpdated": true, l'ID luogo associato a questa sede presenta 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 degli aggiornamenti

Per esaminare i campi specifici con Aggiornamenti Google, chiama locations.getGoogleUpdated. Un diffMask che descrive in dettaglio i campi aggiornati da Google si trova nel corpo della risposta.

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 accettare o rifiutare un aggiornamento, esegui un'istruzione locations.patch con i campi updateMask impostati sullo stesso valore di diffMask che hai ottenuto in precedenza. Inoltre, associa i valori preferiti per ogni campo.

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 patch è stata applicata correttamente alla località, 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 del campo 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 patch e della chiamata getGoogleUpdated.