במדריך הזה מוסבר איך להשתמש במשאב EmailPreferences
כדי לנהל את ההתראות באימייל מ-Merchant Center, ולראות אילו סוגים של הודעות אימייל מגיעות לחשבון users
.
רשימה מלאה של סוגי ההתראות באימייל זמינה בחומר העזר של EmailPreferences
.
אפשר להשתמש ב-Merchant API רק כדי לנהל התראות באימייל בחשבונות שבהם נוספתם כמשתמשים.
כדי להציג או לעדכן את ההתראות באימייל, צריך את הערכים הבאים:
- כתובת האימייל של המשתמש שמקבל את האימיילים. כתובת האימייל שלהם מופיעה בשדה
name
של המשאבUser
. - מספר חשבון Merchant של החשבון שרוצים להתחיל או להפסיק לקבל אימיילים לגביו. אם חשבון המוכר הוא חשבון מתקדם ולמשתמש יש גישה לחשבון המתקדם, צריך להשתמש במזהה המוכר של החשבון המתקדם.
הצטרפות לקבלת התראות או ביטול ההרשמה לקבלת התראות
כדי לעדכן את הגדרות ההתראות באימייל בחשבון מוכר מסוים, צריך להתקשר למספר 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.