इस पेज का अनुवाद Cloud Translation API से किया गया है.

Content API for Shopping से खाते के मैनेजमेंट को माइग्रेट करना

इस दस्तावेज़ में बताया गया है कि Content API के वर्शन 2.1 से Merchant API पर कैसे माइग्रेट किया जा सकता है.

Content API के वर्शन 2.1 से Merchant API में हुए बदलावों की खास जानकारी

Merchant API, Content API के 2.1 वर्शन के मुकाबले काफ़ी बेहतर है. इसका मकसद, डेवलपर और कारोबारों के लिए, इस्तेमाल करने की सुविधा, एक जैसी सुविधाएं, और सुविधाओं में बदलाव करने की सुविधा को बेहतर बनाना है.

ज़्यादा जानकारी वाला रिसॉर्स स्ट्रक्चर

Merchant API में मौजूद संसाधन, एक ही कॉन्सेप्ट को दिखाते हैं. जैसे, account, businessDetails, user, homepage, और program. इनका क्रम, उनके बीच के संबंधों को दिखाने के लिए तय किया जाता है. उदाहरण के लिए, account, user के लिए पैरंट संसाधन है.

एक ही खाते से जुड़ी सेवाएं

खाते से जुड़ी सभी सेवाएं, एक ही accountService संसाधन के ज़रिए मैनेज की जाती हैं. उदाहरण के लिए, एमसीए और उनके उप-खातों के लिए खाता इकट्ठा करना या तीसरे पक्ष की सेवा देने वाली कंपनियों और खातों के बीच खाता इकट्ठा करना. सेवा देने वाली कंपनियां, accountRelationship संसाधन का इस्तेमाल करके अपने संबंध मैनेज कर सकती हैं.

यूआरएल का आसान स्ट्रक्चर

यूआरएल अब एक से ज़्यादा आईडी के बजाय, एक ही खाता आईडी (उदाहरण के लिए, merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}) का इस्तेमाल करते हैं. यूआरएल पाथ, ज़्यादा जानकारी वाले संसाधन के स्ट्रक्चर को दिखाते हैं.

अन्य सुधार

बेहतर प्रोग्राम और उपयोगकर्ता मैनेजमेंट: शॉपिंग विज्ञापनों और मुफ़्त में दिखाई जाने वाली लिस्टिंग जैसे प्रोग्राम को एक ही program संसाधन के तहत इकट्ठा किया जाता है. user रिसोर्स में, ऐक्सेस से जुड़ी ज़्यादा जानकारी के साथ मैनेजमेंट की बेहतर सुविधाएं शामिल हैं.
कारोबार की स्ट्रक्चर्ड जानकारी और कारोबार की पहचान: businessInfo और businessIdentity के लिए खास संसाधन उपलब्ध हैं. इनमें, देश/इलाके के हिसाब से डेटा के लिए फ़ील्ड के साथ, नियमों का पालन करने से जुड़ी सहायता शामिल होती है. उदाहरण के लिए, कोरिया में मौजूद कारोबार का रजिस्ट्रेशन नंबर.
होम पेज पर दावा करने की सुविधा को आसान बनाना: स्टोर के होम पेज के यूआरएल को एक खास homepage संसाधन मैनेज करता है. claim और unclaim जैसे तरीके, सीधे एपीआई के ज़रिए वेबसाइट पर दावा करने की सुविधा देते हैं.
Google API के दिशा-निर्देशों का पालन करना: Merchant API का मकसद, Google के एपीआई को बेहतर बनाने के प्रस्तावों के मुताबिक काम करना है.

खाता मैनेजमेंट को माइग्रेट करना

अपना व्यापारी/कंपनी खाता बनाने और मैनेज करने के लिए, accounts संसाधन का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, Merchant Accounts API के बारे में खास जानकारी देखें.

इस पेज पर, खाता मैनेजमेंट को Content API से Merchant API पर माइग्रेट करने का तरीका बताया गया है.

अनुरोध

Merchant Center खातों के लिए, अनुरोध यूआरएल के इस फ़ॉर्मैट का इस्तेमाल करें:

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

खाता बनाने और मैनेज करने के अनुरोधों के लिए, Content API for Shopping और Merchant Ac counts API की तुलना का सैंपल यहां दिया गया है:

	Shopping के लिए Content API	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

संसाधन

खाते का डेटा, Content API for Shopping में Account संसाधन का इस्तेमाल करके पास किया जाता है. Merchant Accounts API, खातों का डेटा पास करने के लिए कई संसाधन उपलब्ध कराता है. इनमें Account, User, BusinessInfo, और BusinessIdentity रिसॉर्स शामिल हैं.

यहां दी गई टेबल में, Content API for Shopping के Account संसाधन और Merchant Center API के Account संसाधन के बीच तुलना की गई है.

Shopping के लिए Content API	Merchant Accounts API
`id`	`name`
`name`	`accountName`
`kind`	उपलब्ध नहीं है
`websiteUrl`	`Homepage` संसाधन में मौजूद `uri` फ़ील्ड
`adultContent`	`adultContent`
`sellerId`	`AccountRelationship` संसाधन में मौजूद `accountIdAlias` फ़ील्ड
`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`	`AccountService` संसाधन में मौजूद `campaignsManagement` फ़ील्ड
`cssId`	सिर्फ़ CSS API में उपलब्ध है
`labelIds`	सिर्फ़ CSS API में उपलब्ध है
`accountManagement`	`AccountService` संसाधन में मौजूद `accountManagement` फ़ील्ड
`automaticLabelIds`	सिर्फ़ CSS API में उपलब्ध है
`conversionSettings`	अभी तक उपलब्ध नहीं है

नीचे दी गई टेबल में, Content API for Shopping के AccountUser संसाधन और Merchant Center API के User संसाधन की तुलना की गई है.

Shopping के लिए Content API	Merchant Accounts API
`emailAddress`	ईमेल, `name`(`accounts/{account}/users/{email}`) का हिस्सा है.
`admin`	`user#accessRights.ADMIN`
`orderManager`	उपलब्ध नहीं है
`paymentsManager`	उपलब्ध नहीं
`paymentsAnalyst`	उपलब्ध नहीं है
`reportingManager`	`user#accessRights.PERFORMANCE_REPORTING`

नीचे दी गई टेबल में, Content API for Shopping के AccountBusinessInformation संसाधन और Merchant Center खाते के एपीआई के businessInfo संसाधन के बीच तुलना की गई है.

Shopping के लिए Content API	Merchant Accounts API
`businessInformation`	`businessInfo`
`phoneNumber`	`phone`
`phoneVerificationStatus`	`phoneVerificationState`
`customerService`	`customerService`
`koreanBusinessRegistrationNumber`	`koreanBusinessRegistrationNumber`

यहां दी गई टेबल में, Content API for Shopping के AccountBusinessIdentity संसाधन और Merchant Center खाते के एपीआई के businessIdentity संसाधन के बीच की तुलना की गई है.

Shopping के लिए Content API	Merchant Accounts API
`blackOwned`	`blackOwned`
`womenOwned`	`womenOwned`
`veteranOwned`	`veteranOwned`
`latinoOwned`	`latinoOwned`
`smallBusiness`	`smallBusiness`
`includeForPromotions`	`promotionsConsent`
	- `true` का मतलब `PROMOTION_CONSENT_GIVEN` है
	- `false` का मतलब `PROMOTION_CONSENT_DENIED` है

Content API में मौजूद AccountIdentityType संसाधन को MerchantAPI में IdentityAttribute टाइप और उसके फ़ील्ड identityDeclaration से दिखाया जाता है.

Shopping के लिए Content API	Merchant Accounts API
`self_identified`	`identityDeclaration`
	- `true` का मतलब `SELF_IDENTIFIES_AS` है
	- `false` का मतलब `DOES_NOT_SELF_IDENTIFY_AS` है

तरीके

Merchant Center खातों के लिए उपलब्ध एपीआई में, ये तरीके जोड़े गए हैं:

Shopping के लिए Content API	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`	इस एट्रिब्यूट की वैल्यू, उस संसाधन के लिए अपडेट के अनुरोध से मैप होती है जहां ज़रूरी फ़ील्ड या फ़ील्ड का सेट तय किया गया है.

पीछे जाएं

खास जानकारी

आगे बढ़ें

इन्वेंट्री मैनेजमेंट माइग्रेट करें