Method: locations.verify

Avvia la procedura di verifica per una sede.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
name

string

Obbligatorio. Nome della 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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  },
  "trustedPartnerToken": string
  // End of mutually exclusive fields.
}
Campi
method

enum (VerificationMethod)

Obbligatorio. Metodo di verifica.
languageCode

string

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

object (ServiceBusinessContext)

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 dell'INDIRIZZO, l'indirizzo verrà utilizzato per l'invio della cartolina. Per gli altri metodi, deve essere lo stesso passato a GetVerificationOptions. Se viene impostato per altri tipi di sedi dell'attività, verrà generato l'errore INVALID_ARGUMENT.
Dati di input dell'utente per un metodo specifico oltre ai dati di visualizzazione. I dati devono corrispondere al metodo richiesto. Lascia vuoto se non sono necessari dati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
emailAddress

string

Facoltativo. L'input per il metodo EMAIL. L'indirizzo email a cui deve essere inviato il PIN.

Un indirizzo email viene accettato solo se è uno degli indirizzi forniti da locations.fetchVerificationOptions. Se [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] ha isUserNameEditable impostato su true, il client può specificare un nome utente diverso (parte locale), ma deve corrispondere al nome di dominio.
mailerContact

string

Facoltativo. L'input per il metodo ADDRESS. Nome del contatto a cui deve essere inviata l'email.
phoneNumber

string

Facoltativo. L'input per il metodo PHONE_CALL/SMS. Il numero di telefono da chiamare o a cui inviare l'SMS. Deve essere uno dei numeri di telefono presenti nelle opzioni idonee.
token

object (VerificationToken)

Facoltativo. L'input per il metodo VETTED_PARTNER è disponibile per partner selezionati. L'input non è necessario per un account verificato. Token associato alla località. Token associato alla località.
trustedPartnerToken

string

L'input per il metodo TRUSTED_PARTNER Il token di verifica associato alla sede.
Fine dei campi che si escludono a vicenda.

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 saperne di più, consulta la OAuth 2.0 Overview.

VerificationToken

Token generato da un partner verificato.

Rappresentazione JSON 
{
  "tokenString": string
}
Campi
tokenString

string

La stringa del token.