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:
- Trovare sedi con aggiornamenti in attesa
- Esaminare i campi aggiornati
- Accettare o rifiutare gli aggiornamenti
- 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
:
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
:
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
:
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
:
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
.