Google Ads स्क्रिप्ट में मौजूद ऐडवांस एपीआई की मदद से, डेवलपर कुछ सार्वजनिक Google API से कनेक्ट कर सकते हैं. इसके लिए, उन्हें एचटीटीपी इंटरफ़ेस का इस्तेमाल करने के मुकाबले कम सेटअप की ज़रूरत होती है. इन एपीआई का इस्तेमाल, स्क्रिप्ट में पहले से मौजूद सेवाओं की तरह ही किया जा सकता है. साथ ही, ये अपने-आप पूरा होने और अपने-आप अनुमति मिलने जैसी सुविधाएं भी देते हैं.
इन एपीआई को इस्तेमाल करने का तरीका जानने के लिए, हमारे कोड स्निपेट पेज पर जाएं. यहां आपको कुछ उदाहरण मिलेंगे.
उपलब्ध ऐडवांस एपीआई
- Google Analytics
- ध्यान दें: ऐडवांस एपीआई डायलॉग में मौजूद
Analyticsऐडवांस एपीआई, बंद हो चुके Universal Analytics v3 API को टारगेट करता है. इसलिए, इसके अनुरोध पूरे नहीं होते. Google Ads स्क्रिप्ट, Google Analytics 4AnalyticsDataयाAnalyticsAdminऐडवांस सेवाओं के साथ काम नहीं करती हैं. किसी स्क्रिप्ट से Google Analytics 4 के डेटा के बारे में क्वेरी करने के लिए,UrlFetchAppसेवा और OAuth 2.0 का इस्तेमाल करके, Google Analytics Data API को एचटीटीपीएस अनुरोध भेजें. वेबसाइट और ऐप्लिकेशन के कन्वर्ज़न डेटा को सीधे तौर पर शेयर करने के लिए, Google Analytics 4 प्रॉपर्टी को अपने 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 खाते को लिंक करने के बारे में ज़्यादा जानने के लिए, डेवलपर के तौर पर रजिस्टर करें गाइड देखें.
- शॉपिंग कॉन्टेंट
- आपकी स्क्रिप्ट, Google Content API for Shopping का इस्तेमाल करके, प्रॉडक्ट लिस्टिंग अपलोड और मैनेज कर सकती है. साथ ही, Google Merchant Center खातों को मैनेज कर सकती है. स्क्रिप्ट में, प्रॉडक्ट लिस्टिंग की जांच करने और खास प्रॉडक्ट को खास विज्ञापनों से लिंक करने के लिए, यह तरीका मददगार हो सकता है. ध्यान दें: Content API for Shopping, 18 अगस्त, 2026 को बंद हो जाएगा. इसके बजाय, Merchant API का इस्तेमाल करें. इसके बारे में पिछले सेक्शन में बताया गया है.
- YouTube और YouTube Analytics
- बिडिंग से जुड़े फ़ैसले लेने के लिए, अपने वीडियो, प्लेलिस्ट वगैरह के साथ-साथ वीडियो की परफ़ॉर्मेंस का डेटा वापस पाया जा सकता है और उसे अपडेट किया जा सकता है.
ऐडवांस एपीआई चालू करना
कौनसे Google API, ऐडवांस एपीआई के तौर पर उपलब्ध हैं, यह देखने के लिए एडिटर के सबसे ऊपर मौजूद बार में ऐडवांस एपीआई पर क्लिक करें. इससे ऐडवांस एपीआई डायलॉग बॉक्स दिखेगा. वे एपीआई चुनें जिन्हें आपको चालू करना है.
अपने चुने हुए विकल्पों को सेव करने और स्क्रिप्ट एडिटर पर वापस जाने के लिए, सेव करें पर क्लिक करें. आपकी स्क्रिप्ट के लिए नए एपीआई चालू हो जाएंगे. साथ ही, ये अपने-आप पूरी होने वाली सूची में उपलब्ध होंगे.
ज़्यादा जानकारी
ऐडवांस एपीआई का इस्तेमाल करते समय, कुछ बातों का ध्यान रखना ज़रूरी है.
डिपेंडेंसी
खाते में स्क्रिप्ट बनाने वाला उपयोगकर्ता ही उस स्क्रिप्ट के लिए, ऐडवांस एपीआई डिपेंडेंसी में बदलाव कर सकता है.
अनुमतियां
ऐडवांस एपीआई को ऐक्सेस करते समय, स्क्रिप्ट उस उपयोगकर्ता की अनुमतियों का इस्तेमाल करती है जिसने स्क्रिप्ट को अनुमति दी है. अनुमति देने वाले उपयोगकर्ता के पास, स्क्रिप्ट के लिए ज़रूरी सभी डेटा का ऐक्सेस होना चाहिए. उदाहरण के लिए, BigQuery ऐडवांस एपीआई का इस्तेमाल करने के लिए, अनुमति देने वाले उपयोगकर्ता के पास टारगेट Google Cloud प्रोजेक्ट और BigQuery डेटासेट के लिए ज़रूरी अनुमतियां होनी चाहिए.
मई 2019 से पहले की स्क्रिप्ट के लिए ध्यान देने वाली बातें
मई 2019 से पहले बनाई गई स्क्रिप्ट के लिए, आपको स्क्रिप्ट से जुड़े Google Cloud प्रोजेक्ट में, काम के एपीआई को मैन्युअल तरीके से चालू करना पड़ सकता है. अगर आपको ऐडवांस एपीआई डायलॉग में Google Cloud Console का लिंक दिखता है, तो इसका मतलब है कि आपकी स्क्रिप्ट पर असर पड़ा है.
ऐडवांस एपीआई चालू करना
साल 2019 से पहले की स्क्रिप्ट के लिए, आपको हर उस ऐडवांस एपीआई को मैन्युअल तरीके से चालू करना होगा जिसका इस्तेमाल आपको अपनी स्क्रिप्ट में करना है:
- बेहतर एपीआई बटन पर क्लिक करें. इसके बाद, डायलॉग विंडो में Google Cloud Console के लिंक पर क्लिक करें.
- अगर आपका प्रोजेक्ट पहले से नहीं चुना गया है, तो उसे प्रोजेक्ट ड्रॉप-डाउन सूची से चुनें.
- खोज बार में एपीआई का नाम डालकर, उन एपीआई को खोजें जिनका इस्तेमाल आपको अपनी स्क्रिप्ट में करना है.
- खोज के नतीजों में से एपीआई चुनें. इसके बाद, अगले पेज पर "चालू करें" बटन पर क्लिक करें.
अगर स्क्रिप्ट बनाने वाले उपयोगकर्ता को बाद में खाते से हटा दिया जाता है, तो स्क्रिप्ट को ऐक्सेस करने की कोशिश करने वाले किसी भी नए उपयोगकर्ता को ऐडवांस एपीआई डिपेंडेंसी को फिर से चालू करने के साथ-साथ, स्क्रिप्ट को फिर से अनुमति देने के लिए कहा जाएगा.