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