Управление обновлениями Google

Чтобы обеспечить максимальную точность вашего бизнес-профиля, Google использует информацию из таких источников, как отчеты пользователей и лицензионный контент. Если информация, предоставленная владельцами бизнеса, окажется неверной, Google уведомит об этом владельцев листинга. Владельцы объявлений могут затем принять или отклонить обновления.

Будучи владельцем листинга, API My Business Business Information позволяет вам просматривать эти обновления, чтобы убедиться в точности вашей бизнес-информации. В этом руководстве описывается, как принять или отклонить обновления.

Чтобы управлять обновлениями Google, выполните следующие действия:

  1. Найдите места с ожидающими обновлениями
  2. Просмотр обновленных полей
  3. Принять или отклонить обновления
  4. Обзор результатов

Найдите места с ожидающими обновлениями

Прежде чем вы сможете принять или отклонить обновления, вы должны выяснить, в каких местах доступны обновления Google. Лучший способ получать обновления Google для местоположений — управлять уведомлениями в реальном времени с помощью Cloud Pub/Sub . Если вы получили уведомление GOOGLE_UPDATE по теме Pub/Sub , значит, изменение готово к вашему рассмотрению. Поле locationName в уведомлении содержит имя ресурса местоположения с обновлениями Google.

Альтернативно вы можете просмотреть вызов locations.get и проверить Metadata на наличие флага hasGoogleUpdated . Если "isGoogleUpdated": true идентификатор места, связанный с этим местоположением, обновлен.

Запрос

Ниже приведен пример запроса locations.get :

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

Запрос

Ниже приведен пример ответа locations.get : 

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

Просмотр полей обновлений

Чтобы просмотреть конкретные поля, в которых есть обновления Google, вызовите locations.getGoogleUpdated . diffMask , в котором подробно описаны поля, обновленные Google, находится в теле ответа .

Запрос

Ниже приведен пример запроса locations.getGoogleUpdated :

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

Ответ

Ниже приведен пример ответа locations.getGoogleUpdated . В поле phoneNumbers.primaryPhone отображается доступное обновление. Значение в этом ответе — это предлагаемое значение обновления: 

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

Принять или отклонить обновления

Чтобы принять или отклонить обновление, выполните locations.patch с полями updateMask , установленными так же, как в diffMask , который вы получили ранее. Кроме того, сопоставьте предпочтительные значения для каждого поля.

Принять запрос

Ниже приведен пример запроса locations.patch :

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

Ответ

Ниже приведен пример ответа locations.patch : 

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

Отклонить запрос

Ниже приведен пример запроса 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"
     },
    ...
}

Ответ

Ниже приведен пример ответа locations.patch : 

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

Обзор результатов

Если ваше местоположение успешно исправлено, поле diffMask в ответе locations.getGoogleUpdated отобразит значения как "diffMask": "" . Кроме того, флаг "hasGoogleUpdated" в Metadata показывает значение false или значение отсутствует.

Если значения полей не ясны, обратитесь в нашу службу поддержки с запросом и ответом на getGoogleUpdated . Запрос должен включать ответ перед вызовом locations.patch , вызовом patch и вызовом getGoogleUpdated .