ডেস্কটপ অ্যাপের ওভারভিউ

গুগল পিকার এপিআই হল ব্যবহারকারীদের গুগল ড্রাইভ ফাইল নির্বাচন বা আপলোড করার সুযোগ দেওয়ার একটি উপায়। ব্যবহারকারীরা আপনার ডেস্কটপ অ্যাপগুলিকে তাদের ড্রাইভ ডেটা অ্যাক্সেস করার অনুমতি দিতে পারেন, যা তাদের ফাইলগুলির সাথে ইন্টারঅ্যাক্ট করার জন্য একটি নিরাপদ এবং অনুমোদিত উপায় প্রদান করে।

ড্রাইভে সংরক্ষিত ফাইলগুলির জন্য Google Picker "ফাইল ওপেন" ডায়ালগ হিসেবে কাজ করে এবং এর বেশ কয়েকটি বৈশিষ্ট্য রয়েছে:

• গুগল ড্রাইভ ইউআই- এর মতোই দেখতে এবং অনুভব করা।
• ড্রাইভ ফাইলের প্রিভিউ এবং থাম্বনেইল ছবি দেখানো বেশ কয়েকটি ভিউ।
• ব্যবহারকারীর ডিফল্ট ব্রাউজারে একটি নতুন ট্যাবের মধ্যে Google Picker-এ একটি পুনঃনির্দেশ।

মনে রাখবেন যে Google Picker ব্যবহারকারীদের এক ফোল্ডার থেকে অন্য ফোল্ডারে ফাইলগুলি সংগঠিত, সরানো বা অনুলিপি করার অনুমতি দেয় না। ফাইলগুলি পরিচালনা করতে, আপনাকে Google Drive API অথবা Drive UI ব্যবহার করতে হবে।

পূর্বশর্ত

গুগল পিকার ব্যবহারকারী অ্যাপগুলিকে অবশ্যই বিদ্যমান সমস্ত পরিষেবার শর্তাবলী মেনে চলতে হবে। সবচেয়ে গুরুত্বপূর্ণ বিষয় হল, আপনার অনুরোধগুলিতে আপনাকে সঠিকভাবে নিজেকে চিহ্নিত করতে হবে।

আপনার অবশ্যই একটি গুগল ক্লাউড প্রকল্প থাকতে হবে।

আপনার পরিবেশ সেট আপ করুন

গুগল পিকার এপিআই ব্যবহার শুরু করতে, আপনাকে আপনার পরিবেশ সেট আপ করতে হবে।

API সক্রিয় করুন

গুগল এপিআই ব্যবহার করার আগে, আপনাকে গুগল ক্লাউড প্রোজেক্টে সেগুলি চালু করতে হবে। আপনি একটি গুগল ক্লাউড প্রোজেক্টে এক বা একাধিক এপিআই চালু করতে পারেন।

• গুগল ক্লাউড কনসোলে, গুগল পিকার এপিআই সক্ষম করুন।

  API সক্রিয় করুন

একটি API কী তৈরি করুন

API কী হলো একটি দীর্ঘ স্ট্রিং যার মধ্যে বড় এবং ছোট হাতের অক্ষর, সংখ্যা, আন্ডারস্কোর এবং হাইফেন থাকে, যেমন AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe । এই প্রমাণীকরণ পদ্ধতিটি বেনামে সর্বজনীনভাবে উপলব্ধ ডেটা অ্যাক্সেস করতে ব্যবহৃত হয়, যেমন "এই লিঙ্ক সহ ইন্টারনেটে যে কেউ" শেয়ারিং সেটিং ব্যবহার করে শেয়ার করা Google Workspace ফাইল। আরও বিস্তারিত জানার জন্য, API কী পরিচালনা করুন দেখুন।

একটি API কী তৈরি করতে:

1. গুগল ক্লাউড কনসোলে, মেনু menu > API এবং পরিষেবা > শংসাপত্রগুলিতে যান।

   শংসাপত্রগুলিতে যান

2. ক্রেডেনশিয়াল তৈরি করুন > API কী ক্লিক করুন।
3. আপনার নতুন API কী প্রদর্শিত হবে।
   • আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার API কী কপি করতে, "Copy content_copy এ ক্লিক করুন। API কীটি আপনার প্রকল্পের শংসাপত্রের "API Keys" বিভাগেও পাওয়া যাবে।
   • অননুমোদিত ব্যবহার রোধ করার জন্য, আমরা সুপারিশ করছি যে API কী কোথায় এবং কোন API-এর জন্য ব্যবহার করা যেতে পারে তা সীমাবদ্ধ করুন। আরও বিস্তারিত জানার জন্য, API সীমাবদ্ধতা যোগ করুন দেখুন।

একটি ডেস্কটপ অ্যাপের জন্য শংসাপত্র অনুমোদন করুন

আপনার অ্যাপে ব্যবহারকারীদের প্রমাণীকরণ এবং ব্যবহারকারীর ডেটা অ্যাক্সেস করার জন্য, আপনাকে এক বা একাধিক OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করতে হবে। Google এর OAuth সার্ভারগুলিতে একটি একক অ্যাপ সনাক্ত করতে একটি ক্লায়েন্ট আইডি ব্যবহার করা হয়। যদি আপনার অ্যাপ একাধিক প্ল্যাটফর্মে চলে, তাহলে আপনাকে প্রতিটি প্ল্যাটফর্মের জন্য একটি পৃথক ক্লায়েন্ট আইডি তৈরি করতে হবে।

1. গুগল ক্লাউড কনসোলে, মেনু menu > এ যানGoogle Auth platform > ক্লায়েন্ট ।

   ক্লায়েন্টদের তালিকায় যান

2. ক্লায়েন্ট তৈরি করুন ক্লিক করুন।
3. অ্যাপ্লিকেশনের ধরণ > ডেস্কটপ অ্যাপ ক্লিক করুন।
4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হবে।
5. তৈরি করুন ক্লিক করুন।

   নতুন তৈরি শংসাপত্রটি "OAuth 2.0 ক্লায়েন্ট আইডি" এর অধীনে প্রদর্শিত হবে।

অ্যাপগুলিকে পূর্বে প্রদত্ত ফাইলগুলির অনুমোদন পেতে, আপনাকে নিম্নলিখিত পদক্ষেপগুলি অনুসরণ করতে হবে:

1. আপনাকে drive.file , drive , অথবা drive.readonly স্কোপের সাথে একটি OAuth 2.0 টোকেন পেতে হবে এই নির্দেশাবলী ব্যবহার করে: Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা । স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google Drive API স্কোপ নির্বাচন করুন দেখুন।

2. ব্যবহারকারী পূর্বে যেসব ফাইলে অ্যাক্সেস দিয়েছেন সেগুলি পড়তে এবং সংশোধন করতে OAuth 2.0 টোকেনটি ড্রাইভ API-তে পাস করুন।

গুগল পিকারটি প্রদর্শন করুন

ডেস্কটপ অ্যাপের জন্য Google Picker API ব্যবহারকারীর ডিফল্ট ব্রাউজারে একটি নতুন ট্যাবের মধ্যে Google Picker-এ পুনঃনির্দেশিত হয়। ব্যবহারকারী অ্যাক্সেস দেওয়ার পরে এবং প্রাসঙ্গিক ফাইলগুলি বেছে নেওয়ার পরে, Google Picker কলব্যাক URL এর মাধ্যমে কলিং অ্যাপে ফিরে আসে। ক্লায়েন্ট পৃষ্ঠায় Google Picker API খোলার জন্য, ওয়েব অ্যাপের জন্য Google Picker API ব্যবহার করুন। আরও তথ্যের জন্য, ওয়েব অ্যাপের ওভারভিউ দেখুন।

ব্যবহারকারীদের অতিরিক্ত ফাইলগুলিতে অ্যাক্সেস দেওয়ার অনুমতি দিতে অথবা আপনার ডেস্কটপ অ্যাপ ফ্লোতে ব্যবহারের জন্য ফাইলগুলি বেছে নেওয়ার জন্য, এই পদক্ষেপগুলি অনুসরণ করুন:

1. এই নির্দেশাবলী ব্যবহার করে একটি নতুন ব্রাউজার ট্যাবে OAuth 2.0 অ্যাক্সেস পৃষ্ঠা খুলতে drive.file স্কোপে অ্যাক্সেসের অনুরোধ করুন: Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা । স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google Drive API স্কোপ নির্বাচন করুন দেখুন।

   মনে রাখবেন যে ডেস্কটপ অ্যাপের জন্য শুধুমাত্র drive.file স্কোপ অনুমোদিত এবং এটি অন্য কোনও স্কোপের সাথে একত্রিত করা যাবে না।

2. নতুন ব্রাউজার ট্যাবের URL সমস্ত স্ট্যান্ডার্ড OAuth কোয়েরি স্ট্রিং প্যারামিটার গ্রহণ করে।

   আপনার OAuth 2.0 অনুমোদন URL অনুরোধে prompt এবং trigger_onepick URL প্যারামিটার যুক্ত করতে হবে। আপনি বেশ কয়েকটি ঐচ্ছিক প্যারামিটার ব্যবহার করে Google Picker কাস্টমাইজ করতে পারেন:

   প্যারামিটার	বিবরণ	অবস্থা
   prompt=consent	ফাইল অ্যাক্সেসের জন্য অনুরোধ করুন।	প্রয়োজনীয়
   trigger_onepick=true	গুগল পিকার সক্ষম করুন।	প্রয়োজনীয়
   allow_multiple=true	যদি সত্য হয়, ব্যবহারকারীকে একাধিক ফাইল নির্বাচন করার অনুমতি দিন।	ঐচ্ছিক
   mimetypes= MIMETYPES	অনুসন্ধান ফলাফল ফিল্টার করার জন্য MIME প্রকারের একটি কমা দ্বারা পৃথক তালিকা। যদি সেট না করা থাকে, তাহলে সমস্ত MIME প্রকারের ফাইল ভিউতে প্রদর্শিত হবে।	ঐচ্ছিক
   file_ids= FILE_IDS	অনুসন্ধান ফলাফল ফিল্টার করার জন্য ফাইল আইডিগুলির একটি কমা দ্বারা পৃথক তালিকা। যদি সেট না করা থাকে, তাহলে সমস্ত ফাইল ভিউতে প্রদর্শিত হবে।	ঐচ্ছিক

   নিম্নলিখিত নমুনাটি একটি OAuth 2.0 অনুমোদনের URL অনুরোধ দেখায়:

   https://accounts.google.com/o/oauth2/v2/auth? \
   client_id=CLIENT_ID \
   &scope=https://www.googleapis.com/auth/drive.file \
   &redirect_uri=REDIRECT_URI \
   &response_type=code \
   &access_type=offline \
   &prompt=consent \
   &trigger_onepick=true
   

   নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

   • CLIENT_ID : আপনার ডেস্কটপ অ্যাপের ক্লায়েন্ট আইডি।

   • REDIRECT_URI : যেখানে অনুমোদন সার্ভার সফল প্রমাণীকরণের পরে ব্যবহারকারীর ব্রাউজারকে পুনঃনির্দেশিত করে। উদাহরণস্বরূপ, https://www.cymbalgroup.com/oauth2callback ।

     নির্দিষ্ট redirect_uri অবশ্যই একটি পাবলিক HTTPS URL হতে হবে। যদি আপনি আপনার redirect_uri এর জন্য একটি কাস্টম প্রোটোকল বা localhost URL ব্যবহার করতে চান, তাহলে আপনাকে একটি পাবলিক HTTPS URL ব্যবহার করতে হবে যা তারপর কাস্টম প্রোটোকল বা localhost URL এ পুনঃনির্দেশিত হয়।

3. ব্যবহারকারী একবার অ্যাক্সেস মঞ্জুর করে এবং প্রাসঙ্গিক ফাইলগুলি বেছে নেওয়ার পরে, OAuth অনুরোধে উল্লেখিত redirect_uri তে নিম্নলিখিত URL প্যারামিটারগুলি যুক্ত করে পুনঃনির্দেশিত করে:

   • picked_file_ids : যদি ব্যবহারকারী অ্যাক্সেস মঞ্জুর করে এবং ফাইলগুলি বেছে নেয়, তাহলে নির্বাচিত ফাইল আইডিগুলির একটি কমা দ্বারা পৃথক তালিকা।

   • code : অনুরোধে সেট করা response_type প্যারামিটারের উপর ভিত্তি করে অ্যাক্সেস টোকেন বা অ্যাক্সেস কোড। এই প্যারামিটারে একটি নতুন অনুমোদন কোড অন্তর্ভুক্ত রয়েছে।

   • scope : অনুরোধে অন্তর্ভুক্ত সুযোগ(গুলি)।

   • error : ব্যবহারকারী যদি সম্মতি প্রবাহের মধ্যে অনুরোধটি বাতিল করে থাকেন, তাহলে একটি ত্রুটি দেখানো হবে।

   নিম্নলিখিত নমুনাটি একটি OAuth 2.0 অনুমোদন URL প্রতিক্রিয়া দেখায়:

   https://REDIRECT_URI?picked_file_ids=PICKED_FILE_IDS&code=CODE&scope=SCOPES
   

4. অ্যাপগুলিকে ধাপ ৩ থেকে অনুমোদন কোড বিনিময় করে একটি নতুন OAuth 2.0 টোকেন তৈরি করতে হবে। আরও তথ্যের জন্য, রিফ্রেশ এবং অ্যাক্সেস টোকেনের জন্য এক্সচেঞ্জ অনুমোদন কোড দেখুন।

5. এরপর অ্যাপগুলি ধাপ ৩-এ থাকা URL প্যারামিটার থেকে ফাইল আইডি এবং ধাপ ৪-এ প্রাপ্ত OAuth 2.0 টোকেন ব্যবহার করে ড্রাইভ API কল করতে পারে। আরও তথ্যের জন্য, Google ড্রাইভ API ওভারভিউ দেখুন।