דף זה תורגם על ידי Cloud Translation API.

העברת ניהול החשבון מ-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:

POST 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/accounts/`accountId
מזהים	merchantId`/accounts/`accountId	`accounts/`accountId

משאבים

נתוני החשבון מועברים באמצעות המשאב 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](/merchant/api/reference/rest/v1/accounts.v1beta.accounts.users)`
`youtubeChannelLinks`	הנתונים עדיין אינם זמינים
`googleMyBusinessLink`	הנתונים עדיין אינם זמינים
`businessInformation`	במשאב `[businessInfo](/merchant/api/reference/rest/v1/BusinessInfo)`
`businessIdentity`	במשאב `[businessIdentity](/merchant/api/reference/rest/v1/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
`businessInformation`	`businessInfo`
`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/accounts/`accountId`/homepage:claim`
	מידע נוסף זמין במאמר שיטה: accounts.v1beta.accounts.homepage.claim
`accounts.custombatch`	לא זמין. אי אפשר להשתמש בקבוצות של בקשות בהתאמה אישית ב-Merchant API.
`accounts.delete`	`DELETE https://merchantapi.googleapis.com/accounts/v1beta/accounts/`accountId
`accounts.get`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId‎
`accounts.insert`	`POST https://merchantapi.googleapis.com/accounts/v1beta/accounts:createAndConfigure`
	למידע נוסף, ראו יצירה והגדרה של חשבון מוכר
`accounts.link`	המשאב `AccountService`
`accounts.list`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`:listSubaccounts`
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`accountId`/services`
`accounts.update`	ממופים לבקשת עדכון של המשאב שבו מוגדר השדה הנדרש או קבוצת השדות הנדרשת.

סקירה כללית

העברה של ניהול מלאי שטחי הפרסום