Google Ads स्क्रिप्ट में मौजूद बेहतर एपीआई की मदद से, डेवलपर कुछ सार्वजनिक Google API से कनेक्ट हो सकते हैं. इसके लिए, उन्हें एचटीटीपी इंटरफ़ेस का इस्तेमाल करने के मुकाबले कम सेटअप करना पड़ता है. इन एपीआई का इस्तेमाल, स्क्रिप्ट की इन-बिल्ट सेवाओं की तरह किया जा सकता है. साथ ही, इनसे ऑटो-कंप्लीशन और अपने-आप अनुमति मिलने जैसी सुविधाएं मिलती हैं.
इन एपीआई का इस्तेमाल करने के तरीके के कुछ उदाहरण देखने के लिए, हमारे कोड स्निपेट वाले पेज पर जाएं.
उपलब्ध बेहतर एपीआई
- Google Analytics
- Google Analytics का इस्तेमाल करके, अपनी वेबसाइट पर आने वाले ट्रैफ़िक को ट्रैक किया जा सकता है. इसके बाद, कैंपेन की बोलियों को उसके हिसाब से अडजस्ट किया जा सकता है. Google Analytics प्रॉपर्टी को अपने Google Ads खाते से लिंक करने पर, आपको अपनी वेबसाइट पर ग्राहक की गतिविधि का विश्लेषण करने में भी मदद मिल सकती है. इस जानकारी से आपको पता चलता है कि आपकी वेबसाइट पर आने वाला कितना ट्रैफ़िक या बिक्री Google Ads से मिलती है. साथ ही, विज्ञापनों और वेबसाइट को बेहतर बनाने में भी मदद मिलती है. Analytics और Google Ads खातों को लिंक करने के बारे में ज़्यादा जानने के लिए, वेबसाइट और/या ऐप्लिकेशन के लिए Analytics सेट अप करना लेख पढ़ें. यह लेख, सहायता केंद्र के गाइड में मौजूद है.
- Google BigQuery
- Google Cloud Storage में बड़ी मात्रा में डेटा लोड किया जा सकता है. इसके बाद, Google BigQuery का इस्तेमाल करके उस डेटा के बारे में क्वेरी की जा सकती है. उदाहरण के लिए, पिछले 10 सालों का सार्वजनिक मौसम डेटा लोड किया जा सकता है. इसके बाद, किसी स्क्रिप्ट में किसी इलाके के औसत तापमान के बारे में क्वेरी की जा सकती है. यह स्क्रिप्ट, बोलियों को अडजस्ट करने के लिए उस जानकारी का इस्तेमाल करती है. इसका एक और इस्तेमाल यह हो सकता है कि कई सालों के दौरान, आपके खाते की परफ़ॉर्मेंस के डेटा का विश्लेषण किया जाए.
- Google Calendar
- आपकी स्क्रिप्ट, आने वाले समय में किए जाने वाले टास्क के लिए इवेंट बना सकती है. जैसे, आज से दो हफ़्ते बाद अपने कैंपेन की परफ़ॉर्मेंस रिपोर्ट जनरेट करना. इसके अलावा, स्क्रिप्ट, आपके कैलेंडर में बनाए गए किसी इवेंट के आधार पर कार्रवाइयां भी कर सकती है. जैसे, किसी खास तारीख को कोई कैंपेन चालू करना.
- Google Slides
- आपकी स्क्रिप्ट, कैंपेन की जानकारी या आंकड़ों को Google Slides पर एक्सपोर्ट कर सकती है. इससे, इस जानकारी को बेहतर फ़ॉर्मैट में पब्लिश किया जा सकता है.
- Google Tasks
- आपकी स्क्रिप्ट, आने वाले समय में किए जाने वाले टास्क के लिए रिमाइंडर की सूची बना सकती है. जैसे, आज से दो हफ़्ते बाद अपने कैंपेन की परफ़ॉर्मेंस रिपोर्ट जनरेट करना. इसके अलावा, स्क्रिप्ट, रिमाइंडर की सूची में बनाए गए किसी इवेंट के आधार पर कार्रवाइयां भी कर सकती है. जैसे, किसी खास तारीख को कोई कैंपेन चालू करना.
- Merchant API
- आपकी स्क्रिप्ट, Merchant API का इस्तेमाल करके, प्रॉडक्ट लिस्टिंग अपलोड और मैनेज कर सकती है. साथ ही, Google Merchant Center खातों को मैनेज कर सकती है. स्क्रिप्ट में, प्रॉडक्ट लिस्टिंग की जांच करने और खास प्रॉडक्ट को खास विज्ञापनों से लिंक करने के लिए, यह सुविधा काम की हो सकती है. Merchant API में सब-एपीआई होते हैं. इन्हें बेहतर एपीआई डायलॉग में अलग-अलग चालू किया जा सकता है. Google Merchant Center खाते को लिंक करने के बारे में ज़्यादा जानने के लिए, डेवलपर के तौर पर रजिस्टर करना लेख पढ़ें.
- Shopping Content
- आपकी स्क्रिप्ट, Google Content API for Shopping का इस्तेमाल करके, प्रॉडक्ट लिस्टिंग अपलोड और मैनेज कर सकती है. साथ ही, Google Merchant Center खातों को मैनेज कर सकती है. स्क्रिप्ट में, प्रॉडक्ट लिस्टिंग की जांच करने और खास प्रॉडक्ट को खास विज्ञापनों से लिंक करने के लिए, यह सुविधा काम की हो सकती है. ध्यान दें: Content API for Shopping, 18 अगस्त, 2026 को बंद हो जाएगा. इसके बजाय, Merchant API का इस्तेमाल करें. इसके बारे में, पिछले सेक्शन में बताया गया है.
- YouTube और YouTube Analytics
- बोलियां तय करने के लिए, अपने वीडियो, प्लेलिस्ट वगैरह को वापस पाया जा सकता है और अपडेट किया जा सकता है. साथ ही, अपने वीडियो की परफ़ॉर्मेंस का डेटा भी वापस पाया जा सकता है.
बेहतर एपीआई चालू करना
यह देखने के लिए कि कौनसे Google API, बेहतर एपीआई के तौर पर उपलब्ध हैं, एडिटर बार में सबसे ऊपर मौजूद बेहतर एपीआई बटन पर क्लिक करें.
इससे बेहतर एपीआई डायलॉग खुलता है. उन एपीआई को चुनें जिन्हें आपको चालू करना है.
इसके बाद, Google API Console लिंक पर क्लिक करें. इससे कंसोल में API Console पेज खुल जाएगा. इस पेज पर, आपकी स्क्रिप्ट से जुड़ा प्रोजेक्ट दिखेगा. अगर आपका प्रोजेक्ट पहले से नहीं चुना गया है, तो उसे प्रोजेक्ट की ड्रॉप-डाउन सूची से चुनें. खोज बार में एपीआई का नाम डालकर, उन एपीआई को खोजें जिनका इस्तेमाल आपको अपनी स्क्रिप्ट में करना है.
खोज के नतीजों में, एपीआई चुनें. इसके बाद, अगले पेज पर चालू करें को चुनें. अगर आपको बंद करें बटन दिखता है, तो इसका मतलब है कि यह एपीआई पहले से चालू है. हर उस एपीआई के लिए यह कार्रवाई दोहराएं जिसे आपको चालू करना है.
प्रोजेक्ट के लिए चालू किए गए एपीआई की सूची देखने के लिए, डैशबोर्ड पेज चुनें. पक्का करें कि स्क्रिप्ट के लिए इस्तेमाल किए जाने वाले सभी बेहतर एपीआई सूची में शामिल हों.
अब एडिटर पर वापस जाने के लिए, बेहतर एपीआई डायलॉग बंद करें. नए एपीआई, आपकी स्क्रिप्ट के लिए चालू हो जाएंगे और ये ऑटो-कंप्लीट सूची में उपलब्ध होंगे.
ज़रूरी बातें
बेहतर एपीआई का इस्तेमाल करते समय, कुछ बातों का ध्यान रखना ज़रूरी है.
प्रोजेक्ट आईडी
हर Google Ads स्क्रिप्ट से, Google Cloud प्रोजेक्ट आईडी जुड़ा होता है. इसे प्रोजेक्ट नंबर भी कहा जाता है. अपनी स्क्रिप्ट का प्रोजेक्ट नंबर ढूंढने के लिए, बेहतर एपीआई डायलॉग से Google API Console पेज खोलें. यह प्रोजेक्ट आईडी, स्क्रिप्ट बनाते समय जनरेट होता है. यह उस उपयोगकर्ता से जुड़ा होता है जिसने Google Ads स्क्रिप्ट बनाई है. अगर स्क्रिप्ट बनाने वाले उपयोगकर्ता को बाद में खाते से हटा दिया जाता है, तो स्क्रिप्ट को ऐक्सेस करने की कोशिश करने वाले उपयोगकर्ता को स्क्रिप्ट को फिर से अनुमति देने और बेहतर एपीआई की डिपेंडेंसी को फिर से सेट अप करने के लिए कहा जाएगा. Google Developer प्रोजेक्ट का एक नया आईडी भी जनरेट होगा. साथ ही, आपको बेहतर एपीआई को फिर से सेट अप करना होगा. इसके बारे में, इस दस्तावेज़ में पहले बताया जा चुका है.
डिपेंडेंसी
खाते में स्क्रिप्ट बनाने वाला उपयोगकर्ता ही, उस स्क्रिप्ट के लिए बेहतर एपीआई की डिपेंडेंसी में बदलाव कर सकता है.
अनुमतियां
एपीआई को ऐक्सेस करते समय, स्क्रिप्ट उस उपयोगकर्ता की अनुमतियों का इस्तेमाल करती है जिसने स्क्रिप्ट को अनुमति दी है. पक्का करें कि स्क्रिप्ट को अनुमति देने वाले उपयोगकर्ता के पास, इस्तेमाल किए जा रहे सभी बेहतर एपीआई के साथ-साथ, स्क्रिप्ट के लिए ज़रूरी डेटा को ऐक्सेस करने की अनुमति हो. अगर Google Analytics API का इस्तेमाल किया जा रहा है, तो पक्का करें कि स्क्रिप्ट को अनुमति देने वाले उपयोगकर्ता के पास, ऐक्सेस किए जा रहे Analytics खाते के लिए ज़रूरी अनुमतियां हों.
नियम और शर्तें
हर बेहतर एपीआई के अपने नियम और शर्तें हो सकती हैं. Google API Console में एपीआई को चालू करते समय, आपको इन नियमों और शर्तों को स्वीकार करना चाहिए.
Quota
ज़्यादातर बेहतर एपीआई के साथ, हर दिन का मुफ़्त कोटा जुड़ा होता है. अगर आपकी स्क्रिप्ट इस कोटे से ज़्यादा डेटा का इस्तेमाल करती है, तो एपीआई तब तक काम नहीं करेगा, जब तक कि अतिरिक्त डेटा का अनुरोध न किया जाए या मुफ़्त कोटा फिर से न भर जाए. आपकी स्क्रिप्ट ने कितना कोटा इस्तेमाल किया है, यह देखने के लिए, बेहतर एपीआई डायलॉग से स्क्रिप्ट के लिए Google API Console खोलें. Google API Console में, एपीआई के लिए अतिरिक्त कोटा का अनुरोध करने की सुविधा भी मिलती है.
बिलिंग
कुछ बेहतर एपीआई का इस्तेमाल करने के लिए, आपको पैसे चुकाने पड़ते हैं. इन पेमेंट्स को, आपकी स्क्रिप्ट से जुड़े Google Cloud प्रोजेक्ट के ज़रिए मैनेज किया जाता है. इन्हें Google Ads के ज़रिए मैनेज नहीं किया जाता. अपनी स्क्रिप्ट के Google Cloud प्रोजेक्ट के लिए बिलिंग चालू करने के तरीके के बारे में ज़्यादा जानने के लिए, हमारा दस्तावेज़ देखें.