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 è necessario reindirizzare il commerciante alla UI di Profilo dell'attività.

Ottieni lo stato attuale

Gli utenti possono chiamare locations.getVoiceOfMerchantState su una località per recuperare lo stato attuale. Se il valore booleano hasVoiceOfMerchant è true, la località è già in regola e non sono necessarie ulteriori azioni. In caso contrario, se la risposta include un oggetto verify, devi completare la verifica. Per saperne di più, segui le istruzioni riportate nelle sezioni successive.

Recupera le opzioni di verifica

I fornitori possono utilizzare il metodo locations.fetchVerificationOptions per chiedere ai commercianti di scegliere un recapito 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/locations/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Avviare la procedura di verifica

Dopo aver scelto un metodo di verifica, avvia la procedura di verifica con locations.verify. In seguito a 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 verification methods below

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "mailerContact": "Ann Droyd"
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneNumber": "800-555-0136"
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneNumber": "800-555-0136"
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailAddress": "ex@google.com"
}

Recupera le verifiche correnti

La chiamata locations.verifications.list 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

Completa 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 di Profilo dell'attività su Google tramite API

Creazione della località

Con l'API Business Information di Profilo dell'attività, puoi incorporare la tua piattaforma per fornire funzionalità di creazione delle sedi. Quando chiedi ai commercianti di aggiungere una nuova sede, assicurati di seguire questi passaggi:

Raccogliere dal commerciante i dati sulla posizione, 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à, nella richiesta API.

In alternativa, esegui una ricerca di potenziali località corrispondenti seguendo questi passaggi:

  1. Esegui query sulle possibili corrispondenze di località.
  2. Chiedi al commerciante di scegliere la sede corretta.
  3. Se requestAdminRightsUri esiste nel GoogleLocation corrispondente, aiuta il commerciante a richiedere l'accesso e la proprietà di quella sede su Profilo dell'attività su Google.
  4. Se requestAdminRightsUri non esiste, chiama accounts.locations.create utilizzando i dettagli di location di GoogleLocation corrispondente.
  5. Verifica la nuova posizione.

Nota: se non ricevi corrispondenze di località possibili dalla query iniziale, chiama accounts.locations.create con i dettagli della località raccolti dal commerciante, quindi verifica la nuova località.

Verifica posizioni

Per avviare la procedura di verifica utilizzando l'API GBP, segui questi passaggi:

  1. Chiama il metodo accounts.locations.list per elencare tutte le località di un Account Google.
  2. Seleziona una sede da verificare.
  3. Chiama il metodo API locations.getVoiceOfMerchantState per verificare se la località richiede la verifica.
  4. Se la risposta contiene verify, chiama locations.fetchVerificationOptions per ottenere un elenco dei 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 commerciante ha selezionato l'opzione di verifica migliore tra quelle disponibili, chiama il metodo locations.verify per avviare la verifica appropriata. Per confermare che l'inizializzazione è in corso, chiama locations.verifications.list.
  7. Chiama il metodo locations.verifications.complete con il PIN del commerciante.
  8. Chiama il metodo API locations.getVoiceOfMerchantState. Se hasVoiceOfMerchant è true, hai verificato la località.

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

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