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

এই ডকুমেন্টটি Google ড্রাইভ অ্যাক্টিভিটি API-এর একটি সারসংক্ষেপ প্রদান করে।

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

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

অনুরোধ

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

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

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

ড্রাইভ অ্যাক্টিভিটি API রেসপন্স বডি মেসেজের ব্যাখ্যা।
চিত্র ১. ড্রাইভ অ্যাক্টিভিটি 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 ড্রাইভ API এর সাথে একীভূত করুন।
  • Google Workspace API ব্যবহার করে ডেভেলপমেন্ট সম্পর্কে জানতে, যার মধ্যে একটি প্রকল্প তৈরি করা বা প্রমাণীকরণ এবং অনুমোদন পরিচালনা করা অন্তর্ভুক্ত, Develop on Google Workspace দেখুন।
  • কার্যকলাপ সম্পর্কে জানতে, API রেফারেন্স দেখুন।