बेहतर Google सेवाएं

Apps Script में मौजूद बेहतर सेवाओं की मदद से, अनुभवी डेवलपर कुछ सार्वजनिक Google API जिनका सेट-अप उनके एचटीटीपी इंटरफ़ेस के मुकाबले कम होता है. बेहतर सेवाएं उन Google API के चारों ओर बहुत कम रैपर होती हैं. वे काफ़ी हद तक Apps Script फ़ाइल की तरह काम करते हैं पहले से मौजूद सेवाएं—उदाहरण के लिए, वे और Apps Script, ऑथराइज़ेशन फ़्लो अपने-आप सेट हो जाता है. हालांकि, ऐसा करने से पहले आपको बेहतर सेवा चालू करनी होगी तो आप इसे स्क्रिप्ट में इस्तेमाल कर सकते हैं.

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

ऐडवांस सेवाएं या एचटीटीपी?

Google की हर बेहतर सेवा, किसी सार्वजनिक Google API से जुड़ी होती है. Apps Script में, आप इन एपीआई को बेहतर सेवाओं के ज़रिए या आसानी से ऐक्सेस कर सकते हैं इसका इस्तेमाल करके, एपीआई अनुरोध सीधे UrlFetch.

अगर बेहतर सेवा के तरीके का इस्तेमाल किया जाता है, तो Apps Script ऑथराइज़ेशन फ़्लो और ऑफ़र सहायता के लिए ऑटोकंप्लीट की सुविधा उपलब्ध है. हालांकि, आपको इस्तेमाल करने से पहले बेहतर सेवा चालू करें इसे. इसके अलावा, कुछ बेहतर सेवाएं सिर्फ़ जो एपीआई में उपलब्ध है.

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

सामान्य तौर पर बेहतर सेवा का उपयोग करना सबसे आसान है जहां संभव हो और केवल UrlFetch तरीके का इस्तेमाल तब करें, जब बेहतर सेवा और आपके काम का है.

ज़रूरी शर्तें

बेहतर सेवा का इस्तेमाल करने से पहले, आपको इन शर्तों को पूरा करना होगा: ज़रूरतें:

  1. आपको बेहतर सेवा चालू करनी होगी आपके स्क्रिप्ट प्रोजेक्ट में.

  2. आपको यह पक्का करना होगा कि बेहतर सेवा से जुड़ा एपीआई चालू हो Cloud Platform (GCP) प्रोजेक्ट में जिनका इस्तेमाल आपकी स्क्रिप्ट करती है.

    अगर आपका स्क्रिप्ट प्रोजेक्ट, डिफ़ॉल्ट GCP प्रोजेक्ट का इस्तेमाल करता है इसे 8 अप्रैल, 2019 को या इसके बाद बनाया गया था. साथ ही, यह एपीआई अपने-आप चालू हो गया है और स्क्रिप्ट प्रोजेक्ट को सेव करें. अगर आपको नहीं किया है, तो आप शायद Google Cloud से सहमत होने के लिए कहा गया और Google API की सेवा की शर्तों से भी सहमत हैं.

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

Cloud Platform प्रोजेक्ट देखें हमारा वीडियो देखें.

बेहतर सेवाएं चालू करें

Google की बेहतर सेवा का इस्तेमाल करने के लिए, इन निर्देशों का पालन करें:

  1. Apps Script प्रोजेक्ट खोलें.
  2. बाईं ओर, एडिटर पर क्लिक करें.
  3. बाईं ओर, सेवाएं के बगल में, सेवा जोड़ें पर क्लिक करें .
  4. Google की कोई बेहतर सेवा चुनें और जोड़ें पर क्लिक करें.

बेहतर सेवा चालू करने के बाद, वह ऑटोकंप्लीट में उपलब्ध होती है.

तरीके के हस्ताक्षर कैसे तय किए जाते हैं

ऐडवांस सेवाएं आम तौर पर एक जैसे ऑब्जेक्ट, तरीकों के नाम, और पैरामीटर का इस्तेमाल करती हैं संबंधित सार्वजनिक API के रूप में होता है, हालांकि विधि हस्ताक्षरों का अनुवाद का इस्तेमाल Apps Script में कैसे करें. स्क्रिप्ट एडिटर अपने-आप पूरा होने वाला फ़ंक्शन आम तौर पर, शुरुआत करने के लिए ज़रूरी जानकारी मिलती है, लेकिन नीचे दिए गए नियमों में बताया गया है कि जानें कि Apps Script किसी सार्वजनिक Google API से, मेथड सिग्नेचर कैसे जनरेट करता है.

Google API को किए गए अनुरोध कई तरह का डेटा, इसमें पाथ पैरामीटर, क्वेरी पैरामीटर, अनुरोध का मुख्य हिस्सा, और/या मीडिया शामिल होता है अटैचमेंट अपलोड करें. कुछ बेहतर सेवाएं भी चुनिंदा एचटीटीपी अनुरोध को स्वीकार कर सकती हैं हेडर (उदाहरण के लिए, कैलेंडर की बेहतर सेवा).

Google Apps Script में संबंधित हस्ताक्षर में ये चीज़ें शामिल हैं तर्क:

  1. JavaScript ऑब्जेक्ट के तौर पर, अनुरोध का मुख्य हिस्सा (आम तौर पर एक संसाधन).
  2. अलग-अलग आर्ग्युमेंट के तौर पर, पाथ या ज़रूरी पैरामीटर.
  3. Blob के तौर पर, मीडिया अपलोड करने के अटैचमेंट तर्क है.
  4. वैकल्पिक पैरामीटर, जैसे कि JavaScript ऑब्जेक्ट मैपिंग पैरामीटर के नाम वैल्यू.
  5. एचटीटीपी अनुरोध के हेडर, JavaScript ऑब्जेक्ट के हेडर के नामों को हेडर के साथ मैप करने के तौर पर वैल्यू.

अगर तरीके में किसी कैटगरी में कोई आइटम नहीं है, तो हस्ताक्षर हटा दिया गया है.

इसके कुछ खास अपवाद हैं, जिनकी जानकारी होनी चाहिए:

  • मीडिया अपलोड करने के तरीकों के लिए, पैरामीटर uploadType सेट होता है स्वचालित रूप से.
  • Google API में delete नाम के तरीकों को Apps Script में remove के नाम से रखा गया है. क्योंकि delete JavaScript में एक रिज़र्व शब्द है.
  • अगर किसी बेहतर सेवा को एचटीटीपी अनुरोध के हेडर को स्वीकार करने के लिए कॉन्फ़िगर किया गया हो और आपको एक अनुरोध हेडर JavaScript ऑब्जेक्ट सेट करें, फिर आपको वैकल्पिक URL भी सेट करना होगा पैरामीटर JavaScript ऑब्जेक्ट (यदि आप उपयोग नहीं कर रहे हैं तो किसी रिक्त ऑब्जेक्ट पर) वैकल्पिक पैरामीटर होते हैं).

बेहतर सेवाओं के लिए सहायता

बेहतर सेवाएं सिर्फ़ पतले रैपर होते हैं. इनकी मदद से Google, Apps Script में मौजूद एपीआई. इसलिए, उनका इस्तेमाल करते समय आने वाली कोई भी समस्या है आम तौर पर, मौजूदा एपीआई में समस्या होती है, Apps Script में नहीं.

अगर ऐडवांस सेवा का इस्तेमाल करते समय कोई समस्या आती है, तो को एपीआई के सहायता निर्देशों का इस्तेमाल करके रिपोर्ट किया गया है. इनसे लिंक सहायता निर्देश हर ऐडवांस सेवा गाइड में दिए गए हैं. Apps Script रेफ़रंस सेक्शन.