Las APIs Verifications y Business Information ya están disponibles. Es obligatorio llevar a cabo la migración. Consulta nuestro programa de desactivación para obtener más información sobre los puntos finales obsoletos. También puedes registrarte en nuestra lista de distribución para recibir las novedades.

Gestionar la verificación

Los proveedores que ofrezcan la posibilidad de gestionar fichas directamente en su plataforma pueden verificar la empresa de un comercio en su sitio web. Así, no es necesario redirigir al comercio a la interfaz de usuario de Google My Business.

Obtener el estado actual

Los usuarios pueden llamar a locations.getVoiceOfMerchantState en una ubicación para obtener su estado actual. Si el valor booleano hasVoiceOfMerchant es true, la ubicación ya está en regla y no es necesario hacer nada más. De lo contrario, si la acción gain_voice_of_merchant de la respuesta contiene verify, debes completar la verificación. Para obtener más información, sigue estas instrucciones:

Obtener las opciones de verificación

Los proveedores pueden utilizar el método locations.fetchVerificationOptions para pedir a los comercios que elijan la forma de contacto que quieren usar de una lista de métodos de verificación disponibles.

Para obtener las opciones de verificación, utiliza lo siguiente:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Iniciar el proceso de verificación

Después de elegir un método de verificación, se inicia locations.verify para empezar el proceso de verificación. Como resultado de esta llamada, la ubicación pasa a estar verificada o se devuelve un estado de error.

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

Obtener las verificaciones actuales

La llamada locations.verifications.list obtiene el historial de solicitudes de verificación y el estado de la ubicación especificada en la llamada.

Para obtener todas las solicitudes de verificación, utiliza lo siguiente:

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

Completar una verificación pendiente

Normalmente, se necesita un código PIN y el método locations.verifications.complete para completar la verificación de una empresa.

Para completar una verificación pendiente, utiliza lo siguiente:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}