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