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 de acceso

Parámetros
name

string

Obligatorio. 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)
  },

  // 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.
}
Campos
method

enum (VerificationMethod)

Obligatorio. Método de verificación.
languageCode

string

Opcional. Es el código de idioma según la norma BCP 47 que representa el idioma que se utilizará en el proceso de verificación.
context

object (ServiceBusinessContext)

Opcional. Información de contexto adicional para la verificación de las empresas de servicios. Solo es obligatorio para las ubicaciones cuyo tipo de empresa es CUSTOMER_LOCATION_ONLY. Para la verificación de ADDRESS, la dirección se utilizará para enviar la tarjeta postal. Para los demás métodos, debe ser el mismo que se pasa a GetverificationOptions. Se mostrará INVALID_{8/} si se configura para otros tipos de ubicaciones de la empresa.
Campo de unión RequestData. Son los datos de entrada del usuario para el 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. Las direcciones (RequestData) solo pueden ser una de las siguientes opciones:
emailAddress

string

Opcional. Entrada del método EMAIL. 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 proporcionadas por locations.fetch VerificationOptions. Si el atributo [Email VerificationData] [google.mybusiness-verifications.v1.VerificationOption.Email VerificationData] tiene el valor isUserNameEditable configurado como verdadero, el cliente puede especificar otro nombre de usuario (parte local), pero deberá coincidir con el nombre de dominio.
mailerContact

string

Opcional. La entrada para el método ADDRESS Nombre del contacto al que se debe enviar el correo electrónico
phoneNumber

string

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

object (VerificationToken)

Opcional. Entrada del método VETTED_PARTNER disponible para seleccionar partners.. La entrada no es necesaria para una cuenta aprobada. El token asociado a la ubicación. El token asociado a la ubicación.

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 alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

VerificationToken

Token generado por un socio aprobado.

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

string

Es la string del token.