Merchant Account API के प्रॉडक्ट की जानकारी

26 अक्टूबर, 2026 का हफ़्ता

  • accounts.homepage.unclaim तरीके और Homepage संसाधन के claimed फ़ील्ड के दस्तावेज़ को साफ़ तौर पर समझाया गया. अगर किसी खाते को अपने ऐडवांस खाते से होम पेज पर दावा करने की सुविधा मिलती है, तो unclaim एक सफल जवाब दिखाता है. हालांकि, होम पेज पर दावा बना रहता है. अगर खाते को ही दावा करने से छूट मिली है, तो unclaim, FAILED_PRECONDITION गड़बड़ी दिखाता है.

28 सितंबर, 2026 का हफ़्ता

  • v1alpha में AccountService संसाधन में, सेवा के टाइप के तौर पर youtube_affiliate_management को जोड़ा गया. ध्यान दें: YouTube Affiliate Management सुविधा का ऐक्सेस सीमित है.

  • LoyaltyPrograms सेवा का ऐल्फ़ा लॉन्च. इसका इस्तेमाल करके, लॉयल्टी प्रोग्राम मैनेज किए जा सकते हैं. यह सुविधा सिर्फ़ चुनिंदा कारोबारियों या कंपनियों के लिए उपलब्ध है. ज़्यादा जानकारी के लिए, लॉयल्टी प्रोग्राम के बारे में खास जानकारी देखें.

  • accounts रिसॉर्स में, रीड-ओनली home_page_uri फ़ील्ड जोड़ा गया है, ताकि स्टोर के होम पेज का यूआरआई दिखाया जा सके.

3 अगस्त, 2026 का हफ़्ता

  • खाते की सेवा के संसाधन में, सेवा के टाइप के तौर पर 'ucp_checkout_management' को जोड़ा गया. ध्यान दें: यूसीपी चेकआउट की सुविधा का ऐक्सेस सीमित है.
  • 'ucp-integration' प्रोग्राम के लिए सहायता जोड़ी गई (सीमित ऐक्सेस).
  • सेवा की शर्तों के 'ucp_integration' टाइप के लिए सहायता जोड़ी गई.

29 जून, 2026 का हफ़्ता

20 अप्रैल, 2026 का हफ़्ता

  • accounts.programs संसाधन के ब्यौरे में, उपलब्ध प्रोग्राम के नामों की सूची में youtube-affiliate को जोड़ा गया.
  • YouTube Shopping Affiliate के लिए प्रोग्राम एपीआई चालू करें. भरोसेमंद टेस्टर के लिए उपलब्ध है.

6 अप्रैल, 2026 वाला हफ़्ता

  • मंज़ूरी की स्थिति में WAITING स्थिति जोड़ी गई. कंपैरिज़न शॉपिंग सर्विस (सीएसएस) के लिए, WAITING एक ट्रांज़िशनल स्टेट है. यह PENDING और ESTABLISHED के बीच की स्थिति है. इसका इस्तेमाल तब किया जाता है, जब ओरिजनल सीएसएस को खाते को नई सीएसएस में पूरी तरह से ट्रांसफ़र करने से पहले, ज़रूरी क्लीनअप करने के लिए समय चाहिए होता है.

16 मार्च, 2026 वाला हफ़्ता

  • Accounts API में CreateTestAccount तरीका लॉन्च किया गया. इससे डेवलपर, प्रोग्राम के हिसाब से खास टेस्ट खाते बना सकते हैं. ये खाते, सैंडबॉक्स जैसे अलग एनवायरमेंट में काम करते हैं. इससे इंटिग्रेशन को डेवलप और टेस्ट करने के लिए सुरक्षित जगह मिलती है.

17 नवंबर, 2025 का हफ़्ता

  • CreateAndConfigureAccountRequest अब नई सेवाएं ऑफ़र करता है. इन्हें खाता सेट-अप करने के दौरान कॉन्फ़िगर किया जा सकता है. AccountAggregation, AccountManagement, और ComparisonShopping में से किसी एक की जानकारी देना ज़रूरी है. इसके अलावा, ProductsManagement और CampaignsManagement सेवाओं की संख्या को अपनी पसंद के मुताबिक तय किया जा सकता है. हालांकि, ऐसी दो सेवाएं नहीं होनी चाहिए जिनके लिए सेवा देने वाली कंपनी और बाहरी खाते का आईडी एक ही हो.

  • AccountsService.CreateAndConfigure तरीके में अब एक सेटिंग उपलब्ध है. इसकी मदद से, यह कंट्रोल किया जा सकता है कि पुष्टि करने के लिए ईमेल भेजा जाए या नहीं.

  • CreateAndConfigureAccountRequest.AddAccountService में अब external_account_id फ़ील्ड है. यह फ़ील्ड, AccountService रिसॉर्स में पहले से मौजूद है. इसकी जानकारी CampaignsManagement और ProductsManagement सेवाओं के साथ दी जा सकती है.

  • AccountService संसाधन में ComparisonShopping सेवा जोड़ी गई. ज़्यादा जानकारी के लिए, https://support.google.com/merchants/answer/12653197 पर जाएं.

  • अब खाता बनाते समय, CreateAndConfigureAccountRequest में setAlias फ़ील्ड का इस्तेमाल करके, किसी संबंध के लिए कोई दूसरा नाम सेट किया जा सकता है.

  • UserService में VerifySelf तरीका जोड़ा गया है. इससे कॉल करने वाले उपयोगकर्ता को दिखाने वाले User संसाधन के लिए, स्थिति को PENDING से VERIFIED में अपडेट किया जा सकता है.

  • Regions API के Region पेलोड में नया radius_area फ़ील्ड लॉन्च करें. इससे कारोबारी या कंपनियां, रेडियस एरिया का इस्तेमाल करके क्षेत्र बना सकेंगी.

10 नवंबर, 2025 का हफ़्ता

  • Services API के लिए v1alpha वर्शन पब्लिश करें.
  • Services API के CampaignManagement पेलोड में नया product_filters फ़ील्ड लॉन्च करें. इससे कारोबारी या कंपनियां, Google Ads खातों के साथ अपने फ़ीड का सिर्फ़ एक सबसेट शेयर कर सकेंगी. यह सबसेट, कारोबारी या कंपनी के प्रॉडक्ट के एट्रिब्यूट पर, शर्त के हिसाब से फ़िल्टर करने पर आधारित होगा. यह सुविधा, अनुमति वाली सूची में शामिल कुछ ही कारोबारियों या कंपनियों के लिए उपलब्ध है.

25 अगस्त, 2025 का हफ़्ता

  • Regions API में बैच के नए तरीके जोड़े गए:
    • BatchCreateRegions: इससे एक ही अनुरोध में कई क्षेत्र बनाए जा सकते हैं.
    • BatchUpdateRegions: इससे एक ही अनुरोध में कई क्षेत्रों को अपडेट किया जा सकता है.
    • BatchDeleteRegions: एक ही अनुरोध में, नाम के हिसाब से कई क्षेत्रों को मिटाने की सुविधा देता है.

1 जुलाई, 2025 का हफ़्ता

  • CheckoutSettings रिसॉर्स लॉन्च किया गया है. इसकी मदद से, एपीआई का इस्तेमाल करने वाले लोग checkoutSettings को बना सकते हैं, अपडेट कर सकते हैं, मिटा सकते हैं, और पा सकते हैं.

26 मई, 2025 का हफ़्ता

  • अब खातों को capabilities के हिसाब से फ़िल्टर किया जा सकता है. फ़िलहाल, सिर्फ़ CAN_UPLOAD_PRODUCTS वैल्यू का इस्तेमाल किया जा सकता है. इस फ़िल्टर की मदद से, उन खातों को वापस लाया जा सकता है जो प्रॉडक्ट अपलोड कर सकते हैं. इसका मतलब है कि अब खाता लेवल पर इन क्लॉज़ का इस्तेमाल किया जा सकता है:

  • रीड-ओनली ऐक्सेस की सुविधा लॉन्च की गई. जिन उपयोगकर्ताओं के पास रीड-ओनली ऐक्सेस होता है वे कारोबारी या कंपनी का डेटा देख सकते हैं, लेकिन उसमें बदलाव नहीं कर सकते.

19 मई, 2025 वाला हफ़्ता

  • प्रोग्राम एपीआई के दस्तावेज़ को अपडेट किया गया. इसमें से वह गलत स्टेटमेंट हटाया गया जिसमें बताया गया था कि Enable/Disable तरीके सिर्फ़ एडमिन उपयोगकर्ताओं के लिए उपलब्ध हैं.

12 मई, 2025 का हफ़्ता

  • सामान लौटाने की ऑनलाइन नीति के संसाधन को लॉन्च किया गया. इससे एपीआई का इस्तेमाल करने वाले लोग, सामान लौटाने की नीतियां बना सकते हैं, उन्हें अपडेट कर सकते हैं, और मिटा सकते हैं.
  • OmnichannelSettingsService और OmnichannelSetting रिसॉर्स को लॉन्च किया गया है. इससे एपीआई का इस्तेमाल करने वाले लोग, कई तरीकों से खरीदारी की सुविधा को मैनेज कर सकते हैं.
  • LfpProvidersService और LfpProvider रिसॉर्स को लॉन्च किया गया. इससे एपीआई का इस्तेमाल करने वाले लोग, स्थानीय फ़ीड पार्टनरशिप की अपनी रिलेशनशिप को मैनेज कर सकते हैं.
  • GbpAccountsService और GbpAccount रिसॉर्स को लॉन्च किया गया है. इससे एपीआई का इस्तेमाल करने वाले लोग, अपनी Google Business Profile को मैनेज कर सकते हैं.
  • AccountService में LocalListingManagement सेवा टाइप लॉन्च करें. यह उस कारोबार समूह को लिंक करता है जिसका इस्तेमाल स्थानीय इन्वेंट्री विज्ञापनों या मुफ़्त में दिखाई जाने वाली स्थानीय लिस्टिंग के लिए किया जाता है.

28 अप्रैल, 2025 वाला हफ़्ता

  • AccountService और AccountRelationship संसाधनों को लॉन्च किया गया है. इनकी मदद से, एपीआई का इस्तेमाल करने वाले लोग, सेवा देने वाले व्यक्ति या कंपनी के साथ संबंध मैनेज कर सकते हैं और सेवाएं सेट अप कर सकते हैं.

14 अप्रैल, 2025 वाला हफ़्ता

  • TermsOfServiceService.AcceptTermsOfService अब वह TermsOfServiceAgremeentState दिखाता है जिसे रिस्पॉन्स टाइप में रैप करके स्वीकार किया गया था.

  • TermsOfServiceService.AcceptTermsOfService कार्रवाई की वर्ब अब POST है. पहले यह GET थी.

  • यह साफ़ तौर पर बताया गया है कि AccountsService.ListSubAccounts को accounts/... फ़ॉर्मैट का इस्तेमाल करके कॉल करना ज़रूरी है, न कि providers/... का इस्तेमाल करके. ऐसा इसलिए किया गया है, ताकि यह तरीका accounts के स्कोप से बाहर न हो जाए. इसका मतलब है कि GET providers/123:listSubAccounts के बजाय GET accounts/123:listSubAccounts का इस्तेमाल करें.

31 मार्च, 2025 का हफ़्ता

  • खातों को फ़िल्टर करने के लिए, externalAccountId फ़िल्टर को 2 दिसंबर, 2024 के हफ़्ते में बंद कर दिया गया था. अब यह उपलब्ध नहीं है. इसका मतलब है कि externalAccountId के हिसाब से फ़िल्टर करने की सुविधा, अब सिर्फ़ service लेवल पर उपलब्ध है. relationship(externalAccountId = "foo") जैसा फ़िल्टर अब काम नहीं करेगा. इसे relationship(service(externalAccountId = "foo")) के तौर पर दिखाना होगा.

  • AccountsService के दस्तावेज़ में यह साफ़ तौर पर बताया गया है कि स्टैंडअलोन खाते नहीं बनाए जा सकते.

3 मार्च, 2025 वाला हफ़्ता

-accounts.onlineReturnPolicies#SeasonalOverride को फिर से तैयार किया गया है, ताकि इसे आसानी से समझा जा सके और यह एक जैसा दिखे. इन अपडेट में ये शामिल हैं:

  • फ़ील्ड का नाम बदलना:
    • begin अब start_date है.
    • end अब end_date है.
  • फ़ील्ड हटाना:
    • इस्तेमाल से बाहर हो चुके policy फ़ील्ड को हटा दिया गया है.

-डेवलपर को अपने कोड अपडेट करने चाहिए, ताकि ये बदलाव दिखें.

AutomaticImprovements सेवा लॉन्च की गई है. इसका इस्तेमाल करके, इन्हें मैनेज किया जा सकता है:

ज़्यादा जानकारी के लिए, अपने-आप होने वाले सुधारों की सुविधा चालू करना लेख पढ़ें.

17 फ़रवरी, 2025 का हफ़्ता

खाते के फ़िल्टर से callerHasAccessToProviderFilter() प्रेडिकेट को हटाया गया.

10 फ़रवरी, 2025 का हफ़्ता

  • AccountsService.List तरीके के लिए बेहतर दस्तावेज़. यह उन सभी खातों की जानकारी दिखाता है जिनका ऐक्सेस उपयोगकर्ता के पास है. इसमें स्टैंडअलोन खाते भी शामिल हैं.

  • सभी आरपीसी तरीकों के लिए, 10 मिनट की डिफ़ॉल्ट समयसीमा जोड़ी गई.

  • accounts.programs रिसॉर्स के ब्यौरे में, उपलब्ध प्रोग्राम के नामों की सूची जोड़ी गई.

  • User.accessRights अब REQUIRED है. इससे UserService.Create और AccountsService.CreateAndConfigure, दोनों तरीकों पर असर पड़ रहा है.

27 जनवरी, 2025 वाला हफ़्ता

AccountsService.ListAccounts (और ट्रांज़िटिव तौर पर AccountsService.ListSubAccounts) अब खातों को संभावित अनुकूलता के तरीके से दिखाते हैं, न कि स्ट्रॉन्ग रीड के तरीके से.

20 जनवरी, 2025 वाला हफ़्ता

CreateAndConfigureAccountRequest के users फ़ील्ड को अब इस्तेमाल नहीं किया जा सकता. इसकी जगह, नए user का इस्तेमाल करें. रेफ़रंस के तौर पर दिए गए CreateUserRequest में parent फ़ील्ड मौजूद है. हालांकि, CreateAndConfigureAccountRequest के संदर्भ में इसकी ज़रूरत नहीं है.

6 जनवरी, 2025 का हफ़्ता

CreateUserRequest मैसेज के user फ़ील्ड को अब OPTIONAL के तौर पर मार्क किया गया है.

गड़बड़ियों के बारे में जानकारी देने वाले फ़ील्ड domain में, अब global के बजाय merchantapi.googleapis.com की जानकारी भरी जाती है

2 दिसंबर, 2024 का हफ़्ता

खातों को फ़िल्टर करने के लिए, externalAccountId प्रेडिकेट को relationship लेवल से service लेवल पर ले जाया गया है. इसलिए, अब फ़िल्टर relationship(externalAccountId = "foo") को relationship(service(externalAccountId = "foo")) के तौर पर लिखना होगा. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, पुराने फ़ॉर्मैट का इस्तेमाल अब भी किया जा सकता है. हालांकि, इसे अब बंद कर दिया गया है और आने वाले समय में इसका इस्तेमाल करने पर गड़बड़ी का मैसेज दिखेगा. सभी दस्तावेज़ों में सिर्फ़ नए फ़ॉर्मैट का ज़िक्र किया जाएगा.

18 नवंबर, 2024 का हफ़्ता

CreateAndConfigureAccountRequest.service.provider फ़ील्ड में मौजूद सेवा देने वाली कंपनी, अब providers/GOOGLE_ADS या providers/GOOGLE_BUSINESS_PROFILE में से कोई एक हो सकती है. अन्य खातों को providers/123 के तौर पर रेफ़र किया जाना चाहिए, न कि accounts/123 के तौर पर. इसका मतलब है कि फ़ील्ड को अब खाते के रेफ़रंस के तौर पर एनोटेट नहीं किया गया है. हालांकि, पुराने सिस्टम के साथ काम करने की सुविधा के लिए, अब भी accounts/123 जैसे खाते के नामों का इस्तेमाल किया जा सकता है.

ListSubAccountsRequest में मौजूद प्रोवाइडर अब providers/123 फ़ॉर्मैट में होना चाहिए. हालांकि, पुराने सिस्टम के साथ काम करने की सुविधा के लिए, अब भी accounts/123 का इस्तेमाल किया जा सकेगा.

4 नवंबर, 2024 का हफ़्ता

BusinessIdentity संसाधन में, promotions_consent REQUIRED (OPTIONAL से) को मार्क करें. इससे सिर्फ़ अपडेट करने के तरीके पर असर पड़ता है. हम आपको बताना चाहते हैं कि promotions_consent को UNSPECIFIED में अपडेट नहीं किया जा सकता. यह पहले भी संभव नहीं था, लेकिन अब गड़बड़ी के बारे में ज़्यादा जानकारी दी गई है और फ़ील्ड के बारे में सही जानकारी दी गई है.

28 अक्टूबर, 2024 का हफ़्ता

Accounts sub-API के अलग-अलग संसाधनों के दस्तावेज़ को बेहतर बनाना. जैसे, User, Homepage, BusinessInfo वगैरह.

21 अक्टूबर, 2024 का हफ़्ता

अपडेट के अनुरोधों में update_mask फ़ील्ड के दस्तावेज़ को बेहतर बनाना, ताकि खास तौर पर यह बताया जा सके कि किन फ़ील्ड को अपडेट किया जा सकता है.

ShippingSettings संसाधन के बाहरी दस्तावेज़ में, Google Business के सहायता केंद्र का लिंक जोड़ा गया. इस लिंक पर, इस्तेमाल की जा सकने वाली कैरियर सेवाओं की जानकारी दी गई है

14 अक्टूबर, 2024 का हफ़्ता

AccountsService.CreateAndConfigureAccountRequest.AddAccountService में provider को REQUIRED के तौर पर मार्क करें.

Accounts sub-API में update_mask को ज़रूरी न बनाएं. जैसे, कारोबार की पहचान, कारोबार की जानकारी, होम पेज वगैरह. साथ ही, ConversionSources रिसॉर्स के लिए, इसे पहले से लागू करें.

ClaimHomepageRequest में overwrite पैरामीटर जोड़ा गया.

30 सितंबर, 2024 का हफ़्ता

'Accounts.delete' तरीके के लिए, 'force' पैरामीटर लॉन्च किया गया.

23 सितंबर, 2024 का हफ़्ता

RetrieveLatestTermsOfServiceRequest में region_code और kind को REQUIRED के तौर पर मार्क करें.

16 सितंबर, 2024 का हफ़्ता

ListAccountIssuesRequest में time_zone पैरामीटर के टाइप को बदलकर स्ट्रिंग किया गया

12 अगस्त, 2024 का हफ़्ता

BusinessInfo रिसॉर्स में korean_business_registration_number फ़ील्ड जोड़ा गया.

27 मई, 2024 का हफ़्ता

Accounts sub-API का बीटा वर्शन लॉन्च किया गया