Google Ads API Explorer, एक इंटरैक्टिव एक्ज़ीक्यूशन एनवायरमेंट है. इसकी मदद से, सीधे अपने ब्राउज़र से लाइव एपीआई अनुरोध बनाए और भेजे जा सकते हैं. रेफ़रंस दस्तावेज़ में एम्बेड किया गया यह टूल, OAuth 2.0 की पुष्टि करने और JSON पेलोड को फ़ॉर्मैट करने की जटिलताओं को मैनेज करता है. इससे आपको कोड की एक भी लाइन लिखे बिना, चुनिंदा सेवाओं और तरीकों को टेस्ट करने की सुविधा मिलती है.
फ़ायदे
- बिना कोडिंग के टेस्टिंग: लोकल डेवलपमेंट एनवायरमेंट सेट अप किए बिना, सीधे दस्तावेज़ से लाइव एपीआई कॉल (रीड और राइट, दोनों) करें.
- प्रोटोकॉल डिस्कवरी: एपीआई के काम करने के तरीके को समझने के लिए, एचटीटीपी अनुरोधों और रिस्पॉन्स का सटीक स्ट्रक्चर देखें.
- आसान प्रोटोटाइपिंग: अपने ऐप्लिकेशन में लॉजिक लागू करने से पहले, एंडपॉइंट के काम करने के तरीके की पुष्टि करें और एपीआई से मिले रॉ डेटा की तुरंत जांच करें.
- पुष्टि करने की आसान प्रोसेस: यह टूल, OAuth 2.0 फ़्लो को अपने-आप मैनेज करता है. इससे आपको क्रेडेंशियल मैनेज करने के बजाय, एपीआई अनुरोध पर ध्यान देने में मदद मिलती है.
अपनी प्रोफ़ाइल बनाना शुरू करें
- दस्तावेज़ पर जाएं: रेफ़रंस दस्तावेज़ पर जाएं. इसके बाद, वह सेवा और तरीका चुनें जिसकी आपको जांच करनी है. जैसे,
GoogleAdsService/Search. - एक्सप्लोरर खोलें: पेज की दाईं ओर मौजूद, यह तरीका आज़माएं पैनल देखें.
- अनुरोध को कॉन्फ़िगर करें:
- ज़रूरी अनुरोध पैरामीटर डालें, जैसे कि
customerId. इसके बाद, हेडर को बड़ा करके, वैकल्पिक एचटीटीपी हेडर दें, जैसे किlogin-customer-id. इसकी ज़रूरत सिर्फ़ तब होती है, जब किसी खाते को मैनेजर खाते से ऐक्सेस किया जा रहा हो. ध्यान दें कि डेवलपर टोकन (developer-token) 9 सितंबर, 2026 को बंद कर दिए गए थे. साथ ही, एपीआई सर्वर इन्हें अनदेखा कर देते हैं. हालांकि, अगर फ़ॉर्म में कहा जाए, तो अब भी वैल्यू डाली जा सकती है. - अगर तरीके के लिए पेलोड की ज़रूरत है, तो इंटरैक्टिव JSON एडिटर का इस्तेमाल करके अनुरोध का मुख्य हिस्सा तय करें. जैसे,
searchयाmutateकार्रवाइयों के लिए.
- ज़रूरी अनुरोध पैरामीटर डालें, जैसे कि
- Execute: अनुरोध भेजने के लिए, Execute पर क्लिक करें. यह टूल, एपीआई से मिला पूरा एचटीटीपी अनुरोध और लाइव JSON रिस्पॉन्स दिखाता है.
मुख्य सुविधाएं
- लाइव एक्ज़ीक्यूशन: अपने प्रोडक्शन या टेस्ट खातों के लिए, रीयल-टाइम में
searchऔरmutateऑपरेशन करें. - JSON पेलोड फ़ॉर्मैटिंग: अनुरोधों के लिए, इंटरैक्टिव तरीके से जटिल JSON ऑब्जेक्ट बनाएं. यह टूल, ज़रूरी फ़ील्ड और मान्य स्कीमा स्ट्रक्चर को हाइलाइट करता है.
- फ़ील्ड मास्क:
update_maskलॉजिक की जांच करें, ताकि यह देखा जा सके कि रिसॉर्स के कुछ हिस्से को अपडेट करने पर, वह असल में कैसे काम करता है. - गड़बड़ी की जांच: रॉ रिस्पॉन्स में गड़बड़ी के मैसेज और कोड (जैसे,
QUERY_ERRORयाAUTHENTICATION_ERROR) की पूरी जानकारी देखें, ताकि गड़बड़ी को तेज़ी से ठीक किया जा सके. - कोड एक्सपोर्ट करना: एपीआई एक्सप्लोरर के बड़े किए गए व्यू से,
curlकमांड, रॉ एचटीटीपी अनुरोध या JavaScript कोड का सैंपल एक्सपोर्ट करें.
इस्तेमाल के उदाहरण
- खाते की सेटिंग की जांच करना:
customerरिसॉर्स के लिएGoogleAdsService/Searchअनुरोध करके, खाता-लेवल के कॉन्फ़िगरेशन या मेटाडेटा को तुरंत वापस पाएं. - म्यूटेशन की जांच करना: कोड को प्रोडक्शन में डिप्लॉय करने से पहले, कैंपेन बनाने या बजट अपडेट करने की प्रोसेस की जांच करें.
- GAQL को डीबग करना: एक्सप्लोरर का इस्तेमाल करके, Google Ads क्वेरी लैंग्वेज (GAQL) स्ट्रिंग चलाएं. साथ ही, पुष्टि करें कि वापस किया गया JSON स्ट्रक्चर, आपके ऐप्लिकेशन की उम्मीदों के मुताबिक है.
- प्रोटोकॉल की पुष्टि करना: एपीआई के किसी खास वर्शन के लिए ज़रूरी एचटीटीपी हेडर और JSON नेस्टिंग की जांच करें.