Cómo administrar las actualizaciones de Google

Para que tu Perfil de Negocio sea lo más preciso posible, Google utiliza información de 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 les notifica a los propietarios de las fichas. Luego, los propietarios de las fichas pueden aceptar o rechazar las actualizaciones.

Como propietario de una ficha, la API de Información de la empresa de Mi Negocio 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. Cómo encontrar ubicaciones con actualizaciones pendientes
  2. Revisa los campos actualizados
  3. Cómo aceptar o rechazar actualizaciones
  4. Revisa los resultados

Cómo encontrar 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 notificaciones en tiempo real con Cloud Pub/Sub. Si recibes una notificación de GOOGLE_UPDATE 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 Actualizaciones de Google.

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

Solicitud

El siguiente es un ejemplo de solicitud locations.get:

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

Solicitud

A continuación, se muestra un ejemplo de respuesta de locations.get:

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

Revisa los campos de actualizaciones

Para revisar los campos específicos que tienen Actualizaciones de Google, llama a locations.getGoogleUpdated. En el cuerpo de la respuesta, se incluye un diffMask que detalla los campos que Google actualizó.

Solicitud

El siguiente es un ejemplo de solicitud locations.getGoogleUpdated:

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

Respuesta

A continuación, se muestra un ejemplo de respuesta de locations.getGoogleUpdated. Muestra una actualización disponible en el campo phoneNumbers.primaryPhone. El valor de 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"
}

Cómo aceptar o rechazar actualizaciones

Para aceptar o rechazar una actualización, realiza una locations.patch con los campos updateMask configurados de la misma manera que en el diffMask que obtuviste antes. Además, haz coincidir los valores preferidos para cada campo.

Cómo 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

A continuación, se muestra un ejemplo de respuesta de locations.patch:

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

Cómo rechazar una solicitud

El siguiente es un ejemplo de solicitud de locations.patch:

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

Respuesta

A continuación, se muestra un ejemplo de respuesta de locations.patch:

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

Revisa los resultados

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

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 llamada a locations.patch, la llamada de parche y la llamada a getGoogleUpdated.