Gestire gli aggiornamenti Google

Per garantire la massima precisione possibile del profilo della tua attività, Google utilizza informazioni tratte 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 Informazioni sull'attività di My Business ti consente di esaminare questi aggiornamenti per assicurarti che le informazioni sulla tua attività siano accurate. Questa guida spiega come accettare o rifiutare gli aggiornamenti.

Per gestire gli aggiornamenti di Google, svolgi i seguenti passaggi:

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

Trovare le sedi con aggiornamenti in attesa

Prima di poter accettare o rifiutare gli aggiornamenti, devi scoprire quali località dispongono degli aggiornamenti Google. Il modo migliore per ricevere gli aggiornamenti di Google per le stazioni di ricarica è gestire le notifiche in tempo reale con Cloud Pub/Sub. Se ricevi una GOOGLE_UPDATE notifica sul tuo argomento Pub/Sub, una modifica è pronta per la revisione. Il campo locationName nella notifica fornisce il nome della risorsa della stazione di ricarica con gli aggiornamenti Google.

In alternativa, puoi visualizzare la chiamata locations.get ed esaminare Metadata per verificare la presenza del flag hasGoogleUpdated. Se "isGoogleUpdated": true, l'ID luogo associato a questa località ha 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 che contengono gli aggiornamenti Google, chiama locations.getGoogleUpdated. Un diffMask che descrive 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 locations.patch con i campi updateMask impostati come in diffMask ottenuto in precedenza. Inoltre, abbina anche 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 della tua posizione è stata eseguita 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.