يشرح هذا الدليل كيفية استخدام
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. إعدادات البريد الإلكتروني المفضَّلة.