يشرح هذا الدليل كيفية استخدام المورد 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.