बेहतर API

Google Ads स्क्रिप्ट के बेहतर एपीआई की मदद से अनुभवी डेवलपर, अपने एचटीटीपी इंटरफ़ेस की तुलना में कम सेटअप के साथ कुछ सार्वजनिक Google API से कनेक्ट कर सकते हैं. आप इन एपीआई का इस्तेमाल बहुत हद तक स्क्रिप्ट की बिल्ट-इन सेवाओं की तरह करते हैं. ये अपने-आप पूरा होने और अपने-आप अनुमति देने जैसी ही सुविधाएं देते हैं.

बेहतर एपीआई के लिए संभावित इस्तेमाल

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 का इस्तेमाल कर सकती है. इस एपीआई की मदद से, Google Merchant Center के उपयोगकर्ता अपने प्रॉडक्ट लिस्टिंग अपलोड और मैनेज कर सकते हैं. साथ ही, वे अपने Merchant Center खातों को भी मैनेज कर सकते हैं. स्क्रिप्ट में, यह प्रॉडक्ट लिस्टिंग की जांच करने और खास प्रॉडक्ट को खास विज्ञापनों से लिंक करने के लिए फ़ायदेमंद हो सकता है.
Google Tasks
आपकी स्क्रिप्ट आने वाले समय के कामों के लिए रिमाइंडर की सूची बना सकती है (उदाहरण के लिए, आज से दो हफ़्ते बाद अपने कैंपेन की परफ़ॉर्मेंस रिपोर्ट चला सकती है) या रिमाइंडर की सूची में बनाई गई एंट्री के आधार पर कार्रवाइयां कर सकती है. उदाहरण के लिए, किसी खास तारीख पर कैंपेन चालू करना.
Google Slides
आपकी स्क्रिप्ट, कैंपेन की जानकारी या आंकड़ों को Google Slides में एक्सपोर्ट कर सकती है, ताकि इस जानकारी को प्रज़ेंटेशन वाले फ़ॉर्मैट में पब्लिश किया जा सके.

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

यह देखने के लिए कि बेहतर एपीआई के तौर पर कौनसे Google API उपलब्ध हैं, टॉप एडिटर बार पर बेहतर एपीआई बटन पर क्लिक करें.

इससे बेहतर एपीआई डायलॉग दिखता है. वे एपीआई चुनें जिन्हें आपको चालू करना है.

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

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

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

अब अपने एडिटर पर वापस जाने के लिए, बेहतर एपीआई वाला डायलॉग बॉक्स बंद करें. नए एपीआई आपकी स्क्रिप्ट के लिए चालू हो जाएंगे और अपने-आप पूरी होने वाली सूची में उपलब्ध हो जाएंगे.

उपलब्ध एपीआई

नीचे दिए गए एपीआई इस्तेमाल के लिए उपलब्ध हैं:

एपीआई का नाम दस्तावेज़
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 डेवलपर प्रोजेक्ट आईडी भी बनाया जाएगा और आपको बेहतर एपीआई फिर से सेट अप करना होगा. इस बारे में, इस दस्तावेज़ में पहले ही बताया गया है.

डिपेंडेंसी

खाते में स्क्रिप्ट बनाने वाला उपयोगकर्ता ही उस स्क्रिप्ट के लिए बेहतर एपीआई डिपेंडेंसी बदल सकता है.

अनुमतियां

एपीआई ऐक्सेस करते समय, स्क्रिप्ट उस उपयोगकर्ता की अनुमतियों का इस्तेमाल करती है जिसने स्क्रिप्ट को अनुमति दी है. पक्का करें कि स्क्रिप्ट को अनुमति देने वाले उपयोगकर्ता के पास, इस्तेमाल किए जा रहे सभी ऐडवांस एपीआई के साथ-साथ स्क्रिप्ट के लिए ज़रूरी डेटा का ज़रूरी ऐक्सेस हो. अगर Google Analytics API का इस्तेमाल किया जा रहा है, तो पक्का करें कि स्क्रिप्ट को अनुमति देने वाले उपयोगकर्ता के पास, Analytics खाते को ऐक्सेस करने के लिए ज़रूरी अनुमतियां हों.

नियम और शर्तें

हर बेहतर एपीआई के अपने नियम और शर्तें हो सकती हैं, जिन्हें आपको Google API कंसोल में एपीआई चालू करते समय स्वीकार करना चाहिए.

अनुरोध भेजने की तय सीमा (कोटा)

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

बिलिंग

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