Method: accounts.locations.verify

Avvia la procedura di verifica di una stazione di ricarica.

Richiesta HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Nome della risorsa della stazione di ricarica 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:
  "emailInput": {
    object (EmailInput)
  },
  "addressInput": {
    object (AddressInput)
  },
  "phoneInput": {
    object (PhoneInput)
  }
  // End of list of possible types for union field RequestData.
}
Campi
method

enum (VerificationMethod)

Metodo di verifica.

languageCode

string

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

context

object (ServiceBusinessContext)

Informazioni aggiuntive sul contesto per la verifica delle attività di servizi. Obbligatorio per le sedi il cui tipo di attività è CUSTOMER_LOCATION_ONLY. Per la verifica INDIRIZZO, l'indirizzo verrà utilizzato per l'invio della cartolina. Per gli altri metodi, deve essere uguale a quello trasmesso a locations.fetchVerificationOptions. Verrà generato un errore INVALID_ARGUMENT se questo valore è impostato per altri tipi di sedi dell'attività.

Campo unione RequestData. Dati inseriti dall'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:
emailInput

object (EmailInput)

L'input per il metodo EMAIL.

addressInput

object (AddressInput)

L'input per il metodo ADDRESS.

phoneInput

object (PhoneInput)

L'input per il metodo PHONE_CALL/SMS

Corpo della risposta

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

Messaggio di risposta per Verifications.VerifyLocation.

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

object (Verification)

La richiesta di verifica creata.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

EmailInput

Input per la verifica EMAIL.

Rappresentazione JSON
{
  "emailAddress": string
}
Campi
emailAddress

string

Indirizzo email a cui deve essere inviato il PIN.

Un indirizzo email viene accettato solo se è uno degli indirizzi forniti da locations.fetchVerificationOptions. Se per EmailVerificationData è impostato su true il valore isUserNameEditable, il client può specificare un nome utente diverso (parte locale), ma deve corrispondere al nome di dominio.

AddressInput

Input per la verifica di ADDRESS.

Rappresentazione JSON
{
  "mailerContactName": string
}
Campi
mailerContactName

string

Nome del contatto a cui deve essere inviata la posta.

PhoneInput

Ingresso per la verifica tramite PHONE_CALL/SMS.

Rappresentazione JSON
{
  "phoneNumber": string
}
Campi
phoneNumber

string

Il numero di telefono a cui deve essere effettuata la chiamata o a cui devono essere inviati gli SMS. Deve essere uno dei numeri di telefono presenti nelle opzioni idonee.