Gestisci la verifica

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:

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

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

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

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

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

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

  1. Chiama il metodo accounts.locations.list per indicare tutte le sedi associate a un Account Google.
  2. Seleziona una sede da verificare.
  3. Chiama il metodo API GetVoiceOfMerchant per confermare se quella località richiede la verifica.
  4. Se la risposta restituisce "Verifica", chiama fetchVerificationOptions per visualizzare un elenco dei metodi disponibili per verificare la sede.
  5. Controlla che i dati di verificationOption includano l'indirizzo, il numero di telefono e l'indirizzo email corretti.
  6. 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 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 è 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.

Guida ai metodi di verifica per i partner approvati