このガイドでは、
EmailPreferences
Merchant Center のメールを管理するためのリソースです。
通知に
アカウントのメールの種類
users
が受信します。
メール通知の種類の完全なリストについては、EmailPreferences
リファレンスをご覧ください。
メール通知の管理に使用できるのは Merchant API のみです アカウントとして追加されたアカウントでは user です。
メール通知を表示または更新するには、次の値が必要です。
- メールを受信するユーザーのメールアドレス。こちらの
User
リソースのname
フィールドにあるメールアドレス。 - メールの受信を開始または停止するアカウントの販売者 ID。条件 販売アカウントがアドバンス アカウント、ユーザーが Advanced Solutions Lab の 作成するには、販売者 ID を使用して 2 つのアカウントがあります
通知を有効または無効にする
特定の販売アカウントのメール通知設定を変更するには、
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
は販売者の 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 を変更する メール設定をご覧ください。