Zarządzanie e-mailami z powiadomieniami Merchant Center

Z tego przewodnika dowiesz się, jak korzystać z zasobu EmailPreferences, aby zarządzać powiadomieniami e-mail z Merchant Center i sprawdzać, jakiego typu e-maile otrzymują konta users. Pełną listę typów powiadomień e-mail znajdziesz w dokumentacji EmailPreferences.

Interfejsu Merchant API możesz używać tylko do zarządzania powiadomieniami e-mail na kontach, na których dodano Cię jako użytkownika.

Aby wyświetlić lub zaktualizować powiadomienia e-mailem, musisz mieć te wartości:

• Adres e-mail użytkownika, który otrzymuje e-maile. Adres e-mail tego konta znajdziesz w polu name zasobu User.
• Identyfikator sprzedawcy konta, na które mają być wysyłane e-maile. Jeśli konto sprzedawcy jest kontem zaawansowanym, a użytkownik ma dostęp do tego konta, użyj identyfikatora sprzedawcy tego konta zaawansowanego.

Włączanie i wyłączanie powiadomień

Aby zaktualizować ustawienia powiadomień e-mail na konkretnym koncie sprzedawcy, zadzwoń pod numer accounts.v1beta.accounts.users.updateEmailPreference, podając merchantId konta i adres e-mail użytkownika.

Aby określić, jakie e-maile z powiadomieniami o zmianach w ustawieniach użytkownika, użyj tych wartości:

• OPTED_IN: otrzymywanie e-maili z powiadomieniami dotyczącymi konta.
• OPTED_OUT: nie otrzymuj powiadomień e-mail na konto.

Oto przykładowa prośba o wyrejestrowanie użytkownika z usług wysyłania e-maili z powiadomieniami na konkretnym koncie sprzedawcy:

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

{
  "newsAndTips": "OPTED_OUT"
}

Wyświetlanie istniejących powiadomień

Aby sprawdzić bieżące ustawienia powiadomień e-mail dla konkretnego użytkownika, zadzwoń pod numer accounts.v1beta.accounts.users.getEmailPreferences.

Oto przykładowa prośba, w której merchantId to identyfikator sprzedawcy konta, na które wysyłane są powiadomienia e-mail, a emailAddress to adres e-mail użytkownika, który je otrzymuje.

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

Oto przykład odpowiedzi po pomyślnym wywołaniu:

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

Więcej informacji o powiadomieniach e-mail znajdziesz w artykule Zmienianie ustawień powiadomień e-mail w Merchant Center.