Administrar actualizaciones de Google

Para que tu perfil de negocio sea lo más preciso posible, Google usa información de fuentes como informes de usuarios y contenido con licencia. Si se denuncia que la información que proporcionan los propietarios de empresas es incorrecta, Google lo notifica a los propietarios de las fichas. Luego, los propietarios de fichas pueden aceptar o rechazar las actualizaciones.

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

Para administrar las Actualizaciones de Google, sigue estos pasos:

  1. Cómo buscar ubicaciones con actualizaciones pendientes
  2. Revisa los campos actualizados
  3. Acepta o rechaza actualizaciones
  4. Revisa los resultados

Cómo buscar ubicaciones con actualizaciones pendientes

Antes de aceptar o rechazar las actualizaciones, debes averiguar qué ubicaciones tienen Actualizaciones de Google disponibles. La mejor manera de obtener Actualizaciones de Google para 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 e inspeccionar el Metadata para detectar la presencia de la marca hasGoogleUpdated. Si es "isGoogleUpdated": true, el ID de lugar asociado con 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,
    ...
  }
  ...
}

Revisa los campos de actualizaciones

Para revisar los campos específicos que tienen las Actualizaciones de Google, llama a locations.getGoogleUpdated. Un diffMask que detalla los campos que Google actualizó se encuentra en el cuerpo de la respuesta.

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 una 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"
}

Aceptar o rechazar actualizaciones

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

Cómo 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"
     },
    ...
}

Cómo 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"
     },
    ...
}

Revisa los resultados

Si tu ubicación recibió el parche de forma correcta, el campo diffMask en la respuesta locations.getGoogleUpdated muestra los valores como "diffMask": "". Además, la marca "hasGoogleUpdated" en Metadata muestra el valor como false, si no hay ningún valor presente.

Si los valores de los campos no son claros, comunícate con nuestro equipo de asistencia al cliente para enviar 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.