این راهنما نحوه استفاده از منبع 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 مراجعه کنید.