Zarządzanie e-mailami z powiadomieniami Merchant Center

Z tego przewodnika dowiesz się, jak za pomocą zasobu EmailPreferences zarządzać e-mailami z powiadomieniami Merchant Center i sprawdzać, jakie rodzaje e-maili otrzymywane są na Twoim koncie users. Pełną listę typów e-maili z powiadomieniami znajdziesz w EmailPreferences.

Za pomocą interfejsu Merchant API możesz zarządzać e-mailami z powiadomieniami tylko w przypadku kont, do których zostałeś dodany jako użytkownik.

Aby wyświetlać lub aktualizować e-maile z powiadomieniami, potrzebujesz tych wartości:

• Adres e-mail użytkownika, który otrzymuje e-maile. Ich adres e-mail znajdziesz w polu name zasobu User.
• Identyfikator sprzedawcy powiązany z kontem, o którym chcesz otrzymywać e-maile lub z nich zrezygnować. Jeśli konto sprzedawcy jest kontem zaawansowanym, a użytkownik ma dostęp do konta zaawansowanego, użyj identyfikatora sprzedawcy konta zaawansowanego.

Włączanie i wyłączanie powiadomień

Aby zaktualizować ustawienia powiadomień e-mail dla konkretnego konta sprzedawcy, wywołaj accounts.v1beta.accounts.users.updateEmailPreference, podając merchantId konta i adres e-mail użytkownika.

Użyj tych wartości, aby określić, jakie e-maile z powiadomieniami ma otrzymywać użytkownik:

• OPTED_IN – otrzymywanie e-maili z powiadomieniami dotyczącymi konta.
• OPTED_OUT: nie otrzymuj e-maili z powiadomieniami dotyczącymi konta.

Oto przykładowe żądanie rezygnacji użytkownika z powiadomień e-mail 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 zobaczyć bieżące ustawienia e-maili z powiadomieniami dla konkretnego użytkownika, zadzwoń pod numer accounts.v1beta.accounts.users.getEmailPreferences.

Oto przykładowe żądanie, w którym merchantId to identyfikator sprzedawcy powiązany z kontem, którego dotyczą powiadomienia e-mail, a emailAddress to adres e-mail użytkownika, który otrzymuje e-maile.

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

Oto przykładowa odpowiedź udanego wywołania:

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

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