Google Drive Activity API में DriveActivity संसाधन शामिल है. यह उपयोगकर्ता के Google Drive में मौजूद ऑब्जेक्ट में किए गए बदलावों को दिखाता है. साथ ही, activity.query तरीके से उन बदलावों की जानकारी हासिल की जा सकती है.
अनुरोध
आपका ऐप्लिकेशन, activity.query तरीके का इस्तेमाल करके, उपयोगकर्ता की गतिविधि के डेटा का अनुरोध करता है. आपके पास Drive के किसी खास आइटम या Drive फ़ोल्डर में मौजूद सभी चीज़ों के लिए, गतिविधि का अनुरोध करने का विकल्प होता है. किसी अनुरोध के लिए, सीमाओं के हिसाब से जवाब पर पाबंदी लगाई जा सकती है. जैसे, समयसीमा या कार्रवाई का टाइप. साथ ही, जवाब में गतिविधि को एक साथ दिखाया जा सकता है. ज़्यादा जानकारी के लिए, Drive गतिविधि एपीआई में अनुरोध करना लेख पढ़ें.
जवाब
किसी अनुरोध का जवाब, दिए गए पैरामीटर से मैच करने वाली गतिविधियों की सूची होती है. इसमें, 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 पर की गई कुछ गतिविधि की रिपोर्ट न की जाए. Drive Activity API किसी ऑब्जेक्ट में किए गए बदलाव की रिपोर्ट करता है या नहीं, यह इस बात पर निर्भर करता है कि आपके ऐप्लिकेशन में पुष्टि किए गए उपयोगकर्ता को बदलाव या बदलाव की जानकारी दिख रही है या नहीं.
ऑब्जेक्ट के लिए सेट की गई अनुमतियों के आधार पर, यह तय होता है कि उसे कौन देख सकता है. Drive में फ़ाइलें और फ़ोल्डर शेयर करने के कई तरीके हैं:
- अगर कोई लेखक कोई दस्तावेज़ शेयर करता है, तो उस दस्तावेज़ की गतिविधि का इतिहास, न सिर्फ़ उसके क्रिएटर को दिखता है, बल्कि उन उपयोगकर्ताओं को भी दिखता है जिनके साथ दस्तावेज़ शेयर किया गया है.
- अगर किसी उपयोगकर्ता के साथ कोई दस्तावेज़ शेयर किया गया था और फिर उसे निजी के तौर पर सेट किया गया था, तो पुष्टि किए गए उपयोगकर्ता को उस दस्तावेज़ में की गई सभी गतिविधियों का इतिहास दिख सकता है. साथ ही, वह यह भी देख सकता है कि अब उस दस्तावेज़ के लिए अनुमतियां सीमित कर दी गई हैं.
- अगर किसी उपयोगकर्ता के साथ कोई दस्तावेज़ कभी शेयर नहीं किया गया है, तो वह उपयोगकर्ता कोई गतिविधि का इतिहास नहीं देख सकता.
अपनी प्रोफ़ाइल बनाना शुरू करें
Drive गतिविधि एपीआई का ज़्यादा से ज़्यादा फ़ायदा पाने के लिए, पहले अपने ऐप्लिकेशन को Google Drive API के साथ इंटिग्रेट करें. Drive Activity API का इस्तेमाल शुरू करने के लिए, प्रोजेक्ट बनाने और अनुरोधों को अनुमति देने का तरीका जानें. इसके अलावा, सीधे एपीआई रेफ़रंस में जाकर, गतिविधियों के बारे में पढ़ें.