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 Center खातों के एपीआई की खास जानकारी देखें.

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

अनुरोध

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

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/{name=accounts/*}
आइडेंटिफ़ायर merchantId,accountId ``name

संसाधन

खाते का डेटा, 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 संसाधन में
youtubeChannelLinks अभी तक उपलब्ध नहीं है
googleMyBusinessLink अभी तक उपलब्ध नहीं है
businessInformation businessInfo संसाधन में
businessIdentity 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
address address
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/{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 ज़्यादा जानकारी के लिए, Merchant Center खाता बनाना और कॉन्फ़िगर करना लेख पढ़ें
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 समर्थित नहीं.
पीछे जाएं
खास जानकारी
आगे बढ़ें
इन्वेंट्री मैनेजमेंट माइग्रेट करें