Gestionar las actualizaciones de Google

Para que tu perfil de empresa sea lo más preciso posible, Google usa información de distintas fuentes, como informes de los usuarios y contenido con licencia. Si la información proporcionada por los propietarios de una empresa se marca como incorrecta, Google avisa a los propietarios de la ficha. Los propietarios de la ficha pueden aceptar o rechazar los cambios sugeridos.

La API Business Information de My Business permite que los propietarios de una ficha revisen los cambios sugeridos para asegurarse de que la información de su empresa sea correcta. En esta guía se describe cómo aceptar o rechazar los cambios.

Para gestionar las actualizaciones de Google, sigue estos pasos:

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

Buscar ubicaciones con actualizaciones pendientes

Para poder aceptar o rechazar actualizaciones de Google, hace falta encontrar las ubicaciones para las que se han sugerido cambios. La mejor forma de recibir actualizaciones de Google para ubicaciones es Gestionar las notificaciones en tiempo real con Cloud Pub/Sub. Si recibes una notificación GOOGLE_UPDATE en tu tema Pub/Sub, quiere decir que hay un cambio listo para que lo revises. El valor del campo locationName de la notificación corresponde al nombre del recurso de la ubicación con actualizaciones de Google.

También puedes ver la llamada locations.get y revisar Metadata para comprobar si hay una marca hasGoogleUpdated. Si "isGoogleUpdated": true, el ID de sitio asociado a esta ubicación tiene actualizaciones.

Solicitud

A continuación se muestra 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 locations.get:

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

Ver los campos con actualizaciones

Para ver los campos específicos que tienen actualizaciones de Google, haz una llamada a locations.getGoogleUpdated. En el cuerpo de la respuesta hay un campo diffMask que detalla los campos que Google ha actualizado.

Solicitud

A continuación se muestra 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 locations.getGoogleUpdated. En el campo phoneNumbers.primaryPhone, hay una actualización disponible. El valor que se indica en esa respuesta es la actualización sugerida:

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

Aceptar o rechazar actualizaciones

Para aceptar o rechazar una actualización, haz una llamada a locations.patch en la que asignes a los campos updateMask los valores de diffMask que obtuviste anteriormente, y haz que los valores preferidos de cada campo coincidan.

Aceptar una solicitud

A continuación se muestra 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 locations.patch:

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

Rechazar una solicitud

A continuación se muestra un ejemplo de solicitud 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 locations.patch:

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

Consultar los resultados

Si el parche se ha aplicado correctamente en tu ubicación, el valor del campo diffMask de la respuesta locations.getGoogleUpdated será "diffMask": "". Además, en Metadata, el valor de la marca "hasGoogleUpdated" será false, o no habrá ningún valor.

Si no tienes claros los valores de los campos, ponte en contacto con nuestro equipo de asistencia para indicarles la solicitud a getGoogleUpdated y la respuesta obtenida. La solicitud debe incluir la respuesta que obtuviste antes de haber hecho las llamadas a locations.patch, al parche y a getGoogleUpdated.