I fornitori che offrono la gestione delle schede direttamente sulla propria piattaforma possono verificare la proprietà attività all'interno del sito. In questo modo non sarà più necessario reindirizzare il commerciante UI di Profilo dell'attività.
Recupera stato attuale
Gli utenti possono chiamare locations.getVoiceOfMerchantState
in una posizione per recuperarne lo stato attuale. Se
hasVoiceOfMerchant
Il valore booleano è true
, significa che la località è già in regola e non è richiesta alcuna azione aggiuntiva. In caso contrario, se l'azione gain_voice_of_merchant
nella risposta contiene verify
, devi completare la verifica. Per saperne di più, segui le istruzioni riportate di seguito.
Opzioni di verifica del recupero
I provider possono utilizzare
locations.fetchVerificationOptions
per richiedere ai commercianti di scegliere un metodo di contatto preferito da un elenco di disponibili
metodi di verifica.
Per recuperare le opzioni di verifica, utilizza quanto segue:
POST https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions { "languageCode": "en" }
Avvia la procedura di verifica.
Dopo aver scelto un metodo di verifica, avvia la procedura di verifica con
locations.verify
A seguito di questa chiamata, la sede passa a uno stato verificato 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 in corso
La
locations.verifications.list
call recupera la cronologia delle richieste di verifica insieme al relativo stato per la località 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
Il codice PIN
locations.verifications.complete
è generalmente richiesto per completare la verifica di un'attività.
Per completare una verifica in attesa, utilizza quanto segue:
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications/{verificationId}:complete { "pin": "123456" }
Best practice per la verifica di Profilo dell'attività tramite API
Creazione località
Con l'API GBP Business Information, puoi incorporare la tua piattaforma per fornire funzionalità di creazione della sede. Quando chiedi ai commercianti di aggiungere una nuova sede, assicurati di seguire questa procedura:
Raccogliere dal commerciante informazioni sulla sede, ad esempio nome, indirizzo e categoria dell'attività.
- Chiama l'endpoint
googleLocations.search
. - Fornisci dati sulla posizione, come nome dell'attività, categoria, indirizzo, numero di telefono e sito web, nella richiesta API.
In alternativa, cerca una potenziale località corrispondente procedendo nel seguente modo:
- Esegui query su possibili corrispondenze di località.
- Chiedi al commerciante di scegliere la località corretta.
- Se nella risposta alla località è presente
requestAdminRightsUrl
, aiuta il commerciante a richiedere l'accesso e la proprietà della sede in Profilo dell'attività su Google. - Se
requestAdminRightsUrl
non esiste, crea una nuova posizione con l'ID luogo nella risposta della località. - Verifica la nuova sede.
Nota: se nella query iniziale non ottieni possibili corrispondenze di località, utilizza un ID luogo vuoto per creare una nuova sede. Poi, verifica la nuova sede.
Verifica posizioni
Per avviare la procedura di verifica utilizzando l'API Profilo dell'attività, segui questi passaggi:
- Chiama il metodo
accounts.locations.list
per elencare tutte le sedi per un Account Google. - Seleziona una sede da verificare.
- Chiama il metodo API
GetVoiceOfMerchant
per confermare se la località richiede la verifica. - Se la risposta restituisce "verifica", chiama
fetchVerificationOptions
per visualizzare un elenco di metodi disponibili per verificare la località. - Verifica che i dati di
verificationOption
includano l'indirizzo, il numero di telefono e l'indirizzo email corretti. - Dopo che il meccanico ha selezionato la migliore opzione di verifica 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 la verifica AUTO
è disponibile per la sede, il commerciante non deve eseguire alcuna procedura di verifica.
Per saperne di più sulla verifica tramite Profilo dell'attività, fai riferimento al nostro articolo del Centro assistenza.