إدارة الإشعارات عبر البريد الإلكتروني في 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.