I fornitori che offrono la gestione delle schede direttamente sulla loro piattaforma possono verificare l'attività di un commerciante sul loro sito. In questo modo non sarà necessario reindirizzare il commerciante all'interfaccia utente di Profilo dell'attività.
Ottieni stato attuale
Gli utenti possono chiamare locations.getVoiceOfMerchantState
in una località per recuperarne lo stato attuale. Se
l'operatore booleano
hasVoiceOfMerchant
è true
, la località è già in regola e non sono richieste altre azioni da parte tua. In caso contrario, se l'azione gain_voice_of_merchant
nella risposta contiene verify
, devi completare la verifica. Per ulteriori informazioni, segui le istruzioni riportate di seguito.
Opzioni di verifica per il recupero
I fornitori possono utilizzare il metodo locations.fetchVerificationOptions
per richiedere ai commercianti di scegliere il metodo di contatto preferito da un elenco di metodi di verifica disponibili.
Per recuperare le opzioni di verifica, usa quanto segue:
POST https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions { "languageCode": "en" }
Avviare la procedura di verifica
Dopo aver scelto un metodo di verifica, avvia la procedura di verifica con
locations.verify
.
Come risultato di questa chiamata, la sede passa a uno stato di verifica o viene restituito uno stato di errore.
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} :verify // Use only one of the below verification methods // For postcard verification: { "method": "ADDRESS", "languageCode": "en", "addressInput": { "mailerContactName": "Ann Droyd" } } // For phone verification: { "method": "PHONE_CALL", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For SMS verification: { "method": "SMS", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For email verification: { "method": "EMAIL", "languageCode": "en", "emailInput": { "emailAddress": "ex@google.com" } }
Recupera le verifiche attuali
La chiamata
locations.verifications.list
recupera la cronologia delle richieste di verifica e il relativo stato della sede specificata nella chiamata.
Per recuperare tutte le richieste di verifica, utilizza quanto segue:
GET https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications
Completare una verifica in attesa
Per completare la verifica di un'attività sono in genere necessari un codice PIN e il metodo
locations.verifications.complete
.
Per completare una verifica in attesa, usa quanto segue:
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications/{verificationId}:complete { "pin": "123456" }
Best practice per la verifica Profilo dell'attività su Google mediante l'API
Creazione della sede
Con l'API GBP Business Information, puoi incorporare la tua piattaforma per fornire la funzionalità di creazione delle sedi. Quando chiedi ai commercianti di aggiungere una nuova sede, assicurati di seguire questi passaggi:
Raccogliere dal commerciante informazioni sulla sede, ad esempio nome, indirizzo e categoria dell'attività.
- Chiama l'endpoint
googleLocations.search
. - Fornisci dati sulla posizione, ad esempio nome dell'attività, categoria, indirizzo, numero di telefono e sito web, all'interno della richiesta API.
In alternativa, esegui una ricerca della potenziale località corrispondente procedendo nel seguente modo:
- Possibili corrispondenze di località della query.
- Chiedi al commerciante di scegliere la località corretta.
- Se
requestAdminRightsUrl
è presente nella risposta alla località, aiuta il commerciante a richiedere l'accesso e la proprietà per la sede in questione su Profilo dell'attività su Google. - Se
requestAdminRightsUrl
non esiste, crea una nuova sede con l'ID luogo nella risposta relativa alla località. - Verifica la nuova posizione.
Nota: se non ottieni possibili corrispondenze di località dalla query iniziale, utilizza un ID luogo vuoto per creare una nuova sede. Poi, verifica la nuova sede.
Verifica della località
Per avviare la procedura di verifica utilizzando l'API GBP, procedi nel seguente modo:
- Chiama il metodo
accounts.locations.list
per indicare tutte le sedi associate a un Account Google. - Seleziona una sede da verificare.
- Chiama il metodo API
GetVoiceOfMerchant
per confermare se quella località richiede la verifica. - Se la risposta restituisce "Verifica", chiama
fetchVerificationOptions
per visualizzare un elenco dei metodi disponibili per verificare la sede. - Controlla che i dati di
verificationOption
includano l'indirizzo, il numero di telefono e l'indirizzo email corretti. - Dopo che il meccanico ha selezionato l'opzione di verifica migliore disponibile, chiama il metodo
locations.verify
per avviare la verifica appropriata. Per confermare che l'avvio è in corso, chiama illocations.verifications.list.
- Chiama il metodo
locations.verification.complete
con il PIN del commerciante. - Chiama il metodo API
GetVoiceOfMerchant
. SeHasVoiceOfMerchant = true
, hai verificato la sede.
Nota: se è disponibile la verifica di AUTO
per la sede, il commerciante non deve eseguire alcuna procedura di verifica.
Per ulteriori informazioni sulla verifica di Profilo dell'attività su Google, consulta questo articolo del Centro assistenza.