Cómo administrar las actualizaciones de Google

Para que tu Perfil de Negocio sea lo más preciso posible, Google utiliza información de diversas fuentes, como informes de usuarios y contenido con licencia. Si se informa que la información proporcionada por los propietarios de empresas es incorrecta, Google notifica a los propietarios de la ficha. Luego, los propietarios de la ficha pueden aceptar o rechazar las actualizaciones.

Como propietario de la ficha, la API de My Business Business Information te permite revisar estas actualizaciones para asegurarte de que la información de tu empresa sea precisa. En esta guía, se describe cómo aceptar o rechazar actualizaciones.

Para administrar tus actualizaciones de Google, completa los siguientes pasos:

  1. Busca ubicaciones con actualizaciones pendientes.
  2. Revisa los campos actualizados.
  3. Acepta o rechaza las actualizaciones.
  4. Revisa los resultados.

Busca ubicaciones con actualizaciones pendientes

Antes de aceptar o rechazar actualizaciones, debes averiguar qué ubicaciones tienen actualizaciones de Google disponibles. La mejor manera de obtener actualizaciones de Google para las ubicaciones es administrar las notificaciones en tiempo real con Cloud Pub/Sub. Si recibes una GOOGLE_UPDATE notificación en tu tema de Pub/Sub, significa que hay un cambio listo para que lo revises. El campo locationName de la notificación proporciona el nombre del recurso de la ubicación con las actualizaciones de Google.

Como alternativa, puedes ver la llamada locations.get e inspeccionar el Metadata para verificar la presencia de la marca hasGoogleUpdated. Si "isGoogleUpdated": true, el ID de lugar asociado con esta ubicación tiene actualizaciones.

Solicitud

El siguiente es un locations.get ejemplo de solicitud:

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

Solicitud

El siguiente es un locations.get ejemplo de respuesta:

{
  "name": "locations/{locationId}",
  "title": "Test Business",
  "phoneNumbers": {
      "primaryPhone": "02 9374 4000"
   },
  ...
  "metadata": {
    "hasGoogleUpdated": true,
    ...
  }
  ...
}

Revisa los campos actualizados

Para revisar los campos específicos que tienen actualizaciones de Google, llama a locations.getGoogleUpdated.

Este método devuelve dos máscaras importantes en el cuerpo de la respuesta:

  • diffMask: Indica los campos en los que los datos de publicación (lo que los clientes ven en Google Maps y la Búsqueda) difieren de tus valores preferidos locales. Por lo general, esto se debe a las actualizaciones de Google o al contenido generado por el usuario. Debes aceptar o rechazar estos campos para resolver la discrepancia.
  • pendingMask: Indica los campos en los que enviaste una actualización anteriormente, pero esta aún se está procesando y no se publicó en Google Maps ni en la Búsqueda. No es necesario que realices ninguna acción en estos campos.

Solicitud

El siguiente es un locations.getGoogleUpdated ejemplo de solicitud:

HTTP
GET
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated

Respuesta

El siguiente es un ejemplo de respuesta locations.getGoogleUpdated. Muestra una actualización disponible en el campo phoneNumbers.primaryPhone. El valor en esta respuesta es el valor de actualización sugerido:

{
  "location": {
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
  },
  "diffMask": "phoneNumbers.primaryPhone"
}

Acepta o rechaza las actualizaciones

Para resolver los campos que se muestran en el diffMask, debes aceptar o rechazar las actualizaciones con una solicitud locations.patch:

  • Aceptar una actualización: Aplica un parche a la ubicación con el valor nuevo que se muestra en la respuesta getGoogleUpdated. Esto actualiza tu registro local para que coincida con los datos de publicación.
  • Rechazar una actualización: Aplica un parche a la ubicación con tu valor preferido original. Esto vuelve a confirmar tus datos preferidos a través de la canalización de actualización y reemplaza los datos de publicación.

En ambos casos, configura updateMask para que abarque los campos que deseas resolver.

Aceptar una solicitud

El siguiente es un ejemplo de solicitud locations.patch:

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
}

Respuesta

El siguiente es un locations.patch ejemplo de respuesta:

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "+1 111 111 1111"
     },
    ...
}

Rechazar una solicitud

El siguiente es un locations.patch ejemplo de solicitud:

HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone
{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

Respuesta

El siguiente es un locations.patch ejemplo de respuesta:

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

Revisa los resultados

Si la ubicación se actualiza correctamente, el campo diffMask de la locations.getGoogleUpdated respuesta muestra los valores como "diffMask": "". Además, la marca "hasGoogleUpdated" dentro de Metadata muestra el valor como false o no se muestra ningún valor.

Si los valores de los campos no son claros, comunícate con nuestro equipo de asistencia al cliente con la solicitud y la respuesta de getGoogleUpdated. La solicitud debe incluir la respuesta antes de la locations.patch llamada, la llamada de parche y la getGoogleUpdated llamada.