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