इस दस्तावेज़ में, Google Drive Activity API की खास जानकारी दी गई है.
Drive Activity API की मदद से, हाल ही में हुए इवेंट के बारे में क्वेरी की जा सकती है. आपके पास सभी गतिविधियों का विस्तृत इतिहास पाने का विकल्प होता है. इसमें हर इवेंट के बारे में ज़्यादा जानकारी भी शामिल होती है. यह सुविधा, ऑडिट जैसे कामों के लिए काम की है. इसकी मदद से, सटीक गतिविधियां वापस पाई जा सकती हैं. इनमें ActionDetail, Actor, और Target की जानकारी शामिल होती है.
Drive Activity API में
DriveActivity संसाधन शामिल होता है. यह संसाधन, उपयोगकर्ता के Google Drive में मौजूद ऑब्जेक्ट में किए गए बदलावों को दिखाता है. इसके अलावा, इसमें
activity.query तरीका भी शामिल होता है. इसकी मदद से, उन बदलावों के बारे में जानकारी वापस पाई जा सकती है.
अनुरोध
आपका ऐप्लिकेशन, उपयोगकर्ता की गतिविधि से जुड़ा डेटा पाने के लिए, activity.query तरीके का इस्तेमाल करता है. आपके पास किसी खास Drive आइटम या Drive फ़ोल्डर में मौजूद सभी चीज़ों के लिए, गतिविधि का अनुरोध करने का विकल्प होता है. किसी अनुरोध के लिए, आपके पास फ़िल्टर का इस्तेमाल करके, जवाब
को सीमित करने का विकल्प होता है. जैसे, समयसीमा
या कार्रवाई का टाइप. इसके अलावा, आपके पास जवाब में गतिविधि को कंसोलिडेट करने का विकल्प भी होता है. ज़्यादा जानकारी के लिए,
Google Drive Activity API में अनुरोध करना लेख पढ़ें.
जवाब
जवाब में, दिए गए पैरामीटर से मेल खाने वाली गतिविधियों की सूची शामिल होती है. इसमें,
हर DriveActivity संसाधन को हर
गतिविधि के तौर पर दिखाया जाता है:
DriveActivity संसाधन,
Action ऑब्जेक्ट का कलेक्शन होता है. इनमें से हर ऑब्जेक्ट,
इवेंट की तरह अपने-आप में पूरा होता है. एक Action में एक ActionDetail (जैसे, Create या Edit), एक Actor (जैसे, User या Administrator), एक Target (जैसे, DriveItem या Drive), और या तो एक
Timestamp
या TimeRange शामिल होता है.
एक DriveActivity संसाधन में खास जानकारी भी शामिल होती है. जैसे, सभी कार्रवाइयों से जुड़े हर
Actor और Target, एक जैसा Timestamp या TimeRange,
और Action का सबसे अहम या प्रतिनिधि ActionDetail.
ज़्यादा जानकारी के लिए, Drive Activity API डेटा मॉडल देखें.
गतिविधि के इतिहास की जानकारी की विज़िबिलिटी
Drive Activity API का इस्तेमाल करने पर, हो सकता है कि Drive पर की गई कुछ गतिविधियों की रिपोर्ट न मिले. एपीआई, किसी ऑब्जेक्ट में किए गए बदलाव की रिपोर्ट देगा या नहीं, यह इस बात पर निर्भर करता है कि आपके ऐप्लिकेशन में पुष्टि किए गए उपयोगकर्ता को वह बदलाव या बदलाव के बारे में जानकारी दिखती है या नहीं.
विज़िबिलिटी, ऑब्जेक्ट के लिए सेट की गई अनुमतियों पर आधारित होती है. Drive में फ़ाइलें और फ़ोल्डर शेयर करने के कई तरीके हैं:
अगर कोई लेखक किसी दस्तावेज़ को शेयर करता है, तो दस्तावेज़ की गतिविधि का इतिहास, बनाने वाले और उन उपयोगकर्ताओं, दोनों को दिखता है जिनके साथ इसे शेयर किया गया है.
अगर किसी दस्तावेज़ को किसी उपयोगकर्ता के साथ शेयर किया गया है और फिर उसे निजी बना दिया गया है, तो उपयोगकर्ता उस अवधि का पूरा गतिविधि इतिहास देख सकता है जब उसके पास ऐक्सेस था. हालांकि, अनुमतियां सीमित होने के बाद वह इतिहास नहीं देख सकता.
अगर किसी दस्तावेज़ को किसी उपयोगकर्ता के साथ कभी शेयर नहीं किया गया, तो वह उपयोगकर्ता कोई भी गतिविधि इतिहास नहीं देख सकता.
मिलते-जुलते विषय
- Drive Activity API का ज़्यादा से ज़्यादा फ़ायदा पाने के लिए, पहले अपने ऐप्लिकेशन को Google Drive API के साथ इंटिग्रेट करें
- Google Workspace के एपीआई की मदद से डेवलपमेंट करने के बारे में जानने के लिए, Google Workspace पर डेवलप करना लेख पढ़ें. इसमें प्रोजेक्ट बनाना या पुष्टि और अनुमति को मैनेज करना शामिल है.
- गतिविधियों के बारे में जानने के लिए, एपीआई का संदर्भ देखें.