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

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

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

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

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

পূর্বশর্ত

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

আপনার একটি Google ক্লাউড প্রকল্পও থাকতে হবে।

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

Google পিকার API ব্যবহার শুরু করতে, আপনাকে অবশ্যই আপনার পরিবেশ সেট আপ করতে হবে৷

API সক্ষম করুন

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

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

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

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

  1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।

    শংসাপত্রে যান

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

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

শেষ ব্যবহারকারীদের প্রমাণীকরণ করতে এবং আপনার অ্যাপে ব্যবহারকারীর ডেটা অ্যাক্সেস করতে, আপনাকে এক বা একাধিক OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করতে হবে। Google-এর OAuth সার্ভারে একটি একক অ্যাপ শনাক্ত করতে একটি ক্লায়েন্ট আইডি ব্যবহার করা হয়। যদি আপনার অ্যাপ একাধিক প্ল্যাটফর্মে চলে, তাহলে আপনাকে অবশ্যই প্রতিটি প্ল্যাটফর্মের জন্য একটি পৃথক ক্লায়েন্ট আইডি তৈরি করতে হবে।
  1. Google ক্লাউড কনসোলে, মেনু > এ যানGoogle Auth platform > ক্লায়েন্ট ।

    ক্লায়েন্টে যান

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

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

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

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

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

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

ডেস্কটপ অ্যাপের জন্য Google পিকার API ব্যবহারকারীর ডিফল্ট ব্রাউজারে একটি নতুন ট্যাবের মধ্যে Google পিকারে পুনঃনির্দেশ করে। ব্যবহারকারী একবার অ্যাক্সেস মঞ্জুর করে এবং প্রাসঙ্গিক ফাইল বাছাই করলে, Google পিকার কলব্যাক URL এর মাধ্যমে কলিং অ্যাপে ফিরে আসে। একটি ক্লায়েন্ট পৃষ্ঠায় Google পিকার API খুলতে, পরিবর্তে ওয়েব অ্যাপগুলির জন্য Google পিকার 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 পিকার কাস্টমাইজ করতে পারেন:

    প্যারামিটার বর্ণনা স্ট্যাটাস
    prompt=consent ফাইল অ্যাক্সেসের জন্য অনুরোধ করুন। প্রয়োজন
    trigger_onepick=true Google পিকার সক্রিয় করুন। প্রয়োজন
    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 জন্য একটি কাস্টম প্রোটোকল বা লোকালহোস্ট URL ব্যবহার করতে চান, তাহলে আপনাকে অবশ্যই একটি সর্বজনীন HTTPS URL ব্যবহার করতে হবে যা তারপর কাস্টম প্রোটোকল বা লোকালহোস্ট URL-এ পুনঃনির্দেশ করে৷

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

    • 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 টোকেনের জন্য ধাপ 3 থেকে অনুমোদন কোড বিনিময় করতে হবে৷ আরও তথ্যের জন্য, রিফ্রেশ এবং টোকেন অ্যাক্সেসের জন্য এক্সচেঞ্জ অনুমোদন কোড দেখুন।

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