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

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 में अपडेट किया जा सकता है.

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 वैल्यू का इस्तेमाल किया जा सकता है. इस फ़िल्टर की मदद से, उन खातों को वापस पाया जा सकता है जिनमें प्रॉडक्ट अपलोड किए जा सकते हैं. इसका मतलब है कि अब खाता लेवल पर इन शर्तों का इस्तेमाल किया जा सकता है:

  • capabilities:CAN_UPLOAD_PRODUCTS
  • -capabilities:CAN_UPLOAD_PRODUCTS
  • NOT capabilities:CAN_UPLOAD_PRODUCTS ज़्यादा जानकारी के लिए, फ़िल्टर करने से जुड़ी गाइड देखें.

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

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

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

12 मई, 2025 से शुरू होने वाला हफ़्ता

• सामान लौटाने की ऑनलाइन नीति से जुड़े संसाधन को लॉन्च किया गया है. इससे एपीआई का इस्तेमाल करने वाले लोग, सामान लौटाने की नीतियां बना सकते हैं, उन्हें अपडेट कर सकते हैं, और मिटा सकते हैं.
• OmnichannelSettingsService और OmnichannelSetting संसाधन लॉन्च किया गया है. इसकी मदद से, एपीआई का इस्तेमाल करने वाले लोग, कई तरीकों से खरीदारी की सुविधा को मैनेज कर सकते हैं.
• LfpProvidersService और LfpProvider संसाधन लॉन्च किया गया है. इससे एपीआई का इस्तेमाल करने वाले लोग, Local Feeds Partnership से जुड़े अपने रिश्ते को मैनेज कर सकते हैं.
• 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 accounts/123:listSubAccounts के बजाय GET providers/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 से शुरू होने वाला हफ़्ता

खाता सब-एपीआई के अलग-अलग संसाधनों के दस्तावेज़ को बेहतर बनाया गया है. जैसे, User, Homepage, BusinessInfo वगैरह.

21 अक्टूबर, 2024 से शुरू होने वाला हफ़्ता

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

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

14 अक्टूबर, 2024 से शुरू होने वाला हफ़्ता

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

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

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

30 सितंबर, 2024 से शुरू होने वाला हफ़्ता

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

23 सितंबर, 2024 से शुरू होने वाला हफ़्ता

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

16 सितंबर, 2024 से शुरू होने वाला हफ़्ता

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

12 अगस्त, 2024 से शुरू होने वाला हफ़्ता

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

27 मई, 2024 से शुरू होने वाला हफ़्ता

खातों के सब-एपीआई का बीटा वर्शन लॉन्च किया गया