העברת קישור חשבונות

הניהול של קשרי חשבונות התפתח משיטת link אחת ב-Content API for Shopping למערכת מפורטת וברורה יותר ב-Merchant API. ב-API החדש נעשה שימוש במשאבים ייעודיים כמו AccountRelationship ו-AccountService כדי להגדיר את השירותים הספציפיים שחשבון אחד מספק לחשבון אחר. פרטים נוספים זמינים במאמר בנושא קשרים בין חשבונות.

ההבדלים העיקריים

  • משאבים ייעודיים לקשרים ולשירותים: ב-Merchant API, המשאב AccountRelationship מגדיר את הקשר בין ספק שירותים לבין מוֹכר, והמשאב AccountService מציין את השירות המדויק שניתן (לדוגמה, accountAggregation). המשאבים האלה מחליפים את השדות הכלליים linkType ו-services מ-Content API for Shopping.
  • שיטות פעולה מפורשות: במקום שיטה אחת של link עם פרמטר action, ב-Merchant API נעשה שימוש בשיטות נפרדות לניהול שירותים, כמו propose,‏ approve ו-reject.
  • קישור ייעודי לפרופיל העסק ב-Google: קישור לפרופיל העסק ב-Google, שבעבר בוצע על ידי הגדרת השדה googleMyBusinessLink, מתבצע עכשיו באמצעות שיטה ייעודית, gbpAccounts.linkGbpAccount.
  • יצירת חשבון לקוח כשירות: יצירת חשבון לקוח בחשבון מתקדם נחשבת עכשיו להצעה של שירות accountAggregation באמצעות השיטה accounts.createAndConfigure. מידע נוסף על חשבונות זמין בדף Merchant Accounts API. לא נדרש תהליך אימות כי למשתמש יש גישה גם לחשבון המתקדם וגם לחשבון הלקוח.

בקשות

‫Merchant API מספק נקודות קצה ספציפיות לניהול סוגים שונים של קישורי חשבונות ושירותים:

כתובות URL של בקשות Merchant API

  • הצעת שירות חדש: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • אישור שירות: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • דחיית שירות: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • קישור לפרופיל העסק ב-Google: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • יצירת חשבון לקוח (קישור צבירת חשבונות): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

השוואה של כתובות URL של בקשות

תיאור הבקשה Content API for Shopping Merchant API
קישור חשבונות (לדוגמה, פלטפורמות של צד שלישי) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
קישור לפרופיל העסק ב-Google ‫PUT .../v2.1/{merchantId}/accounts/{accountId} (עם השדה googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
יצירת חשבון לקוח POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Methods

שיטה של Content API for Shopping שיטת Merchant API זמינות והערות
accounts.link accountServices.propose משתמשים בשיטה הזו כדי להפעיל שירות חדש עם חשבון אחר.
‫accounts.link (עם action: "approve") accountServices.approve משתמשים בשיטה הזו כדי לאשר הצעת שירות בהמתנה.
‫accounts.link (עם action: "remove") accountServices.reject אפשר להשתמש בשיטה הזו כדי לדחות שירות בהמתנה או שירות שכבר הופעל.
accounts.insert (בחשבונות לקוח) accounts.createAndConfigure אפשר להשתמש בשיטה הזו עם שירות accountAggregation כדי ליצור חשבון לקוח חדש בחשבון מתקדם.
‫accounts.update (עם googleMyBusinessLink) gbpAccounts.linkGbpAccount אפשר להשתמש בשיטה הייעודית הזו כדי לקשר חשבון Merchant Center לפרופיל עסק ב-Google.
‫accounts.update (עם adsLinks) AccountRelationship משאב הקישור ל-Google Ads מתבצע דרך ממשק המשתמש של Google Ads. הקישור שמתקבל מיוצג כ-AccountRelationship ב-Merchant API, ואפשר לראות אותו אבל אי אפשר ליצור אותו ישירות.

שינויים מפורטים בשדות

Content API for Shopping Merchant API תיאור
AccountsLinkRequest.action propose, approve, reject שיטות השדה היחיד action מוחלף בשיטות API ייעודיות לכל שינוי סטטוס במחזור החיים של השירות.
AccountsLinkRequest.linkType AccountService.service_type המחרוזת הכללית linkType מוחלפת בשדה מובנה service_type oneof במשאב AccountService, כמו productsManagement או accountAggregation
AccountsLinkRequest.services AccountService.service_type רשימת השירותים שמבוססים על מחרוזות מיוצגת עכשיו על ידי service_type ספציפי שנבחר במשאב AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider המזהה של החשבון שמספק את השירות מופיע עכשיו בשדה provider של בקשת propose.
Account.googleMyBusinessLink LinkGbpAccountRequest האובייקט שמכיל את פרטי הקישור ל-GBP מוחלף בהודעת בקשה ייעודית לשיטה linkGbpAccount.
Account.adsLinks AccountRelationship קישורים ל-Google Ads מיוצגים כמשאב AccountRelationship שבו provider הוא providers/GOOGLE_ADS. בדרך כלל, הקשר הזה מנוהל מממשק המשתמש של Google Ads.