דף זה תורגם על ידי 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 הוא המשאב ההורה של 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/{ACCOUNT_ID}/accounts

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

	Content API	Merchant API
כתובת URL	`https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accounts/{ACCOUNT_ID}`	`https://merchantapi.googleapis.com/accounts/v1beta/{NAME}`
מזהים	`{MERCHANT_ID}`, `{ACCOUNT_ID}`	`{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 ב-Merchant API.

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.get לא תומכת בפרמטר view**.
`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` אם אתם משתמשים ב-CSS, אתם יכולים להשתמש בשיטה ListChildAccounts כדי לקבל רשימה של כל החשבונות המשויכים לחשבון CSS מסוים.
`accounts.listlinks`	`GET https://merchantapi.googleapis.com/accounts/v1beta/`*{parent=accounts/}**`/services`
`accounts.requestphoneverification` (אין יותר תמיכה)	Merchant API לא תומך בשיטת אימות באמצעות טלפון.
`accounts.update`	המיפוי מתבצע לבקשת עדכון של המשאב שבו מוגדר השדה או קבוצת השדות הנדרשים.
`accounts.updatelabels`	זמין רק ב-CSS API
`accounts.verifyphonenumber`	לא נתמכת.

Overview

Migrate homepage management