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