Python क्विकस्टार्ट

Python कमांड-लाइन ऐप्लिकेशन बनाएं, जो Google Drive Activity API को अनुरोध भेजता हो.

क्विकस्टार्ट में, Google Workspace API को कॉल करने वाले ऐप्लिकेशन को सेट अप और चलाने का तरीका बताया गया है. इस क्विकस्टार्ट में, पुष्टि करने का आसान तरीका इस्तेमाल किया गया है. यह टेस्टिंग एनवायरमेंट के लिए सही है. हमारा सुझाव है कि प्रोडक्शन एनवायरमेंट के लिए, ऐक्सेस क्रेडेंशियल चुनने से पहले, पुष्टि करने और अनुमति देने के बारे में जान लें. इससे आपको अपने ऐप्लिकेशन के लिए सही क्रेडेंशियल चुनने में मदद मिलेगी.

इस क्विकस्टार्ट में, Google Workspace की सुझाई गई एपीआई क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है. इससे पुष्टि करने और अनुमति देने की प्रोसेस की कुछ जानकारी को मैनेज किया जा सकता है.

मकसद

• अपना एनवायरमेंट सेट अप करें.
• क्लाइंट लाइब्रेरी इंस्टॉल करें.
• सैंपल सेट अप करें.
• सैंपल चलाएं.

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

इस क्विकस्टार्ट को चलाने के लिए, आपको ये ज़रूरी शर्तें पूरी करनी होंगी:

• Python 3.10.7 या इसके बाद का वर्शन
• pip पैकेज मैनेजमेंट टूल
• Google Cloud प्रोजेक्ट.

• एक Google खाता.

अपना एनवायरमेंट सेट अप करने का तरीका

इस क्विकस्टार्ट को पूरा करने के लिए, अपना एनवायरमेंट सेट अप करें.

एपीआई चालू करना

Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. एक ही Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.

• Google Cloud Console में, Google Drive Activity API को चालू करें.

  एपीआई चालू करना

उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है

अगर आपको इस क्विकस्टार्ट को पूरा करने के लिए, नए Google Cloud प्रोजेक्ट का इस्तेमाल करना है, तो उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth को सहमति दी जाती है. अगर आपने अपने Cloud प्रोजेक्ट के लिए यह चरण पहले ही पूरा कर लिया है, तो अगले सेक्शन पर जाएं.

1. Google Cloud Console में, मेन्यू &gt Google Auth platform &gt ब्रैंडिंग पर जाएं.

   ब्रैंडिंग पर जाएं

2. अगर आपने पहले ही Google Auth platformको कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, दर्शक, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की इन सेटिंग को कॉन्फ़िगर किया जा सकता है. अगर आपको Google Auth platform अभी तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
1. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में ऐप्लिकेशन का नाम डालें.
2. उपयोगकर्ता सहायता के लिए ईमेल पता में, सहायता के लिए वह ईमेल पता चुनें जिस पर उपयोगकर्ता, सहमति से जुड़े सवालों के लिए आपसे संपर्क कर सकें.
3. आगे बढ़ें पर क्लिक करें.
4. दर्शक सेक्शन में जाकर, संगठन के अंदर से जनरेट होने वाला ट्रैफ़िक चुनें.
5. आगे बढ़ें पर क्लिक करें.
6. संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव की सूचना मिल सके.
7. आगे बढ़ें पर क्लिक करें.
8. पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति पढ़ें. अगर आप इससे सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा की नीति से सहमत हूं को चुनें.
9. जारी रखें पर क्लिक करें.
10. बनाएं पर क्लिक करें.
3. फ़िलहाल, स्कोप जोड़ने की प्रोसेस को स्किप किया जा सकता है. अगर आपको आने वाले समय में, अपने Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाना है, तो आपको उपयोगकर्ता का टाइप बदलकर बाहरी करना होगा. इसके बाद, अपने ऐप्लिकेशन के लिए ज़रूरी अनुमति के स्कोप जोड़ें. ज़्यादा जानने के लिए, OAuth की सहमति कॉन्फ़िगर करना गाइड पढ़ें.

डेस्कटॉप ऐप्लिकेशन के लिए क्रेडेंशियल को अनुमति देना

असली उपयोगकर्ताओं की पुष्टि करने और अपने ऐप्लिकेशन में उपयोगकर्ता का डेटा ऐक्सेस करने के लिए, आपको एक या उससे ज़्यादा OAuth 2.0 क्लाइंट आईडी बनाने होंगे. क्लाइंट आईडी का इस्तेमाल, Google के OAuth सर्वर पर किसी एक ऐप्लिकेशन की पहचान करने के लिए किया जाता है. अगर आपका ऐप्लिकेशन कई प्लैटफ़ॉर्म पर चलता है, तो आपको हर प्लैटफ़ॉर्म के लिए अलग क्लाइंट आईडी बनाना होगा.

1. Google Cloud console में, मेन्यू > Google Auth platform > क्लाइंट पर जाएं.

   क्लाइंट पर जाएं

2. क्लाइंट बनाएं पर क्लिक करें.
3. ऐप्लिकेशन का टाइप > डेस्कटॉप ऐप्लिकेशन पर क्लिक करें.
4. नाम फ़ील्ड में, क्रेडेंशियल के लिए कोई नाम टाइप करें. यह नाम सिर्फ़ Google Cloud Console में दिखता है.
5. बनाएं पर क्लिक करें.

   नया क्रेडेंशियल, "OAuth 2.0 क्लाइंट आईडी" में दिखता है.

6. डाउनलोड की गई JSON फ़ाइल को credentials.json के तौर पर सेव करें. इसके बाद, फ़ाइल को अपनी वर्किंग डायरेक्ट्री में ले जाएं.

Google क्लाइंट लाइब्रेरी इंस्टॉल करना

• Python के लिए Google क्लाइंट लाइब्रेरी इंस्टॉल करें:

  pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib
  

सैंपल को कॉन्फ़िगर करना

1. अपनी वर्किंग डायरेक्ट्री में, quickstart.py नाम की एक फ़ाइल बनाएं.

2. quickstart.py में यह कोड शामिल करें:

   drive/activity-v2/quickstart.py

   GitHub पर देखें
   import os.path
   
   from google.auth.transport.requests import Request
   from google.oauth2.credentials import Credentials
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   from googleapiclient.errors import HttpError
   
   # If modifying these scopes, delete the file token.json.
   SCOPES = ["https://www.googleapis.com/auth/drive.activity.readonly"]
   
   
   def main():
     """Shows basic usage of the Drive Activity API.
   
     Prints information about the last 10 events that occured the user's Drive.
     """
     creds = None
     # The file token.json stores the user's access and refresh tokens, and is
     # created automatically when the authorization flow completes for the first
     # time.
     if os.path.exists("token.json"):
       creds = Credentials.from_authorized_user_file("token.json", SCOPES)
     # If there are no (valid) credentials available, let the user log in.
     if not creds or not creds.valid:
       if creds and creds.expired and creds.refresh_token:
         creds.refresh(Request())
       else:
         flow = InstalledAppFlow.from_client_secrets_file(
             "credentials.json", SCOPES
         )
         creds = flow.run_local_server(port=0)
       # Save the credentials for the next run
       with open("token.json", "w") as token:
         token.write(creds.to_json())
   
     service = build("driveactivity", "v2", credentials=creds)
   
     # Call the Drive Activity API
     try:
       results = service.activity().query(body={"pageSize": 10}).execute()
       activities = results.get("activities", [])
   
       if not activities:
         print("No activity.")
       else:
         print("Recent activity:")
         for activity in activities:
           time = getTimeInfo(activity)
           action = getActionInfo(activity["primaryActionDetail"])
           actors = map(getActorInfo, activity["actors"])
           targets = map(getTargetInfo, activity["targets"])
           actors_str, targets_str = "", ""
           actor_name = actors_str.join(actors)
           target_name = targets_str.join(targets)
   
           # Print the action occurred on drive with actor, target item and timestamp
           print(f"{time}: {action}, {actor_name}, {target_name}")
   
     except HttpError as error:
       # TODO(developer) - Handleerrors from drive activity API.
       print(f"An error occurred: {error}")
   
   
   # Returns the name of a set property in an object, or else "unknown".
   def getOneOf(obj):
     for key in obj:
       return key
     return "unknown"
   
   
   # Returns a time associated with an activity.
   def getTimeInfo(activity):
     if "timestamp" in activity:
       return activity["timestamp"]
     if "timeRange" in activity:
       return activity["timeRange"]["endTime"]
     return "unknown"
   
   
   # Returns the type of action.
   def getActionInfo(actionDetail):
     return getOneOf(actionDetail)
   
   
   # Returns user information, or the type of user if not a known user.
   def getUserInfo(user):
     if "knownUser" in user:
       knownUser = user["knownUser"]
       isMe = knownUser.get("isCurrentUser", False)
       return "people/me" if isMe else knownUser["personName"]
     return getOneOf(user)
   
   
   # Returns actor information, or the type of actor if not a user.
   def getActorInfo(actor):
     if "user" in actor:
       return getUserInfo(actor["user"])
     return getOneOf(actor)
   
   
   # Returns the type of a target and an associated title.
   def getTargetInfo(target):
     if "driveItem" in target:
       title = target["driveItem"].get("title", "unknown")
       return f'driveItem:"{title}"'
     if "drive" in target:
       title = target["drive"].get("title", "unknown")
       return f'drive:"{title}"'
     if "fileComment" in target:
       parent = target["fileComment"].get("parent", {})
       title = parent.get("title", "unknown")
       return f'fileComment:"{title}"'
     return f"{getOneOf(target)}:unknown"
   
   
   if __name__ == "__main__":
     main()

सैंपल चलाना

1. अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और उसे चलाएं:

   python3 quickstart.py
   

2. पहली बार सैंपल चलाने पर, आपको ऐक्सेस की अनुमति देने के लिए कहा जाएगा:
   1. अगर आपने Google खाते में पहले से साइन इन नहीं किया है, तो मांगे जाने पर साइन इन करें. अगर आपने एक से ज़्यादा खातों में साइन इन किया हुआ है, तो पुष्टि के लिए किसी एक खाते को चुनें.
   2. स्वीकार करें पर क्लिक करें.

   आपका Python ऐप्लिकेशन चलता है और Google Drive Activity API को कॉल करता है.

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

अगले चरण

• APIs explorer में Google Workspace API आज़माना

• पुष्टि करने और अनुमति देने से जुड़ी समस्याओं को हल करना
• Drive Activity API के बारे में जानकारी देने वाला दस्तावेज़
• Google APIs Client for Python का दस्तावेज़
• Google Drive Activity API के PyDoc का दस्तावेज़