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

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

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

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

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

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

הנה סיכום של המושגים מ-Content API for Shopping Account שמופיעים במקורות המידע החדשים ב-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 resource) הערות
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 (boolean) black_owned.identity_declaration (enum) הערך הבוליאני מוחלף בסוג enum ‏ (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) כדי להצהיר על הערך בצורה ברורה יותר. ההגדרה הזו חלה על כל מאפייני הזהות.
include_for_promotions (boolean) 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