Получайте push-уведомления об изменениях в данных вашего продукта

Вы можете использовать API уведомлений для продавцов, чтобы получать push-уведомления об изменениях в данных о товарах. Например, если вы подписаны на уведомления об изменении статуса товара, вы будете получать уведомления в режиме реального времени, когда товар будет отклонен. Вы можете подписаться на уведомления для любого из ваших субсчетов или других связанных учетных записей .

В этом руководстве приведены примеры управления уведомлениями об изменениях статуса товара. Вы можете использовать эти примеры для управления уведомлениями о других событиях, изменяя значение поля registeredEvent в ваших запросах. Полный список типов событий см. в справочнике API уведомлений для продавцов .

Подписаться

Для получения уведомлений вам необходим callBackUri . Ваш callback URI должен соответствовать следующим требованиям:

  • Это должен быть общедоступный HTTPS-адрес с действительным SSL-сертификатом, подписанным центром сертификации.
  • Необходимо принимать HTTP POST запросы с заголовком Content-Type и значением application/json .
  • Для подтверждения получения уведомления необходимо вернуть один из следующих кодов ответа.
    • 102
    • 200
    • 201
    • 202
    • 204

Для нескольких подписок можно использовать один и тот же URI обратного вызова. Мы рекомендуем использовать уникальный URI обратного вызова для каждой расширенной учетной записи и каждого типа события, чтобы минимизировать нагрузку на запросы push-уведомлений, отправляемые на один URI.

Вот пример запроса на подписку на уведомления об изменениях статуса товара для конкретного торгового счета.

POST https://merchantapi.googleapis.com/notifications/v1/accounts/ACCOUNT_ID/notificationsubscriptions/

{
  "registeredEvent": "PRODUCT_STATUS_CHANGE",
  "targetAccount": "accounts/TARGETACCOUNT_ID",
  "callBackUri": "https://example.com"
}

Замените следующее:

  • ACCOUNT_ID : Уникальный идентификатор учетной записи, которая должна получать уведомления.
  • TARGETACCOUNT_ID : Уникальный идентификатор учетной записи, о которой вы хотите получать уведомления.

Если ваш аккаунт в Merchant Center является автономным аккаунтом без связанных аккаунтов, и вы хотите получать уведомления для своего собственного аккаунта, замените обе эти переменные идентификатором вашего аккаунта.

В случае успешного выполнения запроса возвращается name вашей подписки, включая идентификатор подписки:

{
  "name":"accounts/ACCOUNT_ID/notificationsubscriptions/subscriptionId",
  "registeredEvent": "PRODUCT_STATUS_CHANGE",
  "targetAccount": "accounts/TARGETACCOUNT_ID",
  "callBackUri": "https://example.com"
}

Это name можно использовать для GET и DELETE отдельных подписок.

Вы можете подписаться на уведомления об изменениях статуса продукта для всех связанных учетных записей, указав в запросе параметр "allManagedAccounts": true вместо targetAccount :

POST https://merchantapi.googleapis.com/notifications/v1/accounts/ACCOUNT_ID/notificationsubscriptions/

{
  "registeredEvent": "PRODUCT_STATUS_CHANGE",
  "allManagedAccounts": true,
  "callBackUri": "https://example.com"
}

Для обновления существующей подписки используйте PATCH с параметром update_mask чтобы указать поля, которые вы хотите обновить, и новые значения в теле JSON-сообщения:

PATCH https://merchantapi.googleapis.com/notifications/v1/accounts/ACCOUNT_ID/notificationsubscriptions/SUBSCRIPTION_ID?update_mask=callBackUri

{
  "​callBackUri": "https://my-own-personal-domain.com"
}

Расшифровка уведомлений

После создания подписки вы будете получать уведомления на указанный callBackUri в следующем формате:

{"message":{"data":"{base64_encoded_string}"}}

Данные уведомления закодированы. Вы можете декодировать эти данные в читаемый текстовый формат для использования в вашей реализации. Вот пример контроллера Spring Boot, который вы можете использовать для обработки закодированных данных:

@RestController
public class ExampleController {
@RequestMapping(value = "/push",
  method = RequestMethod.POST,
  consumes = {"application/json"},
  produces = {"text/plain"})
  @ResponseStatus(HttpStatus.OK)
  public void doStuff(@RequestBody String message) {
        //wrapped message
        JSONObject jsonObject = new JSONObject(message);
        JSONObject jsonMessage = jsonObject.getJSONObject("message");
        message = jsonMessage.getString("data");
        byte[] decodedBytes = Base64.getDecoder().decode(message);
        String decodedMessage = new String(decodedBytes);
        // Implement your business logic here
  }
}

Вот пример декодированной строки, закодированной в base64_encoded_string :

{
  "account": "accounts/TARGETACCOUNT_ID",
  "managingAccount": "accounts/ACCOUNT_ID",
  "resourceType": "PRODUCT",
  "attribute": "STATUS",
  "changes": [{
    "oldValue": "approved",
    "newValue": "disapproved",
    "regionCode": "US",
    "reportingContext": "SHOPPING_ADS"
  }, {
    "oldValue": "approved",
    "newValue": "disapproved",
    "regionCode": "JP",
    "reportingContext": "SHOPPING_ADS"
  },{
    "oldValue": "approved",
    "newValue": "disapproved",
    "regionCode": "GE",
    "reportingContext": "SHOPPING_ADS"
  }],
  "resourceId": "ONLINE~en~US~1234",
  "resource": "accounts/TARGETACCOUNT_ID/products/ONLINE~en~US~1234",
  "expirationTime": "2024-10-22T02:43:47.461464Z",
  "eventTime": "2024-03-21T02:43:47.461464Z"
}

Если в уведомлении отсутствует поле oldValue , значит, в ваш аккаунт был добавлен новый товар. Если отсутствует поле newValue , значит, товар был удален из вашего аккаунта.

Поле expirationTime не будет существовать, если товар был удален.

Поле reportingContext поддерживает только ( SHOPPING_ADS , LOCAL_INVENTORY_ADS , YOUTUBE_SHOPPING , YOUTUBE_CHECKOUT , YOUTUBE_AFFILIATE , FREE_LISTINGS_UCP_CHECKOUT ) из значения перечисления ReportingContextEnum .

При изменении статуса товара поля oldValue и newValue будут иметь одно из следующих значений: ( approved , pending , disapproved , ``).

Поле eventTime содержит время создания самого события. Если вы хотите упорядочить сообщения, следует полагаться на значение этого поля, а не на порядок получения сообщений.

Для получения более подробной информации используйте формат сообщения ProductStatusChangeMessage .

Протестируйте свою реализацию.

Вот пример уведомления, который вы можете использовать для проверки URI обратного вызова и декодирования:

curl --header "Content-Type: application/json" --header "Accept: text/plain" --request POST --data '{"message":{"data":
"ewogICJhY2NvdW50IjogImFjY291bnRzLzEyMzQiLAogICJtYW5hZ2luZ0FjY291bnQiOiAiYWNjb3VudHMvNTY3OCIsCiAgInJlc291cmNlVHlwZSI6ICJQUk9EVUNUIiwKICAiYXR0cmlidXRlIjogIlNUQVRVUyIsCiAgImNoYW5nZXMiOiBbewogICAgIm9sZFZhbHVlIjogImFwcHJvdmVkIiwKICAgICJyZWdpb25Db2RlIjogIlVTIiwKICAgICJyZXBvcnRpbmdDb250ZXh0IjogIlNIT1BQSU5HX0FEUyIKICB9XSwKICAicmVzb3VyY2VJZCI6ICJPTkxJTkV+ZW5+VVN+MDAwMDAwMDAwMDAwIiwKICAicmVzb3VyY2UiOiAiYWNjb3VudHMvMTIzNC9wcm9kdWN0cy9PTkxJTkV+ZW5+VVN+MDAwMDAwMDAwMDAwIiwKICAiZXhwaXJhdGlvblRpbWUiOiAiMjAyNC0xMC0yMlQwMjo0Mzo0Ny40NjE0NjRaIiwKICAiZXZlbnRUaW1lIjogIjIwMjQtMDMtMjFUMDI6NDM6NDcuNDYxNDY0WiIKfQ=="}}' https://{callBackUri}

В ответ на этот вызов ваш URI обратного вызова должен вернуть код успешного ответа . Декодированное сообщение должно содержать следующее значение: 

{
  "account": "accounts/1234",
  "managingAccount": "accounts/5678",
  "resourceType": "PRODUCT",
  "attribute": "STATUS",
  "changes": [{
    "oldValue": "approved",
    "regionCode": "US",
    "reportingContext": "SHOPPING_ADS"
  }],
  "resourceId": "ONLINE~en~US~000000000000",
  "resource": "accounts/1234/products/ONLINE~en~US~000000000000",
  "expirationTime": "2024-10-22T02:43:47.461464Z",
  "eventTime": "2024-03-21T02:43:47.461464Z"
}
Назад
Control access to your account
Далее
Enable automatic improvements