העברת ניהול החשבון מ-Content API for Shopping

במסמך הזה מוסבר איך עוברים מ-Content API v2.1 ל-Merchant API.

סקירה כללית של השינויים מ-Content API v2.1 ל-Merchant API

Merchant API כולל שיפורים משמעותיים בהשוואה ל-Content API בגרסה 2.1, במטרה לשפר את נוחות השימוש, העקביות והגמישות למפתחים ולעסקים.

מבנה משאבים מפורט

משאבים ב-Merchant API מייצגים מושגים בודדים, כמו account,‏ businessDetails,‏ user,‏ homepage ו-program. הם מאורגנים באופן היררכי כדי לשקף את היחסים ביניהם. לדוגמה, account הוא המשאב ההורה של user.

שירותי חשבון מאוחדים

כל שירותי החשבון (לדוגמה, צבירת חשבונות של חשבונות ניהול חשבונות שותפים (MCA) וחשבונות המשנה שלהם, או בין חשבונות לבין ספקי שירות של צד שלישי) מנוהלים באמצעות משאב מאוחד מסוג accountService. ספקי השירות יכולים לנהל את היחסים שלהם באמצעות המשאב accountRelationship.

מבנה פשוט יותר של כתובות URL

כתובות ה-URL כוללות עכשיו מזהה חשבון יחיד (לדוגמה, merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}) במקום כמה מזהים. נתיבי כתובות ה-URL משקפים את המבנה המפורט של המשאבים.

שיפורים אחרים

  • ניהול משופר של תוכניות ומשתמשים: תוכניות כמו מודעות שופינג וכרטיסי מוצר חינמיים מקובצות במשאב program יחיד. המשאב user כולל יכולות ניהול מקיפות עם הרשאות גישה מפורטות.
  • פרטי עסק ומזהה עסק מובְנים: יש משאבים ייעודיים לbusinessInfo ולbusinessIdentity. הם כוללים תמיכה בתאימות עם שדות לנתונים ספציפיים לאזור. לדוגמה, מספר רישום עסק בקוריאה.
  • תהליך פשוט יותר ליצירת תלונה על הפרת זכויות יוצרים בדף הבית: משאב ייעודי homepage מנהל את כתובת ה-URL של דף הבית של החנות. שיטות כמו claim ו-unclaim מטפלות בהצהרת בעלות על אתר ישירות דרך ה-API.
  • תאימות להנחיות של Google API: Merchant API נועד להתאים להצעות של Google לשיפור ה-API.

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

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

בדף הזה מוסבר איך להעביר את ניהול החשבון מ-Content API ל-Merchant API.

בקשות

צריך להשתמש בפורמט הבא של כתובת ה-URL של הבקשה ל-Merchant Accounts API:

https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/accounts

בהמשך מופיעה השוואה לדוגמה בין Content API for Shopping לבין Merchant Accounts API לבקשות של יצירת חשבון וניהול חשבון:

  Content API for Shopping Merchant Accounts API
כתובת URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/ https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}
מזהים merchantId,accountId ‎``name‎

משאבים

נתוני החשבון מועברים באמצעות המשאב Account ב-Content API for Shopping. ב-Merchant Accounts API יש כמה משאבים להעברת נתוני חשבונות. המשאבים האלה כוללים את המשאבים Account,‏ User,‏ BusinessInfo ו-BusinessIdentity.

בטבלה הבאה מופיע השוואה בין המשאב Account ב-Content API for Shopping לבין המשאב Account ב-Merchant Accounts API.

Content API for Shopping Merchant Accounts API
id name
name accountName
kind לא זמין
websiteUrl השדה uri במשאב Homepage
adultContent adultContent
sellerId השדה accountIdAlias במשאב AccountRelationship
users במשאב User
youtubeChannelLinks הנתונים עדיין אינם זמינים
googleMyBusinessLink הנתונים עדיין אינם זמינים
businessInformation במשאב businessInfo
businessIdentity במשאב businessIdentity
automaticImprovements הנתונים עדיין אינם זמינים
adsLinks השדה campaignsManagement במשאב AccountService
cssId זמין רק ב-CSS API
labelIds זמין רק ב-CSS API
accountManagement השדה accountManagement במשאב AccountService
automaticLabelIds זמין רק ב-CSS API
conversionSettings הנתונים עדיין אינם זמינים

בטבלה הבאה מופיע השוואה בין המשאב AccountUser ב-Content API for Shopping לבין המשאב User ב-Merchant Accounts API.

Content API for Shopping Merchant Accounts API
emailAddress כתובת האימייל היא חלק מ-name (accounts/{account}/users/{email}).
admin user#accessRights.ADMIN
orderManager לא זמין
paymentsManager לא זמין
paymentsAnalyst לא זמין
reportingManager user#accessRights.PERFORMANCE_REPORTING

בטבלה הבאה מופיע השוואה בין המשאב AccountBusinessInformation ב-Content API for Shopping לבין המשאב המקביל businessInfo ב-Merchant Accounts API.

Content API for Shopping Merchant Accounts API
address address
phoneNumber phone
phoneVerificationStatus phoneVerificationState
customerService customerService
koreanBusinessRegistrationNumber koreanBusinessRegistrationNumber

בטבלה הבאה מופיעה השוואה בין המשאב AccountBusinessIdentity ב-Content API for Shopping לבין המשאב businessIdentity ב-Merchant Accounts API.

Content API for Shopping Merchant Accounts API
blackOwned blackOwned
womenOwned womenOwned
veteranOwned veteranOwned
latinoOwned latinoOwned
smallBusiness smallBusiness
includeForPromotions promotionsConsent
- true מציין PROMOTION_CONSENT_GIVEN
- false מציין PROMOTION_CONSENT_DENIED

המשאב AccountIdentityType ב-Content API מיוצג על ידי הסוג IdentityAttribute והשדה identityDeclaration שלו ב-MerchantAPI.

Content API for Shopping Merchant Accounts API
self_identified identityDeclaration
- true מציין SELF_IDENTIFIES_AS
- false מציין DOES_NOT_SELF_IDENTIFY_AS

Methods

השיטות הבאות נוספו ל-Merchant Accounts API:

Content API for Shopping Merchant Accounts API
accounts.authinfo GET https://merchantapi.googleapis.com/accounts/v1beta/accounts ללא מסנן
accounts.claimwebsite POST https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/homepage:claim מידע נוסף זמין במאמר שיטה: accounts.v1beta.accounts.homepage.claim
accounts.custombatch לא זמין. אין תמיכה בקבוצות של בקשות בהתאמה אישית ב-Merchant API.
accounts.delete DELETE https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}
accounts.get GET https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}‎
accounts.insert POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure מידע נוסף זמין במאמר יצירה והגדרה של חשבון מוכר
accounts.link המשאב AccountService
accounts.list GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}:listSubaccounts
accounts.listlinks GET https://merchantapi.googleapis.com/accounts/v1beta/{parent=accounts/*}/services
accounts.requestphoneverification לא נתמכת.
accounts.update ממופים לבקשת עדכון של המשאב שבו מוגדר השדה או קבוצת השדות הנדרשים.
accounts.updatelabels זמין רק ב-CSS API
accounts.verifyphonenumber לא נתמכת.
הקודם
סקירה כללית
הבא
העברה של ניהול מלאי שטחי הפרסום