Administra la verificación

Los proveedores que ofrecen administración de fichas directamente en su plataforma pueden verificar la empresa de un comercio en su sitio. Esto elimina la necesidad de redireccionar al comercio a la IU del Perfil de Negocio.

Obtén el estado actual

Los usuarios pueden llamar a locations.getVoiceOfMerchantState en una ubicación para recuperar su estado actual. Si el valor booleano hasVoiceOfMerchant es true, la ubicación ya está en regla y no se requiere ninguna acción adicional. De lo contrario, si la respuesta incluye un objeto verify, debes completar la verificación. Sigue las instrucciones de las próximas secciones para obtener más información.

Recupera las opciones de verificación

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

Para recuperar las opciones de verificación, usa lo siguiente:

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

{
  "languageCode": "en"
}

Inicia el proceso de verificación

Después de elegir un método de verificación, inicia el proceso de verificación con locations.verify. Como resultado de esta llamada, la ubicación pasa a un estado verificado o se muestra un estado de error.

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

// Use only one of the verification methods below

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

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

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

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

Recupera las verificaciones actuales

La llamada locations.verifications.list recupera el historial de solicitudes de verificación junto con su estado para la ubicación especificada en la llamada.

Para recuperar todas las solicitudes de verificación, usa lo siguiente:

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

Cómo completar una verificación pendiente

Por lo general, se requiere 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, usa lo siguiente:

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

{
  "pin": "123456"
}

Prácticas recomendadas para la verificación del Perfil de Negocio de Google con la API

Creación de ubicaciones

Con la API de Business Information del Perfil de Negocio de Google, puedes incorporar tu plataforma para proporcionar la funcionalidad de creación de ubicaciones. Cuando les pidas a los comercios que agreguen una ubicación nueva, asegúrate de seguir estos pasos:

Recopila información de ubicación, como el nombre, la dirección y la categoría de la empresa, del comercio.

  1. Llama al extremo googleLocations.search.
  2. Proporciona datos de ubicación, como el nombre, 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.

Como alternativa, sigue estos pasos para buscar una ubicación que coincida:

  1. Consultar posibles coincidencias de ubicación
  2. Pídele al comercio que elija la ubicación correcta.
  3. Si requestAdminRightsUri existe en el GoogleLocation coincidente, ayuda al comercio a solicitar acceso y propiedad para esa ubicación en el Perfil de Negocio de Google.
  4. Si no existe requestAdminRightsUri, llama a accounts.locations.create con los detalles de location del GoogleLocation coincidente.
  5. Verifica la ubicación nueva.

Nota: Si no obtienes ninguna coincidencia de ubicación posible con tu consulta inicial, llama a accounts.locations.create con los detalles de ubicación recopilados del comercio y, luego, verifica esa nueva ubicación.

Verificación de ubicaciones

Para iniciar el proceso de verificación con la API del Perfil de Negocio de Google, sigue estos pasos:

  1. Llama al método accounts.locations.list para enumerar todas las ubicaciones de una Cuenta de Google.
  2. Selecciona una ubicación para verificar.
  3. Llama al método de la API locations.getVoiceOfMerchantState para confirmar si esa ubicación requiere verificación.
  4. Si la respuesta contiene verify, llama a locations.fetchVerificationOptions para obtener una lista de los métodos disponibles para verificar esa ubicación.
  5. Verifica que los datos de VerificationOption incluyan la dirección, el número de teléfono y la dirección de correo electrónico correctos.
  6. Después de que el comercio seleccione la mejor opción de verificación disponible, llama al método locations.verify para iniciar la verificación adecuada. Para confirmar que la inicialización está en curso, llama a locations.verifications.list.
  7. Llama al método locations.verifications.complete con el PIN del comercio.
  8. Realiza una llamada al locations.getVoiceOfMerchantState del método de la API. Si hasVoiceOfMerchant es true, significa que verificaste la ubicación correctamente.

Nota: Si la verificación de AUTO está disponible para la ubicación, el comercio no necesita realizar ningún paso de verificación.

Para obtener más información sobre la verificación del Perfil de Negocio de Google, consulta nuestro artículo de ayuda del Centro de ayuda.