যখন একজন ব্যবহারকারী Drive UI এর "নতুন" বোতামে ক্লিক করেন এবং Drive UI তে একটি অ্যাপ নির্বাচন করেন, তখন Drive ব্যবহারকারীকে Configure a Drive UI ইন্টিগ্রেশনে সংজ্ঞায়িত সেই অ্যাপের New URL-এ পুনঃনির্দেশিত করে।
আপনার অ্যাপটি তখন একটি state প্যারামিটারের মধ্যে টেমপ্লেট ভেরিয়েবলের একটি ডিফল্ট সেট পাবে। একটি নতুন URL এর জন্য ডিফল্ট state তথ্য হল:
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
এই আউটপুটে নিম্নলিখিত মানগুলি অন্তর্ভুক্ত রয়েছে:
-
create: যে ক্রিয়াটি সম্পাদিত হচ্ছে। ব্যবহারকারী যখন ড্রাইভ UI এর "নতুন" বোতামে ক্লিক করেন তখন মানটিcreateহয়। - FOLDER_ID : মূল ফোল্ডারের আইডি।
- FOLDER_RESOURCE_KEY : প্যারেন্ট ফোল্ডারের রিসোর্স কী।
- USER_ID : প্রোফাইল আইডি যা ব্যবহারকারীকে অনন্যভাবে শনাক্ত করে।
আপনার অ্যাপকে এই অনুরোধের উপর এই পদক্ষেপগুলি অনুসরণ করে কাজ করতে হবে:
- যাচাই করুন যে
actionফিল্ডের একটি মানcreateআছে। - ব্যবহারকারীর জন্য একটি নতুন সেশন তৈরি করতে
userIdমান ব্যবহার করুন। সাইন-ইন করা ব্যবহারকারীদের সম্পর্কে আরও তথ্যের জন্য, ব্যবহারকারী এবং নতুন ইভেন্ট দেখুন। - ফাইল রিসোর্স তৈরি করতে
files.createপদ্ধতি ব্যবহার করুন। যদি অনুরোধেfolderIdসেট করা থাকে, তাহলেparentsফিল্ডটিকেfolderIdমানে সেট করুন। - যদি অনুরোধে
folderResourceKeyসেট করা থাকে, তাহলেX-Goog-Drive-Resource-Keysঅনুরোধ শিরোনাম সেট করুন। রিসোর্স কী সম্পর্কে আরও তথ্যের জন্য, রিসোর্স কী ব্যবহার করে লিঙ্ক-শেয়ার করা ফাইলগুলি অ্যাক্সেস করুন দেখুন।
state প্যারামিটারটি URL-এনকোডেড, তাই আপনার অ্যাপটিকে অবশ্যই এস্কেপ ক্যারেক্টারগুলি পরিচালনা করতে হবে এবং JSON হিসাবে পার্স করতে হবে।
ব্যবহারকারী এবং নতুন ইভেন্ট
ড্রাইভ অ্যাপগুলির সকল "তৈরি করুন" ইভেন্টকে সম্ভাব্য সাইন-ইন হিসেবে বিবেচনা করা উচিত। কিছু ব্যবহারকারীর একাধিক অ্যাকাউন্ট থাকতে পারে, তাই state প্যারামিটারে থাকা ব্যবহারকারী আইডি বর্তমান সেশনের সাথে নাও মিলতে পারে। যদি state প্যারামিটারে থাকা ব্যবহারকারী আইডি বর্তমান সেশনের সাথে না মেলে, তাহলে আপনার অ্যাপের বর্তমান সেশনটি শেষ করুন এবং অনুরোধকৃত ব্যবহারকারী হিসেবে সাইন ইন করুন।