העברת ניהול החשבון

‫Accounts API מחולק לאוסף של משאבים שמאפשרים לנהל את חשבונות Merchant Center בצורה יעילה יותר, עם שליטה מדויקת יותר בהיבטים שונים של החשבון.

במדריך הזה מוסברים השינויים העיקריים, והוא יעזור לכם להעביר את השילוב הקיים של ניהול החשבון מ-Content API for Shopping אל Merchant API.

ממשאב אחד להרבה משאבים

ב-Content API for Shopping, המשאב Account היה אובייקט מונוליטי שהכיל הכול, החל משם החשבון וכתובת האתר ועד לרשימות משתמשים ופרטי העסק.

ב-Merchant API, המשאב הזה מפוצל לכמה משאבים קטנים וממוקדים יותר. השינוי הזה מאפשר קריאות ל-API ממוקדות ויעילות יותר. לדוגמה, כדי לעדכן רק את כתובת העסק, עכשיו צריך לשלוח בקשת PATCH למשאב BusinessInfo במקום לעדכן את כל האובייקט Account.

הטבלה הבאה מסכמת את המיפוי של המושגים מהמשאב Account של Content API for Shopping למשאבים החדשים ב-Merchant API:

יכולות חדשות

‫Merchant API כולל גם יכולות חדשות לניהול חשבונות שלא היו זמינות ב-Content API for Shopping:

  • תנאים והגבלות: אפשר לאחזר ולאשר את התנאים וההגבלות באופן פרוגרמטי באמצעות המשאבים TermsOfService ו-TermsOfServiceAgreementState.
  • יצירת חשבון: השיטה accounts.createAndConfigure תומכת עכשיו ביצירת חשבונות עם קשרים (כמו accountManagement), בהגדרת alias ובביטול אימות האימייל באמצעות השדה user.verificationMailSettings.verificationMailMode, לטובת אימות מבוסס-API באמצעות השיטה החדשה accounts.verifySelf.
  • גישה לחשבון לפי כינוי: גישה לחשבונות בפורמט providerId~accountAlias, שמאפשר לעסקים שמנהלים כמה חשבונות להשתמש במזהי החשבונות שלהם באופן עקבי.

בקשות

בטבלה הזו מוצגת השוואה בין כתובות ה-URL של הבקשות למשימות נפוצות של ניהול חשבונות ב-Content API for Shopping וב-Merchant API.

תיאור הבקשה Content API for Shopping Merchant API
קבלת חשבון GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
קבלת חשבון לפי כינוי לא זמין באופן ישיר GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
הצגת רשימה של חשבונות משנה GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
יצירת חשבון משנה POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
עדכון הנתונים בחשבון PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} ‫PATCH במשאב המתאים. לדוגמה, כדי לעדכן את שם החשבון: PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
מחיקת חשבון משני DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
תביעת בעלות על האתר POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
קשר חשבונות POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

ניהול פרטי החשבון העיקריים

המשאב Account ב-Merchant API מכיל את הפרטים החיוניים של חשבון Merchant Center, כמו השם, המזהה וההגדרות הבסיסיות שלו.

בקשת השוואה

תיאור הבקשה Content API for Shopping Merchant API
קבלת פרטי החשבון ‫GET /content/v2.1/{merchantId}/accounts/{accountId} (גישה למאפייני ליבה כמו name, adult_content) GET /accounts/v1/accounts/{account}
יצירת חשבון משנה POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
עדכון פרטי החשבון PUT /content/v2.1/{merchantId}/accounts/{accountId} (עדכון מאפייני ליבה) PATCH /accounts/v1/accounts/{account}
מחיקת חשבון משני DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

השוואה מפורטת של השדות

‫Content API for Shopping ‏ (Account) ‫Merchant API‏ (Account) הערות
id account_id המזהה המספרי הוא עכשיו שדה פלט בלבד. המזהה הראשי הוא המשאב name.
name account_name השם של החשבון, בפורמט שקריא לבני אדם.
language language_code שם השדה הוא עכשיו language_code.

ניהול פרטי העסק

אפשר להשתמש במשאב BusinessInfo כדי לנהל את המידע הציבורי על העסק, כמו הכתובת ופרטי הקשר של שירות הלקוחות. הוא מחליף את האובייקט businessInformation ב-Content API for Shopping.

בקשת השוואה

תיאור הבקשה Content API for Shopping Merchant API
קבלת פרטי העסק ‫GET /content/v2.1/{merchantId}/accounts/{accountId} (גישה למאפיין business_information) GET /accounts/v1/accounts/{account}/businessInfo
עדכון פרטי העסק PUT /content/v2.1/{merchantId}/accounts/{accountId} (עדכון המאפיין business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

השוואה מפורטת של השדות

‫Content API for Shopping ‏ (business_information) ‫Merchant API‏ (BusinessInfo) הערות
phone_number phone השדה הוא עכשיו phone ומשתמש ב-google.type.PhoneNumber.
customer_service.url customer_service.uri שם השדה הוא עכשיו uri.

ניהול דף הבית

כדי לנהל את כתובת האתר של החנות, לאמת אותה ולתבוע עליה בעלות, משתמשים במשאב Homepage. השדה הזה מחליף את השדה websiteUrl ואת השיטה accounts.claimwebsite מ-Content API for Shopping.

בקשת השוואה

תיאור הבקשה Content API for Shopping Merchant API
קבלת כתובת ה-URL של דף הבית ‫GET /content/v2.1/{merchantId}/accounts/{accountId} (גישה למאפיין website_url) GET /accounts/v1/accounts/{account}/homepage
עדכון כתובת ה-URL של דף הבית PUT /content/v2.1/{merchantId}/accounts/{accountId} (עדכון המאפיין website_url) PATCH /accounts/v1/accounts/{account}/homepage
תביעת בעלות על דף הבית POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
ביטול תביעת הבעלות על דף הבית לא זמין POST /accounts/v1/accounts/{account}/homepage:unclaim

השוואה מפורטת של השדות

‫Content API for Shopping ‏ (Account) ‫Merchant API‏ (Homepage) הערות
website_url uri כתובת ה-URL של דף הבית של החנות.
לא זמין באופן ישיר claimed שדה בוליאני שמוגדר כ-true אם דף הבית נתבע.

ניהול משתמשים

המשאב User מאפשר לכם לנהל את הגישה לחשבון Merchant Center. הפעולה הזו מחליפה את המערך users במשאב Account. ההבדל העיקרי הוא תהליך יצירת המשתמשים. ב-Merchant API, כשמוסיפים משתמש נשלחת הזמנה. המשתמש צריך לאשר את ההזמנה כדי לקבל גישה לחשבון.

בקשת השוואה

תיאור הבקשה Content API for Shopping Merchant API
הצגת רשימה של משתמשים ‫GET /content/v2.1/{merchantId}/accounts/{accountId} (גישה למאפיין users) GET /accounts/v1/accounts/{account}/users
יצירת משתמש PUT /content/v2.1/{merchantId}/accounts/{accountId} (עדכון המאפיין users) POST /accounts/v1/accounts/{account}/users
עדכון משתמש PUT /content/v2.1/{merchantId}/accounts/{accountId} (עדכון המאפיין users) PATCH /accounts/v1/accounts/{account}/users/{email}
מחיקת משתמש PUT /content/v2.1/{merchantId}/accounts/{accountId} (עדכון המאפיין users) DELETE /accounts/v1/accounts/{account}/users/{email}

השוואה מפורטת של השדות

‫Content API for Shopping (אובייקט מערך users) ‫Merchant API (משאב User) הערות
email_address name (בפורמט accounts/{account}/users/{email}) כתובת האימייל של המשתמש היא עכשיו חלק משם המשאב.
‫admin, order_manager, reporting_manager וכו'. access_rights זכויות הגישה מאוחדות עכשיו בשדה enum חוזר.
לא זמין state שדה חדש לפלט בלבד שמציין אם המשתמש הוא PENDING או VERIFIED.

ניהול קשרים בין חשבונות ושירותים

ב-Content API for Shopping, הקשרים נוהלו באמצעות accounts.link. ב-Merchant API יש מודל מפורש יותר עם המשאבים AccountService ו-AccountRelationship, שמצריך תהליך של לחיצת יד (הצעה ואישור).

בקשת השוואה

תיאור הבקשה Content API for Shopping Merchant API
קשר חשבונות POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
הצגת רשימה של חשבונות מקושרים GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships וגם GET /accounts/v1/accounts/{account}/services

השוואה מפורטת של השדות

‫Content API for Shopping ‏ (AccountLink) ‫Merchant API‏ (AccountService, AccountRelationship) הערות
linked_account_id provider (בAccountService) מזהה החשבון שמספק את השירות.
service service_type (בAccountService) סוג השירות שניתן (למשל, ACCOUNT_AGGREGATION).
status handshake.approval_state (בAccountService) סטטוס הקישור (למשל, PENDING, ESTABLISHED).

הגדרות המס בחשבון

השירות accounttax מ-Content API for Shopping לא זמין ב-Merchant API. כבר לא צריך לספק מידע על מס מכירה בארה"ב. מידע נוסף זמין במאמר בנושא עדכון במפרט נתוני המוצרים של Merchant Center לשנת 2025.

ניהול זהות העסק

אפשר להשתמש במשאב BusinessIdentity כדי להצהיר בעצמכם על מאפיינים של העסק. הוא מחליף את האובייקט businessIdentity ב-Content API for Shopping.

בקשת השוואה

תיאור הבקשה Content API for Shopping Merchant API
קבלת זהות העסק ‫GET /content/v2.1/{merchantId}/accounts/{accountId} (גישה למאפיין business_identity) GET /accounts/v1/accounts/{account}/businessIdentity
עדכון זהות העסק PUT /content/v2.1/{merchantId}/accounts/{accountId} (עדכון המאפיין business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

השוואה מפורטת של השדות

‫Content API for Shopping ‏ (business_identity) ‫Merchant API‏ (BusinessIdentity) הערות
black_owned.self_identified (בוליאני) black_owned.identity_declaration (enum) הערך הבוליאני מוחלף על ידי enum‏ (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) כדי שההצהרה תהיה מפורשת יותר. ההנחיה הזו רלוונטית לכל מאפייני הזהות.
include_for_promotions (בוליאני) promotions_consent (enum) ערך בוליאני גלובלי מוחלף בערך טיפוסים בני מנייה (enum) תיאורי יותר (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED).

הצגת רשימה של חשבונות

ב-Content API for Shopping, הסוג היחיד של חשבון מתקדם היה "חשבון מרובה-לקוחות (MCA)", והוא חשף שיטה של accounts.list כדי להציג את החשבונות של חשבון מרובה-הלקוחות הנתון. חשבונות מתקדמים ב-Merchant API הם הרבה יותר חזקים, ומאפשרים מגוון רחב יותר של סוגי חשבונות וקשרים. כדי לאפשר מעבר פשוט לחשבונות מתקדמים, Merchant API מספק מקבילה ישירה ל-accounts.list של Content API for Shopping בתור שיטת accounts.listSubaccounts. אנחנו משיקים שיטה חדשה ומשופרת של accounts.list שמאפשרת סינון מתקדם של החשבון.

בקשת השוואה

תיאור הבקשה Content API for Shopping Merchant API
הצגת רשימת החשבונות של חשבון מתקדם GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
הצגת רשימה של כל החשבונות שיש לכם גישה אליהם לא זמין GET /accounts/v1/accounts

השוואה מפורטת של שדות (פרמטרים של בקשות)

‫Content API for Shopping ‏ (accounts.list) ‫Merchant API‏ (accounts.listSubaccounts) הערות
‫merchant_id (פרמטר של הנתיב) ‫provider (פרמטר של הנתיב) המזהה של החשבון המתקדם בפורמט accounts/{account}.
max_results page_size המספר המקסימלי של חשבונות שיוחזרו.
הקודם
Refactor code for concurrent requests
הבא
Migrate accountstatuses to Account Issues