Method: locations.verify

Inicia el proceso de verificación de una ubicación.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. Es el nombre del recurso de la ubicación que se verificará.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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.
}
Campos
method

enum (VerificationMethod)

Obligatorio. Método de verificación.
languageCode

string

Opcional. Es el código de idioma BCP 47 que representa el idioma que se usará para el proceso de verificación.
context

object (ServiceBusinessContext)

Opcional. Información de contexto adicional para la verificación de empresas de servicios. Solo es obligatorio para las ubicaciones cuyo tipo de empresa es CUSTOMER_LOCATION_ONLY. Para la verificación de la DIRECCIÓN, esta se usará para enviar la postal. Para otros métodos, debe ser el mismo que se pasa a GetVerificationOptions. Se arrojará INVALID_ARGUMENT si se establece para otros tipos de ubicaciones de la empresa.
Son los datos de entrada del usuario para un método específico, además de los datos de visualización. Los datos deben coincidir con el método solicitado. Déjalo vacío si no se necesitan datos. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
emailAddress

string

Opcional. Es la entrada para el método EMAIL. La dirección de correo electrónico a la que se debe enviar el PIN

Solo se acepta una dirección de correo electrónico si es una de las direcciones que proporciona locations.fetchVerificationOptions. Si [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] tiene isUserNameEditable establecido como verdadero, el cliente puede especificar un nombre de usuario diferente (parte local), pero debe coincidir con el nombre de dominio.
mailerContact

string

Opcional. Es la entrada para el método ADDRESS. Es el nombre del contacto al que se debe enviar el correo.
phoneNumber

string

Opcional. Es la entrada para el método PHONE_CALL/SMS. Es el número de teléfono al que se debe llamar o al que se debe enviar un SMS. Debe ser uno de los números de teléfono de las opciones aptas.
token

object (VerificationToken)

Opcional. La entrada para el método VETTED_PARTNER está disponible para los socios seleccionados. No se necesita la entrada para una cuenta verificada. Es el token asociado a la ubicación. Es el token asociado a la ubicación.
trustedPartnerToken

string

Es la entrada para el método TRUSTED_PARTNER. Es el token de verificación que está asociado a la ubicación.
Fin de los campos mutuamente excluyentes.

Cuerpo de la respuesta

Mensaje de respuesta para Verifications.VerifyLocation.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "verification": {
    object (Verification)
  }
}
Campos
verification

object (Verification)

Es la solicitud de verificación creada.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

VerificationToken

Token generado por un socio verificado.

Representación JSON 
{
  "tokenString": string
}
Campos
tokenString

string

Es la cadena del token.