এই ডকুমেন্টটিতে গুগল ড্রাইভ অ্যাক্টিভিটি এপিআই (Google Drive Activity API)-এর একটি সংক্ষিপ্ত বিবরণ দেওয়া হয়েছে।
ড্রাইভ অ্যাক্টিভিটি এপিআই আপনাকে সাম্প্রতিক ইভেন্টগুলো সম্পর্কে জানতে সাহায্য করে। আপনি প্রতিটি ইভেন্টের সূক্ষ্ম তথ্যসহ সমস্ত অ্যাক্টিভিটির একটি বিস্তারিত ইতিহাস পেতে পারেন। এটি অডিটের মতো কাজের জন্য উপযোগী, কারণ এর মাধ্যমে আপনি ActionDetail , Actor , এবং Target মতো তথ্যসহ সুনির্দিষ্ট অ্যাক্টিভিটিগুলো পুনরুদ্ধার করতে পারেন।
ড্রাইভ অ্যাক্টিভিটি এপিআই-এর মধ্যে রয়েছে DriveActivity রিসোর্স, যা একজন ব্যবহারকারীর গুগল ড্রাইভের অবজেক্টগুলোতে করা পরিবর্তনগুলোকে উপস্থাপন করে, এবং activity.query মেথড, যা আপনাকে সেই পরিবর্তনগুলো সম্পর্কে তথ্য পুনরুদ্ধার করতে দেয়।
অনুরোধ
আপনার অ্যাপ activity.query মেথড ব্যবহার করে একজন ব্যবহারকারীর অ্যাক্টিভিটি ডেটার জন্য অনুরোধ করে। আপনি একটি নির্দিষ্ট ড্রাইভ আইটেমের জন্য অথবা একটি ড্রাইভ ফোল্ডারের অধীনে থাকা সমস্ত কিছুর জন্য অ্যাক্টিভিটি অনুরোধ করতে পারেন। একটি নির্দিষ্ট অনুরোধের জন্য, আপনি সময়সীমা বা অ্যাকশন টাইপের মতো ফিল্টার ব্যবহার করে রেসপন্সকে সীমাবদ্ধ করতে পারেন এবং রেসপন্সে অ্যাক্টিভিটি একত্রিত করার বিকল্পও বেছে নিতে পারেন। আরও তথ্যের জন্য, `Make requests in the Google 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-এর সর্বোত্তম সুবিধা পেতে, প্রথমে আপনার অ্যাপটিকে Google Drive API-এর সাথে ইন্টিগ্রেট করুন।
- প্রজেক্ট তৈরি করা বা অথেনটিকেশন ও অথরাইজেশন পরিচালনা সহ গুগল ওয়ার্কস্পেস এপিআই ব্যবহার করে ডেভেলপ করার বিষয়ে জানতে, “ডেভেলপ অন গুগল ওয়ার্কস্পেস” দেখুন।
- কার্যকলাপ সম্পর্কে জানতে এপিআই রেফারেন্স দেখুন।