Gestisci la verifica

I fornitori che offrono la gestione delle schede direttamente sulla loro piattaforma possono verificare l'attività di un commerciante all'interno del loro 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 il numero locations.getVoiceOfMerchantState in una località per recuperare il suo stato attuale. Se il hasVoiceOfMerchant booleano è true, la sede è 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"
}

Avviare la procedura di verifica

Dopo aver scelto un metodo di verifica, avvia la procedura 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"
  }
}

Recuperare le verifiche attuali

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 il seguente comando:

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

Completare una verifica in attesa

Per completare la verifica di un'attività, in genere 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 del profilo Google tramite API

Creazione della posizione

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 informazioni sulla posizione, come nome dell'attività, indirizzo e categoria, dal commerciante.

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

In alternativa, esegui una ricerca di una potenziale posizione corrispondente seguendo questi passaggi:

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

Nota:se la query iniziale non restituisce corrispondenze di località possibili, 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 Google Business Profile:

  1. Chiama il metodo accounts.locations.list per elencare tutte le sedi di un account Google.
  2. Seleziona una sede da verificare.
  3. Chiama il metodo API GetVoiceOfMerchant per verificare se la sede richiede la verifica.
  4. Se la risposta restituisce verify, call fetchVerificationOptions per ottenere un elenco dei metodi disponibili per verificare la posizione.
  5. Controlla che i dati di verificationOption includano indirizzo, numero di telefono e 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'inizializzazione è in corso, chiama il numero 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 correttamente la sede.

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

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