बेहतर API

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 Analytics API का इस्तेमाल किया जा रहा है, तो पुष्टि करें कि स्क्रिप्ट को अनुमति देने वाले उपयोगकर्ता के पास, ऐक्सेस किए जा रहे Analytics खाते के लिए ज़रूरी अनुमतियां हों.

मई 2019 से पहले की स्क्रिप्ट के लिए ज़रूरी बातें

मई 2019 से पहले बनाई गई स्क्रिप्ट के लिए, आपको स्क्रिप्ट से जुड़े Google Cloud प्रोजेक्ट में, काम के एपीआई को मैन्युअल तरीके से चालू करना पड़ सकता है. अगर बेहतर एपीआई डायलॉग में, Google Cloud Console की लिंक दिखती है, तो इसका मतलब है कि आपकी स्क्रिप्ट पर इसका असर पड़ा है.

बेहतर एपीआई चालू करना

साल 2019 से पहले की स्क्रिप्ट के लिए, आपको अपनी स्क्रिप्ट में इस्तेमाल किए जाने वाले हर बेहतर एपीआई को मैन्युअल तरीके से चालू करना होगा:

  1. बेहतर एपीआई बटन पर क्लिक करें. इसके बाद, डायलॉग विंडो में, Google Cloud Console की लिंक पर क्लिक करें.
  2. अगर आपका प्रोजेक्ट पहले से नहीं चुना गया है, तो उसे प्रोजेक्ट की ड्रॉप-डाउन सूची से चुनें.
  3. खोज बार में एपीआई का नाम डालकर, उन एपीआई को खोजें जिनका इस्तेमाल आपको अपनी स्क्रिप्ट में करना है.
  4. खोज के नतीजों में से एपीआई चुनें. इसके बाद, अगले पेज पर "चालू करें" बटन पर क्लिक करें.

अगर स्क्रिप्ट बनाने वाले उपयोगकर्ता को बाद में खाते से हटा दिया जाता है, तो स्क्रिप्ट को ऐक्सेस करने की कोशिश करने वाले किसी भी नए उपयोगकर्ता को, बेहतर एपीआई की डिपेंडेंसी को फिर से चालू करने के लिए कहा जाएगा. साथ ही, स्क्रिप्ट को फिर से अनुमति देने के लिए भी कहा जाएगा.