Google Ads स्क्रिप्ट में मौजूद बेहतर एपीआई की मदद से, अनुभवी डेवलपर, एचटीटीपी इंटरफ़ेस का इस्तेमाल करने के बजाय, कम सेटअप के साथ कुछ सार्वजनिक Google एपीआई से कनेक्ट कर सकते हैं. इन एपीआई का इस्तेमाल, स्क्रिप्ट की पहले से मौजूद सेवाओं की तरह ही किया जाता है. साथ ही, ये एपीआई ऑटो-कंप्लीशन और अपने-आप अनुमति देने जैसी सुविधाएं भी देते हैं.
बेहतर एपीआई के इस्तेमाल के संभावित तरीके
- Google Analytics
- Google Analytics का इस्तेमाल करके, अपनी वेबसाइट पर आने वाले ट्रैफ़िक को ट्रैक किया जा सकता है. साथ ही, इसके हिसाब से अपने कैंपेन की बिड में बदलाव किया जा सकता है. Google Analytics प्रॉपर्टी को अपने Google Ads खाते से लिंक करने पर, अपनी वेबसाइट पर ग्राहक की गतिविधि का विश्लेषण भी किया जा सकता है. इस जानकारी से आपको पता चलता है कि आपकी वेबसाइट पर आने वाला कितना ट्रैफ़िक या बिक्री, Google Ads से मिलती है. साथ ही, यह जानकारी, विज्ञापनों और वेबसाइट को बेहतर बनाने में आपकी मदद करती है. Analytics और Google Ads खातों को लिंक करने के बारे में ज़्यादा जानने के लिए, हमारे सहायता केंद्र पर जाएं.
- Google BigQuery
- Google Cloud Storage में ज़्यादा डेटा लोड किया जा सकता है. इसके बाद, Google BigQuery का इस्तेमाल करके उस डेटा के बारे में क्वेरी की जा सकती है. उदाहरण के लिए, पिछले 10 साल का सार्वजनिक मौसम डेटा लोड किया जा सकता है. इसके बाद, किसी क्षेत्र के औसत तापमान के बारे में जानकारी पाने के लिए, स्क्रिप्ट में क्वेरी की जा सकती है. इस स्क्रिप्ट में, बिड में बदलाव करने के लिए उस जानकारी का इस्तेमाल किया जाता है. इसका इस्तेमाल, कई सालों से अपने खाते की परफ़ॉर्मेंस के डेटा का विश्लेषण करने के लिए भी किया जा सकता है.
- YouTube और YouTube Analytics
- बिडिंग से जुड़े फ़ैसले लेने के लिए, अपने वीडियो, प्लेलिस्ट वगैरह के साथ-साथ वीडियो की परफ़ॉर्मेंस का डेटा भी वापस पाया और अपडेट किया जा सकता है.
- Google Calendar
- आपकी स्क्रिप्ट, आने वाले समय में होने वाले टास्क के लिए इवेंट बना सकती है. उदाहरण के लिए, आज से दो हफ़्ते बाद अपने कैंपेन के लिए परफ़ॉर्मेंस रिपोर्ट चलाना. इसके अलावा, यह आपके कैलेंडर में बनाई गई एंट्री के आधार पर कार्रवाइयां भी कर सकती है. उदाहरण के लिए, किसी खास तारीख को कैंपेन चालू करना.
- शॉपिंग सामग्री
- आपकी स्क्रिप्ट, Apps Script में Google Content API for Shopping का इस्तेमाल कर सकती है. इस एपीआई की मदद से, Google Merchant Center के उपयोगकर्ता अपनी प्रॉडक्ट लिस्टिंग अपलोड और मैनेज कर सकते हैं. साथ ही, अपने Merchant Center खाते भी मैनेज कर सकते हैं. स्क्रिप्ट में, यह प्रॉडक्ट लिस्टिंग की जांच करने और खास प्रॉडक्ट को खास विज्ञापनों से लिंक करने के लिए मददगार हो सकता है.
- Google Tasks
- आपकी स्क्रिप्ट, आने वाले समय में होने वाले टास्क के लिए रिमाइंडर की सूची बना सकती है. उदाहरण के लिए, आज से दो हफ़्ते बाद अपने कैंपेन के लिए परफ़ॉर्मेंस रिपोर्ट चलाना. इसके अलावा, रिमाइंडर की सूची में बनाई गई एंट्री के आधार पर कार्रवाइयां भी की जा सकती हैं. उदाहरण के लिए, किसी खास तारीख को कैंपेन चालू करना.
- Google Slides
- आपकी स्क्रिप्ट, कैंपेन की जानकारी या आंकड़ों को Google Slides में एक्सपोर्ट कर सकती है, ताकि इस जानकारी को बेहतर फ़ॉर्मैट में पब्लिश किया जा सके.
बेहतर एपीआई चालू करना
यह देखने के लिए कि कौनसे Google API, बेहतर एपीआई के तौर पर उपलब्ध हैं, सबसे ऊपर मौजूद एडिटर बार में बेहतर एपीआई बटन पर क्लिक करें.
इससे बेहतर एपीआई डायलॉग दिखेगा. वे एपीआई चुनें जिन्हें आपको चालू करना है.
इसके बाद, Google API Console लिंक पर क्लिक करें, ताकि कंसोल में API Console पेज खुले. इस पेज पर, आपकी स्क्रिप्ट से जुड़ा प्रोजेक्ट दिखेगा. अगर आपका प्रोजेक्ट पहले से चुना नहीं गया है, तो प्रोजेक्ट ड्रॉप-डाउन सूची से उसे चुनें. खोज बार में एपीआई का नाम डालकर, वे एपीआई खोजें जिनका आपको अपनी स्क्रिप्ट में इस्तेमाल करना है.
खोज के नतीजों में, एपीआई चुनें. इसके बाद, अगले पेज पर चालू करें को चुनें. अगर आपको बंद करें बटन दिखता है, तो इसका मतलब है कि यह एपीआई पहले से ही चालू है. जिस भी एपीआई को चालू करना है उसके लिए यह कार्रवाई दोहराएं.
प्रोजेक्ट के लिए चालू किए गए एपीआई की सूची देखने के लिए, डैशबोर्ड पेज चुनें. पुष्टि करें कि स्क्रिप्ट के लिए इस्तेमाल किए जाने वाले सभी बेहतर एपीआई, सूची में शामिल हों.
अब एडिटर पर वापस जाने के लिए, बेहतर एपीआई डायलॉग को बंद करें. नए एपीआई, आपकी स्क्रिप्ट के लिए चालू हो जाएंगे और अपने-आप पूरा होने वाले टेक्स्ट की सूची में उपलब्ध होंगे.
उपलब्ध एपीआई
इस्तेमाल के लिए ये एपीआई उपलब्ध हैं:
| एपीआई का नाम | दस्तावेज़ |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Google Calendar | https://developers.google.com/apps-script/advanced/calendar |
| Google Slides | https://developers.google.com/apps-script/advanced/slides |
| Google Tasks | https://developers.google.com/apps-script/advanced/tasks |
| शॉपिंग सामग्री | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| YouTube Analytics | https://developers.google.com/apps-script/advanced/youtube-analytics |
इन एपीआई को इस्तेमाल करने के तरीके के कुछ उदाहरणों के लिए, कोड स्निपेट वाला पेज भी देखें.
आखिर में ध्यान देने वाली बातें
ऐडवांस एपीआई का इस्तेमाल करते समय, कुछ बातों का ध्यान रखना ज़रूरी है.
प्रोजेक्ट आईडी
हर Google Ads स्क्रिप्ट के साथ, Google Cloud Platform का प्रोजेक्ट आईडी (इसे प्रोजेक्ट नंबर भी कहा जाता है) जुड़ा होता है. बेहतर एपीआई डायलॉग से Google API Console पेज खोलकर, अपनी स्क्रिप्ट का प्रोजेक्ट नंबर देखा जा सकता है. यह प्रोजेक्ट आईडी, स्क्रिप्ट बनाने पर बनता है. यह उस उपयोगकर्ता से जुड़ा होता है जिसने Google Ads स्क्रिप्ट बनाई है. अगर स्क्रिप्ट बनाने वाले उपयोगकर्ता को बाद में खाते से हटा दिया जाता है, तो स्क्रिप्ट को ऐक्सेस करने वाले उपयोगकर्ता को स्क्रिप्ट के लिए फिर से अनुमति देने और ऐडवांस एपीआई डिपेंडेंसी को फिर से सेट अप करने के लिए कहा जाएगा. एक नया Google Developer प्रोजेक्ट आईडी भी बनाया जाएगा. साथ ही, आपको ऐडवांस एपीआई को फिर से सेट अप करना होगा, जैसा कि इस दस्तावेज़ में पहले बताया गया है.
डिपेंडेंसी
खाते में स्क्रिप्ट बनाने वाला उपयोगकर्ता ही, उस स्क्रिप्ट के लिए बेहतर API की डिपेंडेंसी बदल सकता है.
अनुमतियां
एपीआई को ऐक्सेस करते समय, स्क्रिप्ट उस उपयोगकर्ता की अनुमतियों का इस्तेमाल करती है जिसने स्क्रिप्ट को अनुमति दी है. पक्का करें कि स्क्रिप्ट को अनुमति देने वाले उपयोगकर्ता के पास, इस्तेमाल किए जा रहे सभी बेहतर एपीआई के साथ-साथ, स्क्रिप्ट के लिए ज़रूरी डेटा का ऐक्सेस हो. अगर Google Analytics API का इस्तेमाल किया जा रहा है, तो पक्का करें कि स्क्रिप्ट को अनुमति देने वाले उपयोगकर्ता के पास, ऐक्सेस किए जा रहे Analytics खाते के लिए ज़रूरी अनुमतियां हों.
नियम और शर्तें
हर बेहतर एपीआई के लिए, नियम और शर्तें अलग-अलग हो सकती हैं. आपको Google API Console में एपीआई चालू करते समय, ये नियम और शर्तें स्वीकार करनी होंगी.
अनुरोध भेजने की तय सीमा
ज़्यादातर ऐडवांस एपीआई के लिए, हर दिन मुफ़्त में इस्तेमाल किए जाने की सीमा तय होती है. जब आपकी स्क्रिप्ट इस कोटे से ज़्यादा डेटा का अनुरोध करेगी, तब एपीआई तब तक काम करना बंद कर देगा, जब तक कि आपने ज़्यादा डेटा का अनुरोध नहीं किया या मुफ़्त कोटा फिर से नहीं भर दिया जाता. बेहतर एपीआई डायलॉग से स्क्रिप्ट के लिए Google API कंसोल खोलकर, अपनी स्क्रिप्ट के इस्तेमाल किए गए कोटे को मॉनिटर किया जा सकता है. Google API Console की मदद से, एपीआई के लिए ज़्यादा कोटा का अनुरोध भी किया जा सकता है.
बिलिंग
कुछ बेहतर एपीआई का इस्तेमाल करने के लिए, आपको पैसे चुकाने होंगे. इन पेमेंट को आपकी स्क्रिप्ट से जुड़े Google Cloud Platform प्रोजेक्ट के ज़रिए मैनेज किया जाता है, न कि Google Ads के ज़रिए. अपनी स्क्रिप्ट के Google Cloud Platform प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करने के तरीके के बारे में ज़्यादा जानने के लिए, हमारा दस्तावेज़ देखें.