Google ড্রাইভ কার্যকলাপ API এর ভূমিকা

এই ডকুমেন্টটি Google Drive Activity API-এর একটি ওভারভিউ প্রদান করে।

ড্রাইভ কার্যকলাপ API আপনাকে সাম্প্রতিক ইভেন্টগুলির জন্য অনুসন্ধান করতে দেয়৷ আপনি প্রতিটি ইভেন্ট সম্পর্কে দানাদার তথ্য সহ সমস্ত কার্যকলাপের একটি বিশদ ইতিহাস আনতে পারেন। এটি অডিটের মতো কাজের জন্য উপযোগী কারণ আপনি ActionDetail , Actor , এবং Target তথ্য অন্তর্ভুক্ত করে সুনির্দিষ্ট কার্যকলাপগুলি পুনরুদ্ধার করতে পারেন৷

ড্রাইভ অ্যাক্টিভিটি এপিআই DriveActivity রিসোর্স নিয়ে গঠিত, যা ব্যবহারকারীর Google ড্রাইভের মধ্যে বস্তুতে করা পরিবর্তনগুলি এবং activity.query পদ্ধতির প্রতিনিধিত্ব করে, যা আপনাকে সেই পরিবর্তনগুলি সম্পর্কে তথ্য পুনরুদ্ধার করতে দেয়৷

অনুরোধ

activity.query পদ্ধতি ব্যবহার করে আপনার অ্যাপ ব্যবহারকারীর কার্যকলাপ ডেটার জন্য অনুরোধ করে। আপনি একটি নির্দিষ্ট ড্রাইভ আইটেমের জন্য বা ড্রাইভ ফোল্ডারের অধীনে থাকা সমস্ত কিছুর জন্য কার্যকলাপের জন্য অনুরোধ করতে পারেন৷ একটি প্রদত্ত অনুরোধের জন্য, আপনি একটি ফিল্টার ব্যবহার করে প্রতিক্রিয়া সীমিত করতে বেছে নিতে পারেন যেমন সময় সীমা বা কর্মের ধরন, এবং আপনি প্রতিক্রিয়াতে কার্যকলাপ একত্রিত করা বেছে নিতে পারেন। আরও তথ্যের জন্য, Google ড্রাইভ অ্যাক্টিভিটি API-তে অনুরোধ করুন দেখুন।

প্রতিক্রিয়া

প্রতিক্রিয়াটিতে প্রদত্ত পরামিতিগুলির সাথে মিলে যাওয়া ক্রিয়াকলাপের একটি তালিকা রয়েছে, যেখানে একটি DriveActivity সংস্থান প্রতিটি কার্যকলাপের প্রতিনিধিত্ব করে:

ড্রাইভ কার্যকলাপ API প্রতিক্রিয়া বডি মেসেজের ব্যাখ্যা।
চিত্র 1. ড্রাইভ কার্যকলাপ API প্রতিক্রিয়া বডি বার্তার ব্যাখ্যা।

একটি DriveActivity রিসোর্স হল Action অবজেক্টের একটি সংগ্রহ, যার প্রতিটি ইভেন্টের মতো স্বয়ংসম্পূর্ণ। একটি Action মধ্যে একটি ActionDetail (যেমন Create বা Edit ), একজন Actor (যেমন User বা Administrator ), একটি Target (যেমন DriveItem বা Drive ), এবং হয় একটি Timestamp বা TimeRange অন্তর্ভুক্ত থাকে।

একটি DriveActivity রিসোর্সে সংক্ষিপ্ত তথ্যও থাকে, যেমন প্রতিটি Actor এবং সমস্ত অ্যাকশন থেকে Target , একটি ইউনিফাইড Timestamp বা TimeRange এবং হয় Action সবচেয়ে গুরুত্বপূর্ণ বা প্রতিনিধিত্বমূলক ActionDetail

আরও তথ্যের জন্য, ড্রাইভ কার্যকলাপ API ডেটা মডেল দেখুন।

কার্যকলাপ ইতিহাস দৃশ্যমানতা

আপনি যখন ড্রাইভ অ্যাক্টিভিটি API ব্যবহার করেন তখন ড্রাইভে কিছু কার্যকলাপ প্রতিবেদন করা নাও হতে পারে৷ API একটি বস্তুর প্রদত্ত পরিবর্তনের প্রতিবেদন করে কিনা তা নির্ভর করে পরিবর্তনটি, বা পরিবর্তন সম্পর্কে তথ্য, আপনার অ্যাপে প্রমাণীকৃত ব্যবহারকারীর কাছে দৃশ্যমান কিনা তার উপর।

দৃশ্যমানতা বস্তুর জন্য সেট করা অনুমতির উপর ভিত্তি করে। ড্রাইভে ফাইল এবং ফোল্ডার শেয়ার করা হলে বিভিন্ন পরিস্থিতিতে আছে:

  • যদি একজন লেখক একটি দস্তাবেজ শেয়ার করেন, তাহলে নথিটির কার্যকলাপের ইতিহাস নির্মাতা এবং ব্যবহারকারী উভয়ের কাছে দৃশ্যমান হয় যাদের সাথে এটি ভাগ করা হয়েছে৷

  • যদি কোনো ডকুমেন্ট কোনো ব্যবহারকারীর সাথে শেয়ার করা হয় এবং তারপরে ব্যক্তিগত করা হয়, ব্যবহারকারী তার অ্যাক্সেস থাকার সময় থেকে সমস্ত কার্যকলাপের ইতিহাস দেখতে পারে, কিন্তু অনুমতি সীমাবদ্ধ হওয়ার পরে নয়।

  • যদি কোনো ডকুমেন্ট কখনোই কোনো ব্যবহারকারীর সাথে শেয়ার করা না হয়, তাহলে ব্যবহারকারী কোনো কার্যকলাপের ইতিহাস দেখতে পাবে না।

  • ড্রাইভ অ্যাক্টিভিটি API থেকে সর্বাধিক সুবিধা পেতে, প্রথমে Google Drive API-এর সাথে আপনার অ্যাপকে একীভূত করুন৷
  • একটি প্রোজেক্ট তৈরি করা বা প্রমাণীকরণ এবং অনুমোদন পরিচালনা সহ Google Workspace API-এর সাথে ডেভেলপ করা সম্পর্কে জানতে, Google Workspace-এ Develop দেখুন।
  • কার্যকলাপ সম্পর্কে জানতে, API রেফারেন্স দেখুন।