ניהול ההתראות באימייל מ-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.