Administrar verificación

Los proveedores que ofrecen la administración de fichas directamente en su plataforma pueden verificar la propiedad de un comercio. empresa dentro de 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 botón hasVoiceOfMerchant booleano es true, la ubicación ya está en regla y no se requiere ninguna acción adicional. De lo contrario, si la acción gain_voice_of_merchant en la respuesta contiene verify, debes completar la verificación. Para obtener más información, sigue las instrucciones que aparecen a continuación.

Opciones de verificación de la recuperación de datos

Los proveedores pueden usar el locations.fetchVerificationOptions para solicitar a los comercios que elijan un método de contacto preferido de una lista de métodos de verificación.

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

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

{
  "languageCode": "en"
}

Inicia el proceso de verificación

Tras elegir un método de verificación, inicie 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 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"
  }
}

Recupera las verificaciones actuales

El locations.verifications.list call 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, utiliza lo siguiente:

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

Completa una verificación pendiente

Un código PIN y el locations.verifications.complete se suele requerir 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 PNG con la API

Creación de ubicaciones

Con la API de información comercial del PNG, puedes incorporar tu plataforma para proporcionar funcionalidad de creación de ubicaciones. Cuando solicites a los comercios que agreguen una nueva ubicación, asegúrate de seguir estos pasos:

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

  1. Llama al extremo googleLocations.search.
  2. Proporciona datos de ubicación, como el nombre de la empresa, la categoría, la dirección, el número de teléfono y el sitio web, dentro de la solicitud a la API.

También puedes realizar una búsqueda de una posible ubicación coincidente siguiendo estos pasos:

  1. Consulta posibles coincidencias de ubicación.
  2. Pídele al comercio que elija la ubicación correcta.
  3. Si la respuesta a la ubicación incluye requestAdminRightsUrl, ayuda al comercio a solicitar el acceso y la propiedad de esa ubicación en el Perfil de Negocio de Google.
  4. Si requestAdminRightsUrl no existe, crea una ubicación nueva con el ID de lugar en la respuesta de ubicación.
  5. Verifica la nueva ubicación.

Nota: Si no obtienes ninguna coincidencia de ubicación posible en tu búsqueda inicial, usa un ID de lugar en blanco para crear una ubicación nueva. Luego, verifica esa nueva ubicación.

Verificación de la ubicación

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

  1. Llama al método accounts.locations.list para que se muestren todas las ubicaciones de una Cuenta de Google.
  2. Selecciona una ubicación para verificar.
  3. Llama al método de la API GetVoiceOfMerchant para confirmar si esa ubicación requiere verificación.
  4. Si la respuesta muestra la opción de verificación, llama a fetchVerificationOptions para obtener una lista de los métodos disponibles y verificar esa ubicación.
  5. Vuelve a verificar 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. Una vez que el mecanismo seleccione la mejor opción de verificación disponible, llama al método locations.verify para iniciar la verificación correspondiente. Para confirmar que el inicio está en curso, llama a locations.verifications.list..
  7. Llama al método locations.verification.complete con el PIN del comercio.
  8. Llama al método de la API GetVoiceOfMerchant. Si es HasVoiceOfMerchant = true, significa que verificaste correctamente la ubicación.

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 PNG, consulta el artículo de asistencia del Centro de ayuda.

Guía sobre los métodos de verificación para socios aprobados