Управление уведомлениями по электронной почте Merchant Center

В этом руководстве объясняется, как использовать ресурс EmailPreferences для управления уведомлениями по электронной почте Merchant Center и просмотра типов электронных писем, которые получают users вашего аккаунта. Полный список типов уведомлений по электронной почте см. в справочнике EmailPreferences .

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

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

• Адрес электронной почты пользователя, который получает электронные письма. Вы можете найти их адрес электронной почты в поле name ресурса User .
• Идентификатор продавца учетной записи, о которой можно начать или прекратить получать электронные письма. Если учетная запись продавца является расширенной учетной записью и у пользователя есть доступ к расширенной учетной записи , используйте идентификатор продавца расширенной учетной записи.

Включить или отключить уведомления

Чтобы обновить настройки уведомлений по электронной почте для определенной учетной записи продавца, вызовите accounts.v1beta.accounts.users.updateEmailPreference , указав merchantId продавца учетной записи и адрес электронной почты пользователя.

Используйте следующие значения для управления уведомлениями по электронной почте, которые получает пользователь:

• OPTED_IN : получать уведомления по электронной почте для учетной записи.
• OPTED_OUT : не получать уведомления по электронной почте для этой учетной записи.

Вот пример запроса на отказ пользователя от уведомлений по электронной почте для определенного аккаунта продавца:

PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences

{
  "newsAndTips": "OPTED_OUT"
}

Просмотр существующих уведомлений

Чтобы просмотреть текущие настройки уведомлений по электронной почте для конкретного пользователя, accounts.v1beta.accounts.users.getEmailPreferences .

Ниже приведен пример запроса, где merchantId — это идентификатор продавца учетной записи, о которой отправляются уведомления по электронной почте, а emailAddress — это адрес электронной почты пользователя, который получает электронные письма.

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences

Вот пример ответа на успешный вызов:

{
  "name": "accounts/merchantId/users/emailAddress/emailPreferences",
  "newsAndTips": "OPTED_IN"
}

Дополнительную информацию об уведомлениях по электронной почте см. в разделе Изменение настроек электронной почты Merchant Center .