Method: locations.verify

Avvia la procedura di verifica di una sede.

Richiesta HTTP

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Nome risorsa della località da verificare.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // Union field RequestData can be only one of the following:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
Campi
method

enum (VerificationMethod)

Obbligatorio. Metodo di verifica.
languageCode

string

Campo facoltativo. Il codice lingua BCP 47 che rappresenta la lingua da utilizzare per la procedura di verifica.
context

object (ServiceBusinessContext)

Campo facoltativo. Informazioni aggiuntive sul contesto per la verifica delle attività di servizi. È obbligatorio solo per le sedi il cui tipo di attività è CUSTOMER_LOCATION_only. Per la verifica di ADDRESS, l'indirizzo verrà utilizzato per l'invio della cartolina. Per gli altri metodi, deve essere uguale a quello trasmesso a GetVerificaOptions. Se impostato per altri tipi di sedi di attività commerciali, viene visualizzato il valore INVALID_gna.
Campo di unione RequestData. Dati di input dell'utente per un metodo specifico oltre ai dati di visualizzazione. I dati devono corrispondere al metodo richiesto. Lascia vuoto il campo se non sono necessari dati. RequestData può essere solo uno dei seguenti:
emailAddress

string

Campo facoltativo. Input per il metodo EMAIL. Indirizzo email a cui inviare il PIN.

Un indirizzo email è accettato solo se è uno degli indirizzi forniti da locations.fetch VerificationOptions. Se l'elemento isUserNameEditable di [EmailVerificaData] [google.mybusiness-verifications.v1.VerificaOption.EmailVerificaData] è impostato su true, il cliente può specificare un nome utente diverso (parte locale), ma deve corrispondere al nome di dominio.
mailerContact

string

Campo facoltativo. Input per il metodo ADDRESS. Nome di contatto a cui deve essere inviata la posta.
phoneNumber

string

Campo facoltativo. Input per il metodo PHONE_CALL/SMS Il numero di telefono da chiamare o a cui inviare un SMS. Deve essere uno dei numeri di telefono presenti nelle opzioni idonee.
token

object (VerificationToken)

Campo facoltativo. Input per il metodo VETTED_PARTNER disponibile per selezionare i partners.. Questo input non è necessario per un account verificato. Token associato alla località. Token associato alla località.

Corpo della risposta

Messaggio di risposta per Verifications.VerifyLocation.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "verification": {
    object (Verification)
  }
}
Campi
verification

object (Verification)

La richiesta di verifica creata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

VerificationToken

Token generato da un partner verificato.

Rappresentazione JSON 
{
  "tokenString": string
}
Campi
tokenString

string

La stringa token.