このガイドでは、EmailPreferences リソースを使用して Merchant Center のメール通知を管理する方法と、アカウントの users が受け取るメールの種類を確認する方法について説明します。メール通知タイプの完全なリストについては、EmailPreferences リファレンスをご覧ください。
Merchant API を使用して管理できるのは、ユーザーとして追加されたアカウントのメール通知のみです。
メール通知を表示または更新するには、次の値が必要です。
- メールを受信するユーザーのメールアドレス。メールアドレスは、
Userリソースのnameフィールドで確認できます。 - メールの受信を開始または停止するアカウントの販売者 ID。販売アカウントがアドバンス アカウントで、ユーザーがアドバンス アカウントにアクセスできる場合は、アドバンス アカウントの販売者 ID を使用します。
通知を有効または無効にする
特定の販売アカウントのメール通知の設定を更新するには、アカウントの merchantId とユーザーのメールアドレスを指定して accounts.v1beta.accounts.users.updateEmailPreference を呼び出します。
次の値を使用して、ユーザーが受信するメール通知を制御します。
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 はメール通知が送信されるアカウントの販売者 ID、emailAddress はメールを受信するユーザーのメールアドレスです。
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences
呼び出しが成功した場合のレスポンス例を次に示します。
{
"name": "accounts/merchantId/users/emailAddress/emailPreferences",
"newsAndTips": "OPTED_IN"
}
メール通知について詳しくは、Merchant Center のメール設定を変更するをご覧ください。