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 el comercio a la UI de Perfil de Empresa.

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

Una vez que hayas elegido un método de verificación, inicia el proceso con locations.verify. 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"
}

Prácticas recomendadas para verificar el PEG con la API

Creación de ubicación

Con la API Business Information de PEG, puedes insertar tu plataforma para disponer de funciones de creación de ubicaciones. Cuando pidas a los comercios que añadan una nueva ubicación, sigue estos pasos:

Recoge información sobre la ubicación, como la razón social, la dirección y la categoría del comercio.

  1. Haz una llamada al endpoint googleLocations.search.
  2. Indica los datos de ubicación, como ella razón social, la categoría, la dirección, el número de teléfono y el sitio web de la empresa en la solicitud a la API.

También puedes hacer una búsqueda de posibles ubicaciones que concuerden con esos datos. Sigue estos pasos:

  1. Busca posibles ubicaciones que se ajusten a los datos que tienes.
  2. Pídele al comercio que elija la ubicación correcta.
  3. Si requestAdminRightsUrl figura en la respuesta sobre la ubicación, ayuda al comercio a solicitar el acceso y la propiedad de esa ubicación en Perfil de Empresa en Google.
  4. Si requestAdminRightsUrl no existe, crea una ubicación con el ID de sitio en la respuesta sobre la ubicación.
  5. Verifica la nueva ubicación.

Nota: Si no encuentras ninguna ubicación que concuerde con la consulta inicial, usa un ID de sitio en blanco para crear una ubicación. A continuación, verifica la nueva ubicación.

Verificación de ubicación

Para iniciar el proceso de verificación con la API de PEG, sigue estos pasos:

  1. Llama al método accounts.locations.list para obtener una lista de todas las ubicaciones de una cuenta de Google.
  2. Selecciona la ubicación que quieras verificar.
  3. Llama al método de API GetVoiceOfMerchant para confirmar si se debe verificar la ubicación.
  4. Si la respuesta indica que se debe verificar, llama a fetchVerificationOptions para obtener una lista de los métodos disponibles para verificar esa ubicación.
  5. Comprueba que los datos de verificationOption incluyen la dirección, el número de teléfono y la dirección de correo electrónico correctos.
  6. Cuando el comercio seleccione la opción de verificación más adecuada, llama al método locations.verify para iniciar la verificación correspondiente. Para confirmar que se ha iniciado, llama a locations.verifications.list.
  7. Llama al método locations.verification.complete con el PIN del comercio.
  8. Llama al método de API GetVoiceOfMerchant. Si HasVoiceOfMerchant = true, habrás verificado la ubicación correctamente.

Nota: Si la ubicación dispone de la verificación AUTO, el comercio no tendrá que hacer nada.

Para obtener más información sobre la verificación de PEG, consulta nuestro artículo de asistencia del Centro de Ayuda.

Guía de métodos de verificación para partners aprobados