Google Drive Activity API के बारे में जानकारी

इस दस्तावेज़ में, 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 संसाधन, हर गतिविधि को दिखाता है:

पहली इमेज. Drive Activity API के रिस्पॉन्स बॉडी मैसेज के बारे में जानकारी.

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 API का इस्तेमाल करके डेवलपमेंट करने के बारे में जानने के लिए, Google Workspace पर डेवलप करें लेख पढ़ें. इसमें प्रोजेक्ट बनाने, पुष्टि करने, और अनुमति देने के बारे में जानकारी दी गई है.
• गतिविधियों के बारे में जानने के लिए, एपीआई के बारे में जानकारी देखें.