खाता लिंक करने की सुविधा माइग्रेट करना

खाते के संबंधों को मैनेज करने का तरीका, Content API for Shopping में मौजूद link तरीके से बदलकर, Merchant API में ज़्यादा बारीकी से और साफ़ तौर पर काम करने वाले सिस्टम में बदल गया है. नया एपीआई, AccountRelationship और AccountService जैसे खास संसाधनों का इस्तेमाल करता है. इससे यह तय किया जाता है कि एक खाता, दूसरे खाते को कौनसी सेवाएं देता है. ज़्यादा जानकारी के लिए, खातों के बीच संबंध लेख पढ़ें.

मुख्य अंतर

  • रिश्तों और सेवाओं के लिए खास संसाधन: Merchant API में, AccountRelationship संसाधन, सेवा देने वाली कंपनी और कारोबारी या कंपनी के बीच के कनेक्शन के बारे में बताता है. वहीं, AccountService संसाधन, दी जा रही सेवा के बारे में सटीक जानकारी देता है. उदाहरण के लिए, accountAggregation. यह Content API for Shopping के सामान्य linkType और services फ़ील्ड की जगह लेता है.
  • कार्रवाई के तरीके: Merchant API, सेवाओं को मैनेज करने के लिए अलग-अलग तरीकों का इस्तेमाल करता है. जैसे, propose, approve, और reject. इसके बजाय, यह action पैरामीटर के साथ एक ही link तरीके का इस्तेमाल करता है.
  • Google Business Profile को लिंक करने की सुविधा: Google Business Profile को लिंक करने की सुविधा अब gbpAccounts.linkGbpAccount के तौर पर उपलब्ध है. पहले, इसे googleMyBusinessLink फ़ील्ड सेट करके मैनेज किया जाता था.
  • सेवा के तौर पर क्लाइंट खाता बनाना: ऐडवांस खाते के तहत क्लाइंट खाता बनाने को अब accounts.createAndConfigure तरीके का इस्तेमाल करके, accountAggregation सेवा का सुझाव देने के तौर पर माना जाता है. खातों के बारे में ज़्यादा जानकारी, Merchant Accounts API पेज पर उपलब्ध है. उपयोगकर्ता के पास ऐडवांस खाते और क्लाइंट खाते, दोनों का ऐक्सेस है. इसलिए, हैंडशेक करने की ज़रूरत नहीं है.

अनुरोध

Merchant API, अलग-अलग तरह के खाते लिंक करने और सेवाओं को मैनेज करने के लिए खास एंडपॉइंट उपलब्ध कराता है:

Merchant API के अनुरोध वाले यूआरएल

  • नई सेवा का सुझाव दें: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • किसी सेवा को अनुमति देना: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • किसी सेवा को अस्वीकार करना: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Google Business Profile से लिंक करना: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • क्लाइंट खाता बनाएं (खाता एग्रीगेशन लिंक): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

यूआरएल की तुलना करने का अनुरोध करना

अनुरोध का ब्यौरा Shopping के लिए Content API Merchant API
खाते लिंक करना (उदाहरण के लिए, तीसरे पक्ष के प्लैटफ़ॉर्म) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Google Business Profile से लिंक करना PUT .../v2.1/{merchantId}/accounts/{accountId} (googleMyBusinessLink फ़ील्ड के साथ) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
क्लाइंट खाता बनाएं POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

तरीके

Content API for Shopping का तरीका Merchant API का तरीका उपलब्धता और नोट
accounts.link accountServices.propose किसी दूसरे खाते से नई सेवा शुरू करने के लिए, इस तरीके का इस्तेमाल करें.
accounts.link (action: "approve" के साथ) accountServices.approve सेवा के किसी ऐसे प्रस्ताव को स्वीकार करने के लिए इस तरीके का इस्तेमाल करें जिसे स्वीकार करना बाकी है.
accounts.link (action: "remove" के साथ) accountServices.reject इस तरीके का इस्तेमाल, किसी सेवा के अनुरोध को अस्वीकार करने के लिए करें.
accounts.insert (क्लाइंट खातों के लिए) accounts.createAndConfigure इस तरीके का इस्तेमाल, accountAggregation सेवा के साथ करके किसी ऐडवांस खाते के तहत नया क्लाइंट खाता बनाया जा सकता है.
accounts.update (googleMyBusinessLink के साथ) gbpAccounts.linkGbpAccount Merchant Center खाते को Google Business Profile से लिंक करने के लिए, इस तरीके का इस्तेमाल करें.
accounts.update (adsLinks के साथ) AccountRelationship संसाधन Google Ads से लिंक करने की सुविधा, Google Ads खाते के यूज़र इंटरफ़ेस (यूआई) से मैनेज की जाती है. नतीजे के तौर पर मिले लिंक को Merchant API में AccountRelationship के तौर पर दिखाया जाता है. इसे देखा जा सकता है, लेकिन सीधे तौर पर नहीं बनाया जा सकता.

फ़ील्ड में किए गए बदलावों की पूरी जानकारी

Shopping के लिए Content API Merchant API ब्यौरा
AccountsLinkRequest.action propose, approve, reject तरीके सिंगल action फ़ील्ड को, सेवा के लाइफ़साइकल में हर स्थिति के बदलाव के लिए, एपीआई के खास तरीकों से बदल दिया जाता है.
AccountsLinkRequest.linkType AccountService.service_type सामान्य linkType स्ट्रिंग को AccountService संसाधन में मौजूद स्ट्रक्चर्ड service_type oneof फ़ील्ड से बदल दिया जाता है. जैसे, productsManagement या accountAggregation
AccountsLinkRequest.services AccountService.service_type स्ट्रिंग पर आधारित सेवाओं की सूची को अब AccountService रिसॉर्स में चुनी गई खास service_type के तौर पर दिखाया जाता है.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider सेवा देने वाले खाते का आईडी अब propose अनुरोध के provider फ़ील्ड में दिया गया है.
Account.googleMyBusinessLink LinkGbpAccountRequest GBP लिंक करने की जानकारी देने वाले ऑब्जेक्ट को linkGbpAccount तरीके के लिए, अनुरोध के खास मैसेज से बदल दिया जाता है.
Account.adsLinks AccountRelationship Google Ads लिंक को AccountRelationship संसाधन के तौर पर दिखाया जाता है. इसमें provider, providers/GOOGLE_ADS होता है. आम तौर पर, इस संबंध को Google Ads के यूज़र इंटरफ़ेस (यूआई) से मैनेज किया जाता है.