क्विकस्टार्ट में, Google Workspace API को कॉल करने वाले ऐप्लिकेशन को सेट अप करने और चलाने का तरीका बताया गया है.
पुष्टि करने और अनुमति देने के फ़्लो की कुछ जानकारी मैनेज करने के लिए, Google Workspace क्विकस्टार्ट एपीआई क्लाइंट लाइब्रेरी का इस्तेमाल करता है. हमारा सुझाव है कि आप अपने ऐप्लिकेशन के लिए क्लाइंट लाइब्रेरी का इस्तेमाल करें. यह क्विकस्टार्ट, पुष्टि करने के आसान तरीके का इस्तेमाल करता है, जो टेस्ट एनवायरमेंट के लिए सही है. हमारा सुझाव है कि प्रोडक्शन एनवायरमेंट के लिए, अपने ऐप्लिकेशन के लिए सही ऐक्सेस क्रेडेंशियल चुनने से पहले, पुष्टि करने और अनुमति देने के बारे में जानें.
ऐसा Python कमांड-लाइन ऐप्लिकेशन बनाएं जो Google Apps Script API को ऐक्सेस करने के अनुरोध करता हो.
मकसद
- अपना एनवायरमेंट सेट अप करें.
- क्लाइंट लाइब्रेरी इंस्टॉल करें.
- सैंपल सेट अप करें.
- सैंपल चलाएं.
ज़रूरी शर्तें
इस क्विकस्टार्ट को चलाने के लिए, आपको इन ज़रूरी शर्तों को पूरा करना होगा:
- Python 3.10.7 या इससे नया वर्शन
- pip पैकेज मैनेजमेंट टूल
- Google Cloud प्रोजेक्ट.
- आपके पास ऐसा Google खाता होना चाहिए जिसमें Google Drive चालू हो.
अपना एनवायरमेंट सेट अप करें
इस क्विकस्टार्ट को पूरा करने के लिए, अपना एनवायरमेंट सेट अप करें.
इस एपीआई को चालू करें
Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.Google Cloud Console में, Google Apps Script API चालू करें.
उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है
अगर इस क्विकस्टार्ट को पूरा करने के लिए किसी नए Google Cloud प्रोजेक्ट का इस्तेमाल किया जा रहा है, तो OAuth के लिए सहमति वाली स्क्रीन कॉन्फ़िगर करें और खुद को टेस्ट उपयोगकर्ता के तौर पर जोड़ें. अगर आपने अपने Cloud प्रोजेक्ट के लिए यह चरण पहले ही पूरा कर लिया है, तो सीधे अगले सेक्शन पर जाएं.
- Google Cloud Console में, मेन्यू > एपीआई और सेवाएं > OAuth की सहमति वाली स्क्रीन पर जाएं.
- उपयोगकर्ता टाइप के लिए इंटरनल चुनें. इसके बाद, बनाएं पर क्लिक करें.
- ऐप्लिकेशन रजिस्ट्रेशन फ़ॉर्म भरें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें.
फ़िलहाल, दायरों को जोड़ना स्किप किया जा सकता है. इसके बाद, सेव करें और जारी रखें पर क्लिक करें. आने वाले समय में, जब आप अपने Google Workspace संगठन से बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाते हैं, तो आपको उपयोगकर्ता टाइप को बदलकर एक्सटर्नल करना होगा. इसके बाद, अपने ऐप्लिकेशन के लिए ज़रूरी अनुमति के दायरे जोड़ना होगा.
- अपने ऐप्लिकेशन रजिस्ट्रेशन की खास जानकारी देखें. बदलाव करने के लिए, बदलाव करें पर क्लिक करें. अगर ऐप्लिकेशन रजिस्ट्रेशन ठीक लगता है, तो डैशबोर्ड पर वापस जाएं पर क्लिक करें.
डेस्कटॉप ऐप्लिकेशन के लिए क्रेडेंशियल को अनुमति दें
असली उपयोगकर्ताओं की पुष्टि करने और अपने ऐप्लिकेशन में उपयोगकर्ता के डेटा को ऐक्सेस करने के लिए, आपको एक या उससे ज़्यादा OAuth 2.0 क्लाइंट आईडी बनाने होंगे. Google के OAuth सर्वर पर किसी एक ऐप्लिकेशन की पहचान करने के लिए, Client-ID का इस्तेमाल किया जाता है. अगर आपका ऐप्लिकेशन एक से ज़्यादा प्लैटफ़ॉर्म पर चलता है, तो आपको हर प्लैटफ़ॉर्म के लिए एक अलग क्लाइंट आईडी बनाना होगा.- Google Cloud Console में, मेन्यू > एपीआई और सेवाएं > क्रेडेंशियल पर जाएं.
- क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
- ऐप्लिकेशन टाइप > डेस्कटॉप ऐप्लिकेशन पर क्लिक करें.
- नाम फ़ील्ड में, क्रेडेंशियल के लिए कोई नाम लिखें. यह नाम सिर्फ़ Google Cloud Console में दिखता है.
- बनाएं पर क्लिक करें. OAuth क्लाइंट की बनाई गई स्क्रीन दिखेगी. इसमें आपका नया क्लाइंट आईडी और क्लाइंट सीक्रेट दिखेगा.
- ठीक है पर क्लिक करें. नया क्रेडेंशियल, OAuth 2.0 क्लाइंट आईडी के तहत दिखता है.
- डाउनलोड की गई JSON फ़ाइल को
credentials.json
के तौर पर सेव करें और फ़ाइल को अपने काम करने वाली डायरेक्ट्री में ले जाएं.
Google क्लाइंट लाइब्रेरी इंस्टॉल करना
Python के लिए Google क्लाइंट लाइब्रेरी इंस्टॉल करें:
pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib
सैंपल कॉन्फ़िगर करना
- अपनी वर्किंग डायरेक्ट्री में,
quickstart.py
नाम की फ़ाइल बनाएं. quickstart.py
में यह कोड शामिल करें:
सैंपल चलाएं
अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:
python3 quickstart.py
-
पहली बार सैंपल चलाने पर, आपसे ऐक्सेस की अनुमति देने के लिए कहा जाता है:
- अगर आपने अपने Google खाते में पहले से साइन इन नहीं किया है, तो मांगे जाने पर साइन इन करें. अगर आपने कई खातों में साइन इन किया हुआ है, तो अनुमति देने के लिए एक खाता चुनें.
- स्वीकार करें पर क्लिक करें.
आपका Python ऐप्लिकेशन, Google Apps Script API को चलाता है और उसे कॉल करता है.
अनुमति देने की जानकारी फ़ाइल सिस्टम में सेव होती है. इसलिए, अगली बार सैंपल कोड चलाने पर आपको अनुमति देने के लिए नहीं कहा जाएगा.
अगले चरण
- Apps Script API के बारे में दस्तावेज़
- Python दस्तावेज़ के लिए Google API Client
- Google Apps Script API PyDoc दस्तावेज़