Atención: se ha lanzado la versión 4.7 de la API. Consulta el registro de cambios. Las cadenas aún pueden hacer publicaciones relacionadas con el COVID‑19.

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.

En la siguiente imagen se muestra un resumen del proceso de verificación:

Figura 1: Diagrama de flujo de la verificación de ubicaciones de Google My Business

Obtener el estado actual de verificación

Los usuarios pueden ejecutar accounts.locations.get en una ubicación para obtener su estado actual. Si el valor booleano location.LocationState.isVerified es true, la ubicación ya está verificada. De lo contrario, sigue los pasos que se indican en las secciones siguientes para verificar la ubicación.

Obtener las opciones de verificación

Los proveedores pueden utilizar la plataforma del método accounts.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://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
:fetchVerificationOptions

{
  "languageCode": "en"
}

Iniciar el proceso de verificación

Después de elegir un método de verificación, se usa accounts.locations.verify para iniciar 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://mybusiness.googleapis.com/v4/accounts/{accountId}/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 accounts.locations.verifications obtiene el estado de verificación actual y el historial de la ubicación especificada en la llamada.

Para obtener las verificaciones actuales, haz lo siguiente:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications

Completar una verificación pendiente

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

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

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}