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

ה-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.
  • גישה לחשבון באמצעות כינוי: גישה לחשבונות באמצעות פורמט 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 (בוליאני) 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 המספר המקסימלי של חשבונות שיוחזרו.