Gestisci la verifica

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:

HTTP
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.

HTTP
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:

HTTP
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:

HTTP
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à.

  1. Chiama l'endpoint googleLocations.search.
  2. 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:

  1. Esegui query su possibili corrispondenze di località.
  2. Chiedi al commerciante di scegliere la località corretta.
  3. 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.
  4. Se requestAdminRightsUrl non esiste, crea una nuova posizione con l'ID luogo nella risposta della località.
  5. 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:

  1. Chiama il metodo accounts.locations.list per elencare tutte le sedi per un Account Google.
  2. Seleziona una sede da verificare.
  3. Chiama il metodo API GetVoiceOfMerchant per confermare se la località richiede la verifica.
  4. Se la risposta restituisce "verifica", chiama fetchVerificationOptions per visualizzare un elenco di metodi disponibili per verificare la località.
  5. Verifica che i dati di verificationOption includano l'indirizzo, il numero di telefono e l'indirizzo email corretti.
  6. 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 il locations.verifications.list.
  7. Chiama il metodo locations.verification.complete con il PIN del commerciante.
  8. Chiama il metodo API GetVoiceOfMerchant. Se HasVoiceOfMerchant = 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.

Guida ai metodi di verifica per partner certificati