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