ড্রাইভ কার্যকলাপ API v1 থেকে স্থানান্তর করুন

এই গাইডটি Google ড্রাইভ অ্যাক্টিভিটি API v1 এবং v2 এর মধ্যে পার্থক্য এবং v2 API সমর্থন করার জন্য আপনার v1 অ্যাপ্লিকেশনটি কীভাবে পরিবর্তন করবেন তা ব্যাখ্যা করে।

অনুমোদন

v1 API এই সুযোগ ব্যবহার করেছে:

  • https://www.googleapis.com/auth/activity

v2 API-এর জন্য নিম্নলিখিত স্কোপের একটি প্রয়োজন:

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

সম্পদের নাম

v1 API-এ, Google ড্রাইভ আইটেম এবং ব্যবহারকারীদের মতো অবজেক্টের শনাক্তকারী ছিল অস্বচ্ছ স্ট্রিং। v2 API-এ, এই বস্তুগুলি সাধারণত সম্পদের নাম ব্যবহার করে উল্লেখ করা হয়। আরও তথ্যের জন্য, ক্লাউড API ডিজাইন গাইড দেখুন।

এই শনাক্তকারী সাধারণত রূপান্তর করা যেতে পারে. উদাহরণ স্বরূপ, v2 API-এ ড্রাইভ আইটেমগুলিকে রিসোর্স নাম items/ ITEM_ID_V1 ব্যবহার করে উল্লেখ করা হয়েছে।

অনুরোধ

v2-এর অনুরোধ বিন্যাস v1-এর মতোই। বিশেষত, আপনি এখনও একটি ড্রাইভ ফাইল বা ড্রাইভ পূর্বপুরুষের জন্য কার্যকলাপের জন্য অনুরোধ করতে পারেন, যদিও মনে রাখবেন যে আপনাকে অবশ্যই সেই অনুরোধের পরামিতিগুলিকে items/ এর সাথে উপসর্গ দিয়ে সম্পদের নাম হিসাবে ফর্ম্যাট করতে হবে।

"গ্রুপিং" কে এখন বলা হয় একত্রীকরণ , এবং source এবং userId অনুরোধের পরামিতিগুলি সরানো হয়েছে৷

এছাড়াও নতুন ফিল্টার বিকল্প রয়েছে যা আপনাকে প্রতিক্রিয়াতে ফিরে আসা কার্যকলাপ ডেটার প্রকারগুলিকে সীমাবদ্ধ করতে দেয়৷

কর্ম

v1 এপিআই-এ, কার্যকলাপের ধরন এবং সেই কার্যকলাপের সাথে যুক্ত ডেটা আলাদা ক্ষেত্রগুলিতে ছিল। উদাহরণস্বরূপ, যদি primaryEventType ফিল্ডে ভ্যালু move থাকে, তাহলে অ্যাপ্লিকেশানগুলি অনুমান করবে যে একটি টপ-লেভেল move ফিল্ড যোগ করা এবং সরানো অভিভাবকদের দ্বারা পপুলেট করা হয়েছে৷

v2 API-এ, এই ক্ষেত্রগুলি আর আলাদা নয়। ActionDetail মেসেজে ঠিক একটি ফিল্ড সেট আছে। এটি কর্মের ধরণকে নির্দেশ করে এবং সেই কর্মের সাথে সম্পর্কিত বিশদ বিবরণ ধারণ করে। উদাহরণস্বরূপ, একটি পদক্ষেপের প্রতিনিধিত্বকারী একটি ActionDetail শুধুমাত্র move ক্ষেত্র সেট করে এবং সেই ক্ষেত্রটি যোগ করা এবং সরানো পিতামাতার তালিকা করে।

v1 API primaryEventType ক্ষেত্রটি মোটামুটিভাবে v2 primaryActionDetail এর সাথে মিলে যায়।

অভিনেতা

v1 API-এ, অভিনেতা একজন পরিচিত ব্যবহারকারী হলে ফেরত দেওয়া কার্যকলাপে একজন User থাকে এবং ঐচ্ছিকভাবে বিশেষ ক্ষেত্রে fromUserDeletion এর মতো একটি শীর্ষ-স্তরের ক্ষেত্র থাকে।

v2 API-এ, Actor প্রকারের একটি সমৃদ্ধ সেট উপলব্ধ, এবং user.knownUser পপুলেট করা হয় যখন অভিনেতা একজন পরিচিত ব্যবহারকারী হয়। যদি আপনার অ্যাপ্লিকেশনটির ব্যবহারকারীদের সম্পর্কে বিস্তারিত তথ্যের প্রয়োজন হয়, তাহলে এটি people.get পদ্ধতিতে KnownUser ফিল্ড personName পাস করে People API থেকে জিজ্ঞাসা করতে পারে।

টার্গেট

v1 API-এ, লক্ষ্যগুলি সর্বদা ড্রাইভ আইটেম ছিল। v2 API-এ, লক্ষ্যগুলি ড্রাইভে অন্য ধরনের অবজেক্ট হতে পারে। উদাহরণস্বরূপ, একটি ড্রাইভে পরিবর্তনের জন্য একটি লক্ষ্য ধরনের Drive থাকে। একটি শেয়ার্ড ড্রাইভের রুট ফোল্ডারটি এখনও ফেরত দেওয়া হয় ( root ক্ষেত্রের একটি DriveItem হিসাবে), তবে এটি কার্যকলাপের তাৎক্ষণিক লক্ষ্য নয়৷ অনুরূপ ধারণা একটি FileComment সম্পদের ক্ষেত্রে প্রযোজ্য, যার parent ক্ষেত্রটি লক্ষ্য মন্তব্য থ্রেড ধারণকারী ড্রাইভ আইটেমকে নির্দেশ করে।

একত্রিত কার্যকলাপ

v1 API-এ, একটি একত্রীকরণ ("গ্রুপিং") কৌশল সেট করা হলে প্রতিক্রিয়ার স্টাইল পরিবর্তিত হয়। বিশেষভাবে, যখন একত্রীকরণ চালু করা হয়েছিল, তখন প্রতিটি কার্যকলাপে উপাদান singleEvents এবং একটি combinedEvent থাকে যা সেই উপাদান ইভেন্টগুলির মধ্যে সাধারণ কার্যকলাপের সংক্ষিপ্ত বিবরণ দেয়। একত্রীকরণ বন্ধ করা হলে, combinedEvent ক্ষেত্রে প্রতিটি কার্যকলাপের জন্য মূল অসংহত ইভেন্ট থাকে। এই ইভেন্টগুলির যেকোনও একাধিক অ্যাকশনের প্রতিনিধিত্ব করতে পারে, যেমন একটি শেয়ারের সাথে তৈরি করা।

v2 API-এ, একত্রীকরণ কৌশলের উপর ভিত্তি করে প্রতিক্রিয়ার ধরন পরিবর্তিত হয় না, কারণ ফিরে আসা DriveActivity সর্বদা অভিনেতা, লক্ষ্য এবং ক্রিয়াগুলির সম্পূর্ণ সেট থাকে।