Los proveedores que ofrecen la administración de fichas directamente en su plataforma pueden verificar la empresa del comercio en su sitio. De esta manera, se 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 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
Los proveedores pueden usar el método locations.fetchVerificationOptions
para solicitar 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:
POST https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions { "languageCode": "en" }
Inicia el proceso de verificación
Tras 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.
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" } }
Recuperar las verificaciones actuales
La llamada a 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:
GET https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications
Cómo completar una verificación pendiente
Por lo general, se requieren 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:
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications/{verificationId}:complete { "pin": "123456" }
Prácticas recomendadas para la verificación de GBP a través de la API
Creación de la ubicación
Con la API de Business Information de GBP, pueden incorporar su plataforma para brindar la 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, como el nombre de la empresa, la dirección y la categoría del comercio.
- Llama al extremo
googleLocations.search
. - 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, en la solicitud a la API.
Como alternativa, sigue estos pasos para buscar una posible ubicación coincidente:
- Busca posibles coincidencias de ubicación.
- Pídanle al comercio que elija la ubicación correcta.
- Si
requestAdminRightsUrl
existe en la respuesta de ubicación, ayuda al comercio a solicitar el acceso y la propiedad de esa ubicación en el Perfil de Negocio de Google. - Si
requestAdminRightsUrl
no existe, crea una ubicación nueva con el ID de lugar en la respuesta de ubicación. - Verifica la ubicación nueva.
Nota: Si no obtienes ninguna coincidencia de ubicación posible en tu consulta inicial, utiliza un ID de lugar en blanco para crear una ubicación nueva. Luego, verifica esa ubicación nueva.
Verificación de la ubicación
Para iniciar el proceso de verificación mediante la API de PNG, sigue estos pasos:
- Llama al método
accounts.locations.list
para indicar todas las ubicaciones de una Cuenta de Google. - Selecciona una ubicación para verificarla.
- Llama al método de la API
GetVoiceOfMerchant
para confirmar si esa ubicación requiere verificación. - Si se muestra la verificación en la respuesta, llama a
fetchVerificationOptions
a fin de obtener una lista de métodos disponibles para verificar esa ubicación. - 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. - Después de 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 la iniciación está en curso, llama allocations.verifications.list.
. - Llama al método
locations.verification.complete
con el PIN del comercio. - Llama al método de la API
GetVoiceOfMerchant
. SiHasVoiceOfMerchant = true
, verificaste la ubicación correctamente.
Nota: Si la verificación 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 de GBP, consulta nuestro artículo de asistencia del Centro de ayuda.