Google Ads API Explorer

Google Ads API Explorer, एक इंटरैक्टिव एक्ज़ीक्यूशन एनवायरमेंट है. इसकी मदद से, सीधे अपने ब्राउज़र से लाइव एपीआई अनुरोध बनाए और भेजे जा सकते हैं. यह रेफ़रंस दस्तावेज़ में एम्बेड किया गया है. यह OAuth 2.0 की पुष्टि और JSON पेलोड फ़ॉर्मैटिंग की जटिलताओं को मैनेज करता है. इससे आपको कोड की एक भी लाइन लिखे बिना, कुछ खास सेवाओं और तरीकों को आज़माने की सुविधा मिलती है.

फ़ायदे

  • बिना कोडिंग के टेस्टिंग: लोकल डेवलपमेंट एनवायरमेंट सेट अप किए बिना, सीधे दस्तावेज़ से लाइव एपीआई कॉल (पढ़ने और लिखने, दोनों के लिए) एक्ज़ीक्यूट करें.
  • प्रोटोकॉल की जानकारी: एपीआई के काम करने के तरीके को समझने के लिए, एचटीटीपी अनुरोधों और जवाबों का सटीक स्ट्रक्चर देखें.
  • आसानी से प्रोटोटाइप बनाना: अपने ऐप्लिकेशन में लॉजिक लागू करने से पहले, एंडपॉइंट के व्यवहार की पुष्टि करें और एपीआई के रॉ रिस्पॉन्स की तुरंत जांच करें.
  • पुष्टि करने की आसान प्रोसेस: यह टूल, OAuth 2.0 फ़्लो को अपने-आप मैनेज करता है. इससे आपको क्रेडेंशियल मैनेज करने के बजाय, एपीआई अनुरोध पर ध्यान देने में मदद मिलती है.

शुरू करना

  1. दस्तावेज़ पर जाएं: रेफ़रंस दस्तावेज़ पर जाएं. इसके बाद, वह सेवा और तरीका चुनें जिसे आपको टेस्ट करना है. जैसे, GoogleAdsService/Search.
  2. एक्सप्लोरर खोलें: पेज की दाईं ओर मौजूद, "इसे आज़माएं!" पैनल ढूंढें.
  3. अनुरोध को कॉन्फ़िगर करें:
    • अनुरोध के ज़रूरी पैरामीटर डालें, जैसे कि developer-token और login-customer-id.
    • अगर तरीके के लिए पेलोड की ज़रूरत है, तो इंटरैक्टिव JSON एडिटर का इस्तेमाल करके अनुरोध का मुख्य हिस्सा तय करें. जैसे, `mutate` कार्रवाइयों के लिए.
  4. लागू करें: अनुरोध भेजने के लिए, लागू करें पर क्लिक करें. यह टूल, एपीआई से मिले पूरे एचटीटीपी अनुरोध और लाइव JSON रिस्पॉन्स को दिखाएगा.

मुख्य सुविधाएं

  • लाइव एक्ज़ीक्यूशन: अपने प्रोडक्शन या टेस्ट खातों के ख़िलाफ़, रीयल-टाइम में search और mutate कार्रवाइयां करें.
  • JSON पेलोड फ़ॉर्मैट करना: अनुरोधों के लिए, इंटरैक्टिव तरीके से जटिल JSON ऑब्जेक्ट बनाएं. इस टूल की मदद से, ज़रूरी फ़ील्ड और मान्य स्कीमा स्ट्रक्चर को हाइलाइट किया जाता है.
  • फ़ील्ड मास्क: update_mask लॉजिक की जांच करें. इससे आपको यह पता चलेगा कि संसाधन के कुछ हिस्से को अपडेट करने पर, क्या असर पड़ता है.
  • गड़बड़ी की जांच करना: गड़बड़ी के बारे में ज़्यादा जानकारी देने वाले मैसेज और कोड (जैसे कि QUERY_ERROR या AUTHENTICATION_ERROR) को रॉ रिस्पॉन्स में देखें, ताकि गड़बड़ी को तेज़ी से ठीक किया जा सके.
  • कोड एक्सपोर्ट करना: एपीआई एक्सप्लोरर की बड़ी की गई व्यू से curl कमांड, रॉ एचटीटीपी अनुरोध या सैंपल JavaScript कोड एक्सपोर्ट करें.

इस्तेमाल के उदाहरण

  • खाते की सेटिंग की जांच करना: get या search अनुरोध को पूरा करके, खाता लेवल के कॉन्फ़िगरेशन या मेटाडेटा को तुरंत वापस पाएं.
  • म्यूटेशन की जांच करना: कोड को प्रोडक्शन में डिप्लॉय करने से पहले, कैंपेन बनाने या बजट अपडेट करने की प्रोसेस के पूरा होने की पुष्टि करें.
  • GAQL को डीबग करना: एक्सप्लोरर का इस्तेमाल करके, Google Ads क्वेरी लैंग्वेज (GAQL) स्ट्रिंग चलाएं. साथ ही, पुष्टि करें कि लौटाया गया JSON स्ट्रक्चर, आपके ऐप्लिकेशन की उम्मीदों के मुताबिक है.
  • प्रोटोकॉल की पुष्टि करना: किसी खास एपीआई वर्शन के लिए ज़रूरी एचटीटीपी हेडर और JSON नेस्टिंग की जांच करें.