যাচাইকরণ ও অনুমোদন হল এমন পদ্ধতি যা যথাক্রমে পরিচয় যাচাই করতে এবং রিসোর্স অ্যাক্সেস করতে ব্যবহার করা হয়। এই ডকুমেন্টে 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 একটি অ্যাক্সেস টোকেন ফেরত পাঠায়: অ্যাক্সেস টোকেনে অনুমোদিত স্কোপের একটি তালিকা থাকে। স্কোপের ফেরত পাওয়া তালিকা, অনুরোধ করা স্কোপের চেয়ে বেশি বিধিনিষেধমূলক হলে, আপনার অ্যাপ টোকেন দ্বারা সীমিত করা যেকোনও ফিচার বন্ধ করে দেয়।
অনুরোধ করা রিসোর্স অ্যাক্সেস করা: আপনার অ্যাপ Google-এর থেকে পাওয়া অ্যাক্সেস টোকেন ব্যবহার করে Chat API ইনভোক করে এবং Chat API রিসোর্স অ্যাক্সেস করে।
রিফ্রেশ টোকেন পান (ঐচ্ছিক): আপনার অ্যাপকে যদি একটি অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে যাওয়ার পরেও Google Chat API অ্যাক্সেস করতে হয়, তাহলে এটি একটি রিফ্রেশ টোকেন পেতে পারে। আরও তথ্যের জন্য, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করুন দেখুন।
আরও রিসোর্স অ্যাক্সেস করার অনুরোধ: আপনার অ্যাপের আরও অ্যাক্সেস প্রয়োজন হলে, এটি ব্যবহারকারীকে নতুন স্কোপ দেওয়ার জন্য বলে, এর ফলে অ্যাক্সেস টোকেন পাওয়ার জন্য নতুন অনুরোধ করা হয় (ধাপ ৩-৬)।
Chat অ্যাপের ক্ষেত্রে কখন যাচাইকরণ প্রয়োজন হয়
চ্যাট অ্যাপ ব্যবহারকারীর ইন্টার্যাকশনের উত্তরে মেসেজ পাঠাতে পারে অথবা অ্যাসিঙ্ক্রোনাসভাবে মেসেজ পাঠাতে পারে। এছাড়াও, তারা ব্যবহারকারীর হয়ে টাস্ক সম্পূর্ণ করতে পারে, যেমন Chat স্পেস তৈরি করা বা Chat স্পেসে থাকা লোকজনের তালিকা পাওয়া।
ব্যবহারকারীর ইন্টার্যাকশনের উত্তর দেওয়ার জন্য চ্যাট অ্যাপের যাচাইকরণ প্রয়োজন হয় না, যদি না উত্তর প্রসেস করার সময় চ্যাট অ্যাপ Chat API বা অন্য কোনও Google API কল করে।
সিঙ্ক না করা মেসেজ পাঠাতে বা ব্যবহারকারীর হয়ে টাস্ক পারফর্ম করতে, Chat অ্যাপ Chat API-তে RESTful অনুরোধ করে, যার জন্য যাচাইকরণ ও অনুমোদন প্রয়োজন।
ব্যবহারকারীর ইন্টার্যাকশনের উত্তরে যাচাইকরণ প্রয়োজন হয় না
Google Chat অ্যাপকে ব্যবহারকারী বা Chat অ্যাপ হিসেবে প্রমাণীকরণ করতে হয় না। এর ফলে ব্যবহারকারীর ইন্টার্যাকশন সিঙ্ক্রোনাস পদ্ধতিতে গ্রহণ ও উত্তর দেওয়া যায়।
ব্যবহারকারী কোনও Chat অ্যাপের সাথে ইন্টার্যাক্ট করলে বা সেটি ইনভোক করলে, Google 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
|
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 অ্যাপের API কল অনুমোদন করার প্রয়োজন হয় না এবং আপনি OAuth কনসেন্ট স্ক্রিনে অ্যাপ অনুমোদনের জন্য কাজ করে এমন OAuth অনুমোদন স্কোপ যোগ করতে পারবেন না।
অ্যাপ যাচাইকরণের জন্য দুই ধরনের OAuth অনুমোদন স্কোপ কাজ করে:
https://www.googleapis.com/auth/chat.bot: আপনার Chat অ্যাপ, Google Chat API মেথড কল করতে পারে যা এই অনুমোদনের স্কোপকে সমর্থন করে। এর মাধ্যমে, আপনার Chat অ্যাপ এমন রিসোর্স তৈরি, আপডেট, পেতে, তালিকাভুক্ত করতে বা মুছে দিতে পারে যেগুলিতে এটির অ্যাক্সেস আছে, যেমন স্পেসে থাকা মেসেজ যেগুলিতে এন্ড-ইউজার আপনার 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 আলাদা আলাদা ফলাফল দেয়:
- অ্যাপ যাচাইকরণের মাধ্যমে, পদ্ধতিগুলি শুধুমাত্র সেইসব রিসোর্স রিটার্ন করে যেগুলি চ্যাট অ্যাপ অ্যাক্সেস করতে পারে।
- ব্যবহারকারী যাচাইকরণের মাধ্যমে, পদ্ধতিগুলি শুধুমাত্র সেইসব রিসোর্স রিটার্ন করে যেগুলি ব্যবহারকারী অ্যাক্সেস করতে পারবেন।
যেমন, অ্যাপ অনুমোদনের মাধ্যমে spaces.list() পদ্ধতি কল করলে, Chat অ্যাপ মেম্বার
হিসেবে আছে এমন স্পেসের তালিকা রিটার্ন করে।
ব্যবহারকারীর অনুমোদন spaces.list() সহ
কল করলে, ব্যবহারকারী মেম্বার আছেন এমন স্পেসের তালিকা রিটার্ন করে। প্র্যাক্টিক্যালে, Chat API কল করার সময় আপনি দুই ধরনের
যাচাইকরণই ব্যবহার করতে পারেন। এটি আপনার Chat অ্যাপের ডিজাইন
ও ফিচারের উপর নির্ভর করে।
অ্যাসিঙ্ক্রোনাস Chat API কলের জন্য
নিচে দেওয়া সারণীতে Chat API পদ্ধতি ও তার কাজ করে এমন অনুমোদনের স্কোপের তালিকা দেওয়া হল:
| পদ্ধতি | ব্যবহারকারীর পরিচয় যাচাইকরণ কাজ করে | অ্যাপ যাচাইকরণ কাজ করে | অনুমোদনের স্কোপ যা কাজ করে | |
|---|---|---|---|---|
| স্পেস | ||||
| স্পেস তৈরি করা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| স্পেস সেট-আপ করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| স্পেস পাওয়া |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| স্পেসের তালিকা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| স্পেস সার্চ করুন | — |
অ্যাডমিনিস্ট্রেটর বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারী যাচাইকরণের মাধ্যমে:
|
||
| স্পেস আপডেট করা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| স্পেস মুছে দেওয়া |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| কোনও স্পেসের জন্য ইমপোর্ট করার প্রসেস সম্পূর্ণ করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| সরাসরি মেসেজ খুঁজে দেখা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেম্বার | ||||
| মেম্বার তৈরি করা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেম্বারশিপ নেওয়া |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেম্বারদের তালিকা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেম্বারকে মুছে দেওয়া |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেম্বার আপডেট করা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেসেজ | ||||
| মেসেজ তৈরি করা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেসেজ পান |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেসেজ তালিকাভুক্ত করা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেসেজ সার্চ করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| মেসেজ আপডেট করা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেসেজ মুছে দেওয়া |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেসেজ পিন করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| মেসেজ আনপিন করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| পিন করা মেসেজের তালিকা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| মেসেজে কার্ড আপডেট করা | — |
অ্যাপ যাচাইকরণ সহ:
|
||
| প্রতিক্রিয়া | ||||
| প্রতিক্রিয়া তৈরি করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| তালিকার প্রতিক্রিয়া | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| প্রতিক্রিয়া মুছে দেওয়া | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| কাস্টম ইমোজি | ||||
| কাস্টম ইমোজি তৈরি করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| কাস্টম ইমোজি মুছে দেওয়া | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| কাস্টম ইমোজি পান | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| কাস্টম ইমোজির তালিকা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| মিডিয়া ও অ্যাটাচমেন্ট | ||||
| ফাইল অ্যাটাচমেন্ট হিসেবে মিডিয়া আপলোড করুন | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| মিডিয়া ডাউনলোড করা |
ব্যবহারকারী যাচাইকরণ সহ:
|
|||
| মেসেজ অ্যাটাচমেন্ট পাওয়া | — |
অ্যাপ যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর রিড স্টেট | ||||
| ব্যবহারকারীর স্পেসের রিড স্টেট পাওয়া | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর স্পেসের রিড স্টেট আপডেট করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর থ্রেড রিড স্টেট পাওয়া | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর স্পেস সেটিংস | ||||
| ব্যবহারকারীর স্পেস বিজ্ঞপ্তি সেটিংস পাওয়া | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| ব্যবহারকারীর স্পেস বিজ্ঞপ্তি সেটিংস আপডেট করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| Space ইভেন্ট | ||||
| স্পেস ইভেন্ট পাওয়া | — |
ব্যবহারকারী যাচাইকরণ সহ,
আপনাকে অবশ্যই
ইভেন্টের ধরন অনুযায়ী স্কোপ ব্যবহার করতে হবে:
|
||
| স্পেস ইভেন্টের তালিকা | — |
ব্যবহারকারীকে প্রমাণীকরণ-এর মাধ্যমে,
আপনাকে অবশ্যই প্রতিটি
ইভেন্টের ধরনের জন্য একটি স্কোপ ব্যবহার করতে হবে যা অনুরোধে অন্তর্ভুক্ত:
|
||
| বিভাগ | ||||
| একটি বিভাগ তৈরি করুন | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| কোনও বিভাগ মুছে দেওয়া | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| বিভাগ তালিকাভুক্ত করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| কোনও বিভাগ আপডেট করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| বিভাগকে পজিশন করা | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| বিভাগের আইটেম | ||||
| বিভাগের আইটেম সরানো | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
| তালিকা বিভাগের আইটেম | — |
ব্যবহারকারী যাচাইকরণ সহ:
|
||
Chat অ্যাপ ইন্টার্যাকশন ইভেন্টের জন্য
নিচের সারণীতে, ব্যবহারকারীরা কীভাবে চ্যাট অ্যাপের সাথে ইন্টার্যাক্ট করেন এবং যাচাইকরণ প্রয়োজন হয় কিনা বা এটি কাজ করে কিনা তা উল্লেখ করা হয়েছে:
| পরিস্থিতি | যাচাইকরণের প্রয়োজন নেই | ব্যবহারকারীর পরিচয় যাচাইকরণ কাজ করে | অ্যাপ যাচাইকরণ কাজ করে | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| এদের থেকে মেসেজ পান: |
|
|||||||||||||||
| মেসেজের উত্তর দেওয়া: |
|
|||||||||||||||
| নতুন মেসেজ পাঠানো: |
|
|||||||||||||||
সম্পর্কিত বিষয়
- Google Workspace-এ যাচাইকরণ ও অনুমোদনের ওভারভিউ পেতে, যাচাইকরণ ও অনুমোদন সম্পর্কে জানুন লিঙ্ক দেখুন।
- Google Cloud-এ যাচাইকরণ ও অনুমোদন সংক্রান্ত ওভারভিউ পেতে, যাচাইকরণ সংক্রান্ত ওভারভিউ দেখুন।
- সার্ভিস অ্যাকাউন্ট সম্পর্কে আরও জানতে, সার্ভিস অ্যাকাউন্ট দেখুন।
- Google API কীভাবে OAuth 2.0 ব্যবহার করে সেই সম্পর্কে আরও জানতে, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।
- ব্যবহারকারীর ক্রেডেনশিয়াল অথবা পরিষেবা অ্যাকাউন্ট ব্যবহার করে যাচাইকরণ ও অনুমোদন সেট-আপ করুন।
- গ্র্যানুলার OAuth অনুমতি ম্যানেজ করতে, Google Chat অ্যাপের জন্য গ্র্যানুলার OAuth অনুমতি ম্যানেজ করা নিবন্ধটি দেখুন।