যাচাইকরণ ও অনুমোদন হল এমন মেকানিজম যা যথাক্রমে পরিচয় ও রিসোর্স অ্যাক্সেস যাচাই করতে ব্যবহার করা হয়। Chat অ্যাপ ও Chat API অনুরোধের জন্য যাচাইকরণ ও অনুমোদন কীভাবে কাজ করে তা এই ডকুমেন্টে উল্লেখ করা হয়েছে।
প্রসেস, এক নজরে
নিচের ডায়াগ্রামে Google Chat-এর জন্য যাচাইকরণ ও অনুমোদনের উচ্চ-স্তরের ধাপগুলি দেখানো হয়েছে:
Google Cloud প্রোজেক্ট কনফিগার করুন, Chat API চালু করুন এবং আপনার Chat অ্যাপ কনফিগার করুন: ডেভেলপমেন্টের সময়, আপনি একটি Google Cloud প্রোজেক্ট তৈরি করেন। Google Cloud প্রোজেক্টে, আপনি Chat API চালু করেন, আপনার Chat অ্যাপ কনফিগার করেন এবং যাচাইকরণ সেট-আপ করেন। আরও তথ্যের জন্য, Google Workspace-এ ডেভেলপ করুন এবং Chat অ্যাপ তৈরি করুন দেখুন।
Chat API কল করা: আপনার অ্যাপ Chat API কল করলে, এটি Chat API-তে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল পাঠায়। আপনার অ্যাপ যদি কোনও পরিষেবা অ্যাকাউন্টের মাধ্যমে যাচাই করে, তাহলে ক্রেডেনশিয়াল আপনার অ্যাপের কোডের অংশ হিসেবে পাঠানো হয়। আপনার অ্যাপের যদি Chat API কল করার প্রয়োজন হয় এবং ব্যবহারকারীর যাচাইকরণ এখনও অনুমোদিত না হয়, তাহলে এটি ব্যবহারকারীকে সাইন-ইন করার জন্য প্রম্পট করে।
রিসোর্সের জন্য অনুরোধ করা: আপনার অ্যাপ স্কোপ সহ অ্যাক্সেসের জন্য অনুরোধ করে যা আপনি যাচাইকরণ সেট-আপ করার সময় উল্লেখ করেন।
সম্মতি চাওয়া: আপনার অ্যাপ ব্যবহারকারী হিসেবে যাচাই করলে, Google একটি OAuth সম্মতি স্ক্রিন দেখায় যাতে ব্যবহারকারী সিদ্ধান্ত নিতে পারেন যে আপনার অ্যাপকে অনুরোধ করা ডেটায় অ্যাক্সেস দেবেন কিনা। পরিষেবা অ্যাকাউন্টের মাধ্যমে যাচাইকরণের জন্য ব্যবহারকারীর সম্মতির প্রয়োজন হয় না।
রিসোর্সের জন্য অনুমোদিত অনুরোধ পাঠানো: ব্যবহারকারী অনুমোদনের স্কোপে সম্মতি দিলে, আপনার অ্যাপ ক্রেডেনশিয়াল ও ব্যবহারকারীর অনুমোদন করা স্কোপকে একটি অনুরোধে বান্ডেল করে। অ্যাক্সেস টোকেন পেতে Google-এর অনুমোদন সার্ভারে অনুরোধ পাঠানো হয়।
Google একটি অ্যাক্সেস টোকেন ফেরত পাঠায়: অ্যাক্সেস টোকেনে অনুমোদিত স্কোপের একটি তালিকা থাকে। ফেরত আসা স্কোপের তালিকা অনুরোধ করা স্কোপের থেকে বেশি সীমাবদ্ধ হলে, আপনার অ্যাপ টোকেন দ্বারা সীমিত যেকোনও ফিচার বন্ধ করে দেয়।
অনুরোধ করা রিসোর্স অ্যাক্সেস করা: Chat API কল করতে এবং Chat API রিসোর্স অ্যাক্সেস করতে আপনার অ্যাপ Google থেকে অ্যাক্সেস টোকেন ব্যবহার করে।
রিফ্রেশ টোকেন পান (ঐচ্ছিক): আপনার অ্যাপকে যদি একটি অ্যাক্সেস টোকেনের লাইফটাইমের পরেও Google Chat API অ্যাক্সেস করতে হয়, তাহলে এটি একটি রিফ্রেশ টোকেন পেতে পারে। আরও তথ্যের জন্য, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করুন দেখুন।
আরও রিসোর্সের জন্য অনুরোধ করা: আপনার অ্যাপের আরও অ্যাক্সেসের প্রয়োজন হলে, এটি ব্যবহারকারীকে নতুন স্কোপের অনুমতি দিতে বলে, যার ফলে অ্যাক্সেস টোকেন পাওয়ার জন্য একটি নতুন অনুরোধ করা হয় (ধাপ ৩-৬)।
Chat অ্যাপের জন্য যাচাইকরণের প্রয়োজন হলে
Chat অ্যাপ ব্যবহারকারীর ইন্টার্যাকশনের উত্তরে বা অ্যাসিঙ্ক্রোনাসভাবে মেসেজ পাঠাতে পারে। এছাড়াও, তারা ব্যবহারকারীর হয়ে টাস্ক সম্পূর্ণ করতে পারে, যেমন Chat স্পেস তৈরি করা বা Chat স্পেসে থাকা লোকজনের তালিকা পাওয়া।
Chat অ্যাপকে কোনও ব্যবহারকারীর ইন্টার্যাকশনের উত্তর দেওয়ার জন্য যাচাইকরণের প্রয়োজন হয় না, যদি না Chat অ্যাপ কোনও উত্তর প্রসেস করার সময় Chat API বা অন্য কোনও Google API-কে কল করে।
সিঙ্ক না করা মেসেজ পাঠাতে বা ব্যবহারকারীর হয়ে টাস্ক সম্পূর্ণ করতে, Chat অ্যাপ RESTful অনুরোধ Chat API-তে পাঠায়, যার জন্য যাচাইকরণ ও অনুমোদনের প্রয়োজন হয়।
ব্যবহারকারীর ইন্টার্যাকশনের উত্তরে যাচাইকরণের প্রয়োজন নেই
Google Chat অ্যাপকে ব্যবহারকারী হিসেবে যাচাই করতে হয় না অথবা ব্যবহারকারীর ইন্টার্যাকশন রিসিভ করতে ও সিঙ্ক করে উত্তর দিতে Chat অ্যাপকে যাচাই করতে হয় না।
ব্যবহারকারী যখনই কোনও Chat অ্যাপের সাথে ইন্টার্যাক্ট করেন বা সেটি চালু করেন, তখনই Chat অ্যাপ ইভেন্ট অবজেক্ট পায়, যার মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত থাকে:
- কোনও ব্যবহারকারী Chat অ্যাপে মেসেজ পাঠান।
- কোনও ব্যবহারকারী Chat অ্যাপে @উল্লেখ করেন।
- ব্যবহারকারী Chat অ্যাপের কোনও একটি কমান্ড চালু করেন।
নিম্নলিখিত ডায়াগ্রামটি Chat ব্যবহারকারী এবং Chat অ্যাপের মধ্যে অনুরোধ-প্রতিক্রিয়ার ক্রম দেখায়:
- ব্যবহারকারী Google Chat-এ Chat অ্যাপে মেসেজ পাঠান।
- Google Chat অ্যাপে মেসেজটি ফরওয়ার্ড করে।
- অ্যাপটি মেসেজটি গ্রহণ করে, এটি প্রসেস করে এবং Google Chat-এ একটি উত্তর ফেরত পাঠায়।
- Google Chat ব্যবহারকারীর জন্য বা কোনও স্পেসে উত্তর রেন্ডার করে।
প্রতিটি Chat অ্যাপ ব্যবহারকারীর ইন্টার্যাকশনের জন্য এই ক্রম পুনরাবৃত্তি হয়।
অ্যাসিঙ্ক্রোনাস মেসেজ যাচাই করতে হবে
Chat অ্যাপ Chat API-তে অনুরোধ করলে, সিঙ্ক না করা মেসেজ পাঠানো হয়, যার জন্য যাচাইকরণ ও অনুমোদনের প্রয়োজন হয়।
Chat API কল করার মাধ্যমে, Chat অ্যাপ Google Chat-এ মেসেজ পোস্ট করতে পারে অথবা ব্যবহারকারীর হয়ে টাস্ক সম্পূর্ণ করতে ও ডেটা অ্যাক্সেস করতে পারে। যেমন, সার্ভার আউট হয়ে গেছে শনাক্ত করার পরে, Chat অ্যাপ Chat API-কে কল করতে পারে:
- আউটেজ তদন্ত ও সমাধান করার জন্য একটি Chat স্পেস তৈরি করুন।
- Chat স্পেসে লোকজনকে যোগ করুন।
- আউটেজ সম্পর্কে বিস্তারিত তথ্য দিতে Chat স্পেসে মেসেজ পোস্ট করুন।
নিচের ডায়াগ্রামে Chat অ্যাপ ও Chat স্পেসের মধ্যে অ্যাসিঙ্ক্রোনাস মেসেজের ক্রম দেখানো হয়েছে:
- Chat অ্যাপ
spaces.messages.createপদ্ধতি ব্যবহার করে Chat API কল করার মাধ্যমে মেসেজ তৈরি করে এবং HTTP অনুরোধে ব্যবহারকারীর ক্রেডেনশিয়াল অন্তর্ভুক্ত করে। - Google Chat, পরিষেবা অ্যাকাউন্ট বা ব্যবহারকারীর ক্রেডেনশিয়াল দিয়ে Chat অ্যাপ যাচাই করে।
- Google Chat নির্দিষ্ট Chat স্পেসে অ্যাপের মেসেজ রেন্ডার করে।
Chat API স্কোপ
OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করুন এবং স্কোপ বেছে নিন যাতে ব্যবহারকারী ও অ্যাপ রিভিউয়ারদের কোন তথ্য দেখানো হবে তা নির্ধারণ করা যায় এবং আপনার অ্যাপ রেজিস্টার করুন যাতে পরে সেটি প্রকাশ করতে পারেন।
আপনার অ্যাপকে যে লেভেলের অ্যাক্সেস দেওয়া হয়েছে তা নির্ধারণ করতে, আপনাকে অনুমোদনের স্কোপ শনাক্ত ও ঘোষণা করতে হবে। অনুমোদনের স্কোপ হল একটি OAuth 2.0 URI স্ট্রিং যাতে Google Workspace অ্যাপের নাম, এটি কী ধরনের ডেটা অ্যাক্সেস করে এবং অ্যাক্সেসের লেভেল থাকে।
সংবেদনশীল নয় এমন স্কোপ
| স্কোপ কোড | বিবরণ |
|---|---|
https://www.googleapis.com/auth/chat.bot
|
Chat অ্যাপকে চ্যাট দেখতে এবং মেসেজ পাঠাতে দেয়। এই স্কোপে শুধু পরিষেবা অ্যাকাউন্টের সাথে অ্যাপ যাচাইকরণ কাজ করে। আপনি ব্যবহারকারীর ক্রেডেনশিয়াল বা ডোমেন-জুড়ে ডেলিগেশন ব্যবহার করে এই স্কোপের মাধ্যমে যাচাই করতে পারবেন না। |
সংবেদনশীল স্কোপ
| স্কোপ কোড | বিবরণ |
|---|---|
https://www.googleapis.com/auth/chat.spaces
|
Chat-এ কথোপকথন ও স্পেস তৈরি করে এবং মেটাডেটা (ইতিহাস সেটিংস ও অ্যাক্সেস সেটিংস সহ) দেখে বা এডিট করে। |
https://www.googleapis.com/auth/chat.spaces.create
|
Chat-এ নতুন কথোপকথন তৈরি করুন। |
https://www.googleapis.com/auth/chat.spaces.readonly
|
Chat-এ চ্যাট ও স্পেস দেখুন। |
https://www.googleapis.com/auth/chat.memberships
|
Chat-এ হওয়া কথোপকথনে সদস্যদের দেখা, যোগ করা, আপডেট করা এবং তাদের সরিয়ে দেওয়া। |
https://www.googleapis.com/auth/chat.memberships.app
|
Google Chat-এর কথোপকথনে নিজেকে যোগ করা এবং এর থেকে সরিয়ে দেওয়া। |
https://www.googleapis.com/auth/chat.memberships.readonly
|
Chat কথোপকথনে থাকা মেম্বারদের দেখুন। |
https://www.googleapis.com/auth/chat.messages.create
|
Chat-এ মেসেজ কম্পোজ করা ও পাঠানো। |
https://www.googleapis.com/auth/chat.messages.reactions
|
Google Chat-এর মেসেজে প্রতিক্রিয়া দেখা, যোগ করা ও মুছে দেওয়া। |
https://www.googleapis.com/auth/chat.messages.reactions.create
|
Chat-এ মেসেজে প্রতিক্রিয়া যোগ করুন। |
https://www.googleapis.com/auth/chat.messages.reactions.readonly
|
Chat-এ কোনও মেসেজে প্রতিক্রিয়া দেখুন। |
https://www.googleapis.com/auth/chat.users.readstate
|
Chat কথোপকথনের জন্য শেষ পড়ার সময় দেখুন ও পরিবর্তন করুন। |
https://www.googleapis.com/auth/chat.users.readstate.readonly
|
Chat কথোপকথন শেষবার কখন পড়া হয়েছে তা দেখা। |
https://www.googleapis.com/auth/chat.admin.spaces.readonly
|
Chat-এ অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন চ্যাট ও স্পেস দেখুন। |
https://www.googleapis.com/auth/chat.admin.spaces
|
Chat-এ অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন চ্যাট ও স্পেস দেখা বা এডিট করা। |
https://www.googleapis.com/auth/chat.admin.memberships.readonly
|
Chat-এ অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন কথোপকথনে মেম্বার ও ম্যানেজারদের দেখতে |
https://www.googleapis.com/auth/chat.admin.memberships
|
Chat-এ অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন কথোপকথনে মেম্বার ও ম্যানেজারদের দেখা, যোগ করা, আপডেট করা ও সরানো। |
https://www.googleapis.com/auth/chat.app.spaces
|
Chat অ্যাপ হিসেবে Chat-এ কথোপকথন ও স্পেস তৈরি করা এবং মেটাডেটা (ইতিহাস সেটিংস ও অ্যাক্সেস সেটিংস সহ) দেখা বা আপডেট করা। অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপে শুধু পরিষেবা অ্যাকাউন্টের সাথে অ্যাপ যাচাইকরণ কাজ করে। আপনি ব্যবহারকারীর ক্রেডেনশিয়াল বা ডোমেন-জুড়ে ডেলিগেশন ব্যবহার করে এই স্কোপের মাধ্যমে যাচাই করতে পারবেন না। |
https://www.googleapis.com/auth/chat.app.spaces.readonly
|
Chat অ্যাপ হিসেবে Chat-এ মেটাডেটা (ইতিহাস সেটিংস সহ) দেখুন। এর জন্য অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপে শুধু পরিষেবা অ্যাকাউন্টের সাথে অ্যাপ যাচাইকরণ কাজ করে। আপনি ব্যবহারকারীর ক্রেডেনশিয়াল বা ডোমেন-জুড়ে ডেলিগেশন ব্যবহার করে এই স্কোপের মাধ্যমে যাচাই করতে পারবেন না। |
https://www.googleapis.com/auth/chat.app.spaces.create
|
Chat অ্যাপ হিসেবে Chat-এ নতুন কথোপকথন ও স্পেস তৈরি করুন। এর জন্য অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপে শুধু পরিষেবা অ্যাকাউন্টের সাথে অ্যাপ যাচাইকরণ কাজ করে। আপনি ব্যবহারকারীর ক্রেডেনশিয়াল বা ডোমেন-জুড়ে ডেলিগেশন ব্যবহার করে এই স্কোপের মাধ্যমে যাচাই করতে পারবেন না। |
https://www.googleapis.com/auth/chat.app.memberships
|
Chat অ্যাপ হিসেবে Chat-এ কথোপকথন ও স্পেসের মেম্বারদের দেখা, যোগ করা, আপডেট করা ও মুছে ফেলা। অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপে শুধু পরিষেবা অ্যাকাউন্টের সাথে অ্যাপ যাচাইকরণ কাজ করে। আপনি ব্যবহারকারীর ক্রেডেনশিয়াল বা ডোমেন-জুড়ে ডেলিগেশন ব্যবহার করে এই স্কোপের মাধ্যমে যাচাই করতে পারবেন না। |
https://www.googleapis.com/auth/chat.app.memberships.readonly
|
Chat অ্যাপ হিসেবে Chat-এ কথোপকথন ও স্পেস থেকে মেম্বারদের দেখুন। অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপে শুধু পরিষেবা অ্যাকাউন্টের সাথে অ্যাপ যাচাইকরণ কাজ করে। আপনি ব্যবহারকারীর ক্রেডেনশিয়াল বা ডোমেন-জুড়ে ডেলিগেশন ব্যবহার করে এই স্কোপের মাধ্যমে যাচাই করতে পারবেন না। |
https://www.googleapis.com/auth/chat.customemojis
|
Chat-এ কাস্টম ইমোজি দেখা, তৈরি করা ও মোছা। |
https://www.googleapis.com/auth/chat.customemojis.readonly
|
Chat-এ কাস্টম ইমোজি দেখা। |
https://www.googleapis.com/auth/chat.users.spacesettings
|
Chat ব্যবহারকারীর স্পেস সেটিংস দেখা ও আপডেট করা। |
https://www.googleapis.com/auth/chat.users.sections
|
Chat-এ আপনার বিভাগ দেখা, তৈরি করা, আপডেট করা ও মুছে ফেলা; Chat-এ আপনার বিভাগের আইটেম সরানো ও তালিকাভুক্ত করা। |
https://www.googleapis.com/auth/chat.users.sections.readonly
|
Chat-এ আপনার বিভাগ ও সেগুলির বিভাগ আইটেম দেখা। |
বিধিনিষেধযুক্ত স্কোপ
| স্কোপ কোড | বিবরণ |
|---|---|
https://www.googleapis.com/auth/chat.delete
|
Chat-এ কথোপকথন ও স্পেস মুছে দেওয়া এবং সেই সম্পর্কিত ফাইলের অ্যাক্সেস সরানো। |
https://www.googleapis.com/auth/chat.import
|
Chat-এ স্পেস, মেসেজ ও মেম্বারশিপ ইমপোর্ট করা। আরও তথ্যের জন্য, ডেটা ইমপোর্ট করার জন্য Chat অ্যাপকে অনুমতি দিন দেখুন |
https://www.googleapis.com/auth/chat.messages
|
মেসেজ দেখা, কম্পোজ করা, পাঠানো, আপডেট করা ও মুছে ফেলা এবং মেসেজে প্রতিক্রিয়া যোগ করা, দেখা ও মুছে ফেলা। |
https://www.googleapis.com/auth/chat.messages.readonly
|
Chat-এ মেসেজ ও প্রতিক্রিয়া দেখা। |
https://www.googleapis.com/auth/chat.app.messages.readonly
|
Chat অ্যাপ হিসেবে Chat-এ মেসেজ ও প্রতিক্রিয়া দেখা। অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপে শুধু পরিষেবা অ্যাকাউন্টের সাথে অ্যাপ যাচাইকরণ কাজ করে। আপনি ব্যবহারকারীর ক্রেডেনশিয়াল বা ডোমেন-জুড়ে ডেলিগেশন ব্যবহার করে এই স্কোপের মাধ্যমে যাচাই করতে পারবেন না। |
https://www.googleapis.com/auth/chat.admin.delete
|
অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন কথোপকথন ও স্পেস মুছে দেয় এবং Chat-এ সংশ্লিষ্ট ফাইল থেকে অ্যাক্সেস সরিয়ে দেয়। |
https://www.googleapis.com/auth/chat.app.delete
|
Chat অ্যাপ হিসেবে Chat-এ কথোপকথন ও স্পেস মুছে দেওয়া এবং সংশ্লিষ্ট ফাইল থেকে অ্যাক্সেস সরিয়ে দেওয়া। অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপে শুধু পরিষেবা অ্যাকাউন্টের সাথে অ্যাপ যাচাইকরণ কাজ করে। আপনি ব্যবহারকারীর ক্রেডেনশিয়াল বা ডোমেন-জুড়ে ডেলিগেশন ব্যবহার করে এই স্কোপের মাধ্যমে যাচাই করতে পারবেন না। |
আগের সারণীতে উল্লেখ করা স্কোপগুলি তাদের সংবেদনশীলতা নির্দেশ করে, যা নিম্নলিখিত সংজ্ঞা অনুসারে নির্ধারিত হয়:
সংবেদনশীল নয়—এইসব স্কোপ অনুমোদনের অ্যাক্সেসের সবচেয়ে ছোট ক্ষেত্র প্রদান করে এবং এগুলির জন্য শুধু বেসিক অ্যাপ যাচাইকরণ প্রয়োজন হয়। এই প্রয়োজনীয়তা সম্পর্কে তথ্যের জন্য, যাচাইকরণের জন্য প্রস্তুতি নেওয়ার ধাপ দেখুন।
সংবেদনশীল—এইসব স্কোপ আপনার অ্যাপকে কোনও নির্দিষ্ট ব্যবহারকারীর Google ডেটা অ্যাক্সেস করার অনুমতি দেয়, তবে তার জন্য ব্যবহারকারীর থেকে অনুমোদন পেতে হয়। এর জন্য আপনাকে অতিরিক্ত অ্যাপ যাচাইকরণ করতে হবে। এই প্রয়োজনীয়তা সম্পর্কে আরও জানতে, সংবেদনশীল স্কোপের জন্য অনুরোধ করা অ্যাপের জন্য ধাপ দেখুন।
সীমাবদ্ধ—এইসব স্কোপ Google ব্যবহারকারীর ডেটায় ব্যাপক অ্যাক্সেস প্রদান করে এবং আপনাকে সীমাবদ্ধ স্কোপ যাচাইকরণ প্রসেসের মধ্যে দিয়ে যেতে হয়। এই প্রয়োজনীয়তা সম্পর্কে তথ্য পেতে, Google API পরিষেবা: ব্যবহারকারীর ডেটা নীতি এবং নির্দিষ্ট API স্কোপের জন্য অতিরিক্ত প্রয়োজনীয়তা দেখুন। এছাড়াও, সীমাবদ্ধ স্কোপের জন্য অনুরোধ করা অ্যাপের জন্য ধাপ দেখুন।
আপনার অ্যাপের যদি অন্য কোনও Google API-তে অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনি সেইসব স্কোপও যোগ করতে পারেন। Google API স্কোপ সম্পর্কে আরও জানতে, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।
Google Workspace API-এর স্কোপ সম্পর্কে আরও জানতে, OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করুন এবং স্কোপ বেছে নিন নিবন্ধটি দেখুন।
প্রয়োজনীয় যাচাইকরণের ধরন
Chat API-এর মাধ্যমে Chat অ্যাপ দুটি উপায়ে যাচাই ও অনুমোদন করতে পারে:
- ব্যবহারকারীর পরিচয় যাচাইকরণ
- ব্যবহারকারীর যাচাইকরণ Chat অ্যাপকে ব্যবহারকারীর ডেটা অ্যাক্সেস করতে এবং ব্যবহারকারীর হয়ে অ্যাকশন সম্পূর্ণ করতে অনুমতি দেয়। OAuth স্কোপ অনুমোদিত ডেটা ও অ্যাকশন নির্দিষ্ট করে। Chat অ্যাপটি অ্যাডমিন ইনস্টল না করলে বা ডোমেন-ওয়াইড ডেলিগেশন না দিলে, প্রথমবার Chat অ্যাপ কোনও ব্যবহারকারীর হয়ে অ্যাকশন পারফর্ম করলে, ব্যবহারকারীকে অবশ্যই OAuth সম্মতি স্ক্রিন ব্যবহার করে Chat অ্যাপকে অনুমতি দিতে হবে।
- অ্যাপ যাচাইকরণ
অ্যাপ যাচাইকরণ কোনও Chat অ্যাপকে পরিষেবা অ্যাকাউন্ট ক্রেডেনশিয়াল ব্যবহার করতে এবং ডেটা অ্যাক্সেস করতে এবং নিজের মতো করে অ্যাকশন সম্পূর্ণ করতে দেয়। যেহেতু Chat অ্যাপ রিসোর্স অ্যাক্সেস ও ব্যবহার করার জন্য নিজস্ব ক্রেডেনশিয়াল ব্যবহার করে, তাই ব্যবহারকারীকে Chat অ্যাপের API কল অনুমোদন করতে হয় না এবং আপনি OAuth সম্মতি স্ক্রিনে অ্যাপ অনুমোদন করে এমন OAuth অনুমোদনের স্কোপ যোগ করতে পারবেন না।
দুই ধরনের OAuth অনুমোদনের স্কোপ অ্যাপ যাচাইকরণে সাহায্য করে:
https://www.googleapis.com/auth/chat.bot: আপনার Chat অ্যাপ Google Chat API কল করতে পারে যেসব পদ্ধতি এই অনুমোদনের সুযোগকে সমর্থন করে, সেগুলি ব্যবহার করে রিসোর্স তৈরি, আপডেট, পাওয়া, তালিকাভুক্ত করা বা মুছে ফেলা যায়, যেমন স্পেসে মেসেজ যেখানে ব্যবহারকারীরা আপনার Chat অ্যাপ যোগ করেন। আপনার Chat অ্যাপ নিজেই এই অনুমোদনের স্কোপ মঞ্জুর করতে পারে, কোনও অ্যাডমিনিস্ট্রেটর বা ব্যবহারকারীর অনুমোদনের প্রয়োজন নেই।https://www.googleapis.com/auth/chat.app.*: এইসব স্কোপ ব্যবহার করার জন্য অ্যাডমিনিস্ট্রেটরের থেকে একবার অনুমোদন নিতে হবে। অ্যাডমিনিস্ট্রেটরের অনুমোদন পেতে, আপনাকে অ্যাডমিনিস্ট্রেটরের অনুমোদন পাওয়ার জন্য Chat অ্যাপের পরিষেবা অ্যাকাউন্ট প্রস্তুত করতে হবে। এটি করার জন্য, Google Workspace Marketplace-এর সাথে মানানসই OAuth ক্লায়েন্ট তৈরি করতে হবে এবং Google Workspace Marketplace SDK-তে অ্যাপটি কনফিগার করতে হবে। এইসব স্কোপ আপনার Chat অ্যাপকে নির্দিষ্ট Google Chat API মেথড কল করার অনুমতি দেয়। যেমন,chat.app.spaces.createঅ্যাপকে Chat স্পেস তৈরি করার অনুমতি দেয়।
কোনও পদ্ধতি ব্যবহারকারী বা অ্যাপ যাচাইকরণ, দুটির ক্ষেত্রেই কাজ করলে, Chat API আপনার ব্যবহার করা যাচাইকরণের ধরনের উপর ভিত্তি করে বিভিন্ন ফলাফল দেখায়:
- অ্যাপ যাচাইকরণের মাধ্যমে, পদ্ধতিগুলি শুধুমাত্র সেই রিসোর্সগুলি ফেরত দেয় যা Chat অ্যাপ অ্যাক্সেস করতে পারে।
- ব্যবহারকারীর যাচাইকরণের মাধ্যমে, পদ্ধতিগুলি শুধুমাত্র সেই রিসোর্সগুলি ফেরত দেয় যা ব্যবহারকারী অ্যাক্সেস করতে পারে।
যেমন, অ্যাপ অনুমোদনের সাথে spaces.list() পদ্ধতি কল করলে,
Chat অ্যাপ যেসব স্পেসের মেম্বার সেগুলির তালিকা রিটার্ন করে।
ব্যবহারকারীর অনুমোদনের সাথে spaces.list() কল করলে, ব্যবহারকারী যেসব স্পেসের মেম্বার সেগুলির তালিকা পাওয়া যায়। বাস্তবে, Chat API কল করার সময় আপনি দুই ধরনের যাচাইকরণই ব্যবহার করতে পারেন, যা আপনার Chat অ্যাপের ডিজাইন
ও ফিচারের উপর নির্ভর করে।
অ্যাসিঙ্ক্রোনাস Chat API কলের জন্য
নিচের সারণীতে Chat API পদ্ধতি এবং সেগুলির অনুমোদিত অনুমোদনের স্কোপের তালিকা দেওয়া হয়েছে:
| পদ্ধতি | ব্যবহারকারীর পরিচয় যাচাইকরণ কাজ করে | অ্যাপ যাচাইকরণ কাজ করে | অনুমোদনের স্কোপ কাজ করে | |
|---|---|---|---|---|
| Spaces | ||||
| স্পেস তৈরি করা |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| স্পেস সেট-আপ করা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| স্পেস পাওয়া |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| স্পেসের তালিকা |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| স্পেস সার্চ করুন | — |
অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারীর যাচাইকরণ:
|
||
| স্পেস আপডেট করা |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| স্পেস মুছে ফেলা |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| কোনও স্পেসের জন্য ইমপোর্ট করার প্রসেস সম্পূর্ণ করা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| সরাসরি মেসেজ খোঁজা |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেম্বার | ||||
| মেম্বার তৈরি করুন |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেম্বারশিপ পাওয়া |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেম্বারের তালিকা |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেম্বারকে মুছে দেওয়া |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেম্বার আপডেট করা |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেসেজ | ||||
| মেসেজ তৈরি করুন |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| একটি মেসেজ পাওয়া |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেসেজের তালিকা তৈরি করা |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেসেজ সার্চ করা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| মেসেজ আপডেট করা |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেসেজ মুছে দেওয়া |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেসেজ পিন করে রাখা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| মেসেজ আনপিন করা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| পিন করা মেসেজের তালিকা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| মেসেজে কার্ড আপডেট করা | — |
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
|
||
| প্রতিক্রিয়া | ||||
| রিঅ্যাকশন তৈরি করুন | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| প্রতিক্রিয়ার তালিকা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| প্রতিক্রিয়া মুছে দেওয়া | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| কাস্টম ইমোজি | ||||
| কাস্টম ইমোজি তৈরি করুন | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| কাস্টম ইমোজি মুছে দেওয়া | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| কাস্টম ইমোজি পান | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| কাস্টম ইমোজির তালিকা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| মিডিয়া ও অ্যাটাচমেন্ট | ||||
| ফাইল অ্যাটাচমেন্ট হিসেবে মিডিয়া আপলোড করা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| মিডিয়া ডাউনলোড করুন |
ব্যবহারকারীর যাচাইকরণ সহ:
|
|||
| মেসেজের অ্যাটাচমেন্ট খুঁজে আনা | — |
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
|
||
| ব্যবহারকারীর পড়ার স্ট্যাটাস | ||||
| ব্যবহারকারীর স্পেস রিড স্টেট পাওয়া | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর স্পেস পড়ার স্ট্যাটাস আপডেট করা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর থ্রেড পড়ার স্ট্যাটাস পাওয়া | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর থ্রেড পড়ার স্ট্যাটাস আপডেট করা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর স্পেস সেটিংস | ||||
| ব্যবহারকারীর স্পেস বিজ্ঞপ্তি সেটিং পাওয়া | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর স্পেস বিজ্ঞপ্তি সেটিং আপডেট করুন | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| Space ইভেন্ট | ||||
| স্পেস ইভেন্ট পান | — |
ব্যবহারকারীর যাচাইকরণ-এর সাথে,
আপনাকে অবশ্যই
ইভেন্টের ধরন-এর উপর ভিত্তি করে একটি স্কোপ ব্যবহার করতে হবে:
|
||
| স্পেস ইভেন্টের তালিকা তৈরি করা | — |
ব্যবহারকারীর যাচাইকরণ-এর সাথে,
আপনাকে অনুরোধে অন্তর্ভুক্ত প্রতিটি
ইভেন্টের ধরনের জন্য একটি স্কোপ ব্যবহার করতে হবে:
|
||
| বিভাগ | ||||
| বিভাগ তৈরি করা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| কোনও বিভাগ মুছে ফেলা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| তালিকার বিভাগ | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| বিভাগ আপডেট করুন | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| বিভাগের পজিশন ঠিক করা | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| বিভাগের আইটেম | ||||
| কোনও বিভাগের আইটেম সরানো | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
| তালিকা বিভাগের আইটেম | — |
ব্যবহারকারীর যাচাইকরণ সহ:
|
||
Chat অ্যাপ ইন্টার্যাকশন ইভেন্টের জন্য
নিম্নলিখিত সারণীতে ব্যবহারকারীরা Chat অ্যাপের সাথে যেভাবে ইন্টার্যাক্ট করেন তার সাধারণ উপায়গুলি তালিকাভুক্ত করা হয়েছে এবং যাচাইকরণ প্রয়োজন বা সমর্থিত কিনা তা উল্লেখ করা হয়েছে:
| পরিস্থিতি | যাচাইকরণের প্রয়োজন নেই | ব্যবহারকারীর পরিচয় যাচাইকরণ কাজ করে | অ্যাপ যাচাইকরণ কাজ করে | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| এর থেকে মেসেজ পান: |
|
|||||||||||||||
| মেসেজের উত্তর দিন: |
|
|||||||||||||||
| নতুন মেসেজ পাঠান: |
|
|||||||||||||||
সম্পর্কিত বিষয়
- Google Workspace-এ যাচাইকরণ ও অনুমোদনের ওভারভিউ পেতে, যাচাইকরণ ও অনুমোদন সম্পর্কে জানুন দেখুন।
- Google Cloud-এ যাচাইকরণ ও অনুমোদনের ওভারভিউ পেতে, যাচাইকরণের ওভারভিউ দেখুন।
- সার্ভিস অ্যাকাউন্ট সম্পর্কে আরও জানতে, সার্ভিস অ্যাকাউন্ট দেখুন।
- Google API কীভাবে OAuth 2.0 ব্যবহার করে সেই সম্পর্কে আরও জানতে, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।
- ব্যবহারকারীর ক্রেডেনশিয়াল অথবা পরিষেবা অ্যাকাউন্ট-এর মাধ্যমে যাচাইকরণ ও অনুমোদন সেট-আপ করুন।
- গ্র্যানুলার OAuth অনুমতি ম্যানেজ করতে, Google Chat অ্যাপের জন্য গ্র্যানুলার OAuth অনুমতি ম্যানেজ করুন দেখুন।