Package google.shopping.merchant.notifications.v1beta

Индекс

УведомленияApiService

Сервис для управления подписками на уведомления для продавцов

Создать подписку на уведомление

rpc CreateNotificationSubscription( CreateNotificationSubscriptionRequest ) returns ( NotificationSubscription )

Создает подписку на уведомления для продавца. Мы разрешим совместное существование следующих типов подписок на уведомления (для каждого продавца как подписчика для каждого типа события): 1. Подписка на все управляемые учетные записи + подписка для себя. 2. Несколько «частичных» подписок для управляемых учетных записей + подписка для себя.

мы не разрешаем (для каждого продавца как подписчика для каждого типа события): 1. несколько самостоятельных подписок. 2. несколько подписок «на все управляемые учетные записи». 3. все и частичные подписки одновременно. 4. несколько частичных подписок для одной целевой учетной записи.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

Удалить подписку на уведомление

rpc DeleteNotificationSubscription( DeleteNotificationSubscriptionRequest ) returns ( Empty )

Удаляет подписку на уведомления для продавца.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

Получить уведомление о подписке

rpc GetNotificationSubscription( GetNotificationSubscriptionRequest ) returns ( NotificationSubscription )

Получает подписки на уведомления для учетной записи.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

Список уведомлений о подписках

rpc ListNotificationSubscriptions( ListNotificationSubscriptionsRequest ) returns ( ListNotificationSubscriptionsResponse )

Получает все подписки на уведомления для продавца.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

Подписка на уведомление об обновлении

rpc UpdateNotificationSubscription( UpdateNotificationSubscriptionRequest ) returns ( NotificationSubscription )

Обновляет существующую подписку на уведомления для продавца.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

Атрибут

Enum для указания атрибута в ресурсе, который изменяется, чтобы уведомить об этом продавца.

Перечисления
ATTRIBUTE_UNSPECIFIED Неопределенный атрибут
STATUS Статус измененной сущности

CreateNotificationSubscriptionRequest

Сообщение запроса для метода CreateNotificationSubscription.

Поля
parent

string

Необходимый. Учетная запись продавца, которому принадлежит новая подписка на уведомления. Формат: accounts/{account}

notification_subscription

NotificationSubscription

Необходимый. Подписка на уведомления, которую необходимо создать.

Удалить уведомление о подписке

Сообщение запроса для метода DeleteNotificationSubscription.

Поля
name

string

Необходимый. Имя подписки на уведомления, которую необходимо удалить.

Получить уведомление о подписке

Сообщение запроса для метода GetNotificationSubscription.

Поля
name

string

Необходимый. name подписки на уведомления.

Список уведомлений о подпискахЗапрос

Сообщение запроса для метода ListNotificationSubscription.

Поля
parent

string

Необходимый. Учетная запись продавца, которому принадлежат подписки на уведомления. Формат: accounts/{account}

page_size

int32

Максимальное количество подписок на уведомления, возвращаемых на странице. Значение по умолчанию для page_size — 100. Максимальное значение — 200 . Значения выше 200 будут уменьшены до 200 .

page_token

string

Токен (если предоставлен) для получения следующей страницы. Все остальные параметры должны соответствовать исходному вызову, который предоставил токен страницы.

ListNotificationSubscriptionsResponse

Ответное сообщение для метода ListNotificationSubscription.

Поля
notification_subscriptions[]

NotificationSubscription

Список подписок на уведомления, запрошенных продавцом.

next_page_token

string

Токен, который можно отправить как page_token для получения следующей страницы. Если это поле опущено, последующие страницы отсутствуют.

УведомлениеПодписка

Представляет подписку на уведомления, принадлежащую учетной записи продавца.

Поля
name

string

Только вывод. name конфигурации уведомлений. Создается Content API при создании нового NotificationSubscription . account представляет собой идентификатор продавца, которому принадлежит конфигурация. Формат: accounts/{account}/notificationsubscriptions/{notification_subscription}

registered_event

NotificationEventType

Событие, о котором продавец хочет получить уведомление.

call_back_uri

string

URL-адрес, который будет использоваться для отправки уведомления продавцу.

Поле объединения interested_in .

interested_in может быть только одним из следующих:

all_managed_accounts

bool

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

target_account

string

name учетной записи, для которой вы хотите получать уведомления. Формат: accounts/{account}

Тип уведомлениясобытия

Представляет тип события, уведомления о котором продавец хочет получать.

Перечисления
NOTIFICATION_EVENT_TYPE_UNSPECIFIED Тип события уведомлений не указан.
PRODUCT_STATUS_CHANGE Уведомление об изменении статуса продукта, например, когда продукт становится отклоненным.

Изменение продукта

Изменение, произошедшее с продуктом, включая старое значение, новое значение, код страны в качестве кода региона и контекст отчета.

Поля
old_value

string

Старое значение измененного ресурса или атрибута.

new_value

string

Новое значение измененного ресурса или атрибута.

region_code

string

Страны, в которых произошли изменения (если применимо)

reporting_context

ReportingContextEnum

Контексты отчетности, в которых произошли изменения (если применимо)

Статус продуктаИзменитьСообщение

Сообщение, которое получит продавец для уведомления о событии изменения статуса товара.

Поля
changes[]

ProductChange

Сообщение, описывающее изменение, произошедшее с продуктом.

account

string

Целевая учетная запись, которой принадлежит измененная сущность. Формат: accounts/{merchant_id}

managing_account

string

Учетная запись, которая управляет учетной записью продавца. может совпадать с идентификатором продавца, если это отдельный аккаунт. Формат: accounts/{service_provider_id}

resource_type

Resource

Ресурс, который изменился, в данном случае всегда будет Product .

attribute

Attribute

Атрибут в ресурсе, который изменился, в данном случае это всегда будет Status .

resource_id

string

Идентификатор продукта.

resource

string

Название продукта. Формат: {product.name=accounts/{account}/products/{product}}

Ресурс

Перечисление, чтобы указать ресурс, который изменяется, о котором необходимо уведомить продавца.

Перечисления
RESOURCE_UNSPECIFIED Неуказанный ресурс
PRODUCT Тип ресурса: продукт

Запрос на подписку на уведомление об обновлении

Сообщение запроса для метода UpdateNotificationSubscription.

Поля
notification_subscription

NotificationSubscription

Необходимый. Новая версия подписки на уведомления, которую следует обновить.

update_mask

FieldMask

Список полей обновляется.