ניהול ההתראות באימייל מ-Merchant Center

במדריך הזה מוסבר איך להשתמש במשאב 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.