Google Ads API Explorer

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

फ़ायदे

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

शुरू करें

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

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

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

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

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