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

Google Drive Activity API में DriveActivity संसाधन शामिल है. यह उपयोगकर्ता के Google Drive में मौजूद ऑब्जेक्ट में किए गए बदलावों को दिखाता है. साथ ही, activity.query तरीके से उन बदलावों की जानकारी हासिल की जा सकती है.

अनुरोध

आपका ऐप्लिकेशन, activity.query तरीके का इस्तेमाल करके, उपयोगकर्ता की गतिविधि के डेटा का अनुरोध करता है. आपके पास Drive के किसी खास आइटम या Drive फ़ोल्डर में मौजूद सभी चीज़ों के लिए, गतिविधि का अनुरोध करने का विकल्प होता है. किसी भी अनुरोध के लिए, समयसीमा या कार्रवाई के टाइप जैसी शर्तों के हिसाब से जवाब को सीमित किया जा सकता है. साथ ही, इस गतिविधि को रिस्पॉन्स में एक साथ इकट्ठा करने का विकल्प भी चुना जा सकता है. ज़्यादा जानकारी के लिए, Drive Activity API में अनुरोध करना लेख पढ़ें.

जवाब

किसी अनुरोध का जवाब, दिए गए पैरामीटर से मेल खाने वाली गतिविधियों की सूची होती है, जहां DriveActivity संसाधन हर गतिविधि के बारे में बताता है:

Drive पर की गई गतिविधि के बारे में जानकारी.

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 Activity API का ज़्यादा से ज़्यादा फ़ायदा पाने के लिए, पहले अपने ऐप्लिकेशन को Google Drive API के साथ इंटिग्रेट करें. Drive Activity API का इस्तेमाल शुरू करने के लिए, प्रोजेक्ट बनाने और अनुरोध करने की अनुमति देने का तरीका जानें. इसके अलावा, एपीआई के रेफ़रंस में, गतिविधियों के बारे में ज़्यादा जानें और इनके बारे में पढ़ें.