Gestisci la verifica

I fornitori che offrono la gestione delle schede direttamente sulla propria piattaforma possono verificare l'attività di un commerciante all'interno del proprio sito. In questo modo non è più necessario reindirizzare il commerciante all'interfaccia utente di Profilo dell'attività.

Recupera lo stato attuale

Gli utenti possono chiamare locations.getVoiceOfMerchantState per una stazione di ricarica per recuperare lo stato corrente. Se il valore booleano hasVoiceOfMerchant è true, la stazione di ricarica è già in regola e non sono necessarie ulteriori azioni. 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.

Recupera le opzioni di verifica

I fornitori possono utilizzare il metodo locations.fetchVerificationOptions per chiedere ai commercianti di scegliere un metodo di contatto preferito da un elenco di metodi di verifica disponibili.

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 stazione di ricarica 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"
  }
}

Recuperare le verifiche correnti

La chiamata locations.verifications.list recupera la cronologia delle richieste di verifica e il 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

In genere, per completare la verifica di un'attività sono necessari un codice PIN e il metodo locations.verifications.complete.

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 GBP tramite API

Creazione di località

Con l'API Business Information di GBP, 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 località, come nome, indirizzo e categoria dell'attività.

  1. Chiama l'endpoint googleLocations.search.
  2. Fornisci i dati sulla posizione, come nome, categoria, indirizzo, numero di telefono e sito web dell'attività all'interno della richiesta dell'API.

In alternativa, puoi eseguire una ricerca per una potenziale posizione corrispondente seguendo questi passaggi:

  1. Esegui query sulle possibili corrispondenze della località.
  2. Chiedi al commerciante di scegliere la sede corretta.
  3. Se requestAdminRightsUrl esiste nella risposta della località, aiuta il commerciante a richiedere l'accesso e la proprietà per quella località su Profilo dell'attività su Google.
  4. Se requestAdminRightsUrl non esiste, crea una nuova stazione di ricarica con l'ID luogo nella risposta della stazione di ricarica.
  5. Verifica la nuova posizione.

Nota:se non ricevi possibili corrispondenze di località dalla query iniziale, utilizza un ID luogo vuoto per creare una nuova località. Poi, verifica la nuova posizione.

Verifica posizioni

Per avviare la procedura di verifica utilizzando l'API GBP:

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

Nota:se la verifica AUTO è disponibile per la località, il commerciante non deve eseguire alcun passaggio di verifica

Per ulteriori informazioni sulla verifica di Profilo dell'attività, consulta il nostro articolo del Centro assistenza.

Guida ai metodi di verifica per i partner selezionati