Chat অ্যাপ ও Google Chat API অনুরোধ প্রমাণীকরণ ও অনুমোদন করা

যাচাইকরণ ও অনুমোদন হল এমন মেকানিজম যা যথাক্রমে পরিচয় ও রিসোর্স অ্যাক্সেস যাচাই করতে ব্যবহার করা হয়। Chat অ্যাপ ও Chat API অনুরোধের জন্য কীভাবে যাচাইকরণ ও অনুমোদন কাজ করে তা এই ডকুমেন্টে উল্লেখ করা হয়েছে।

প্রসেস, এক নজরে

নিচের ডায়াগ্রামে Google Chat-এর জন্য যাচাইকরণ ও অনুমোদনের উচ্চ-স্তরের ধাপগুলি দেখানো হয়েছে:

Google Chat যাচাইকরণ ও অনুমোদনের জন্য হাই-লেভেল ধাপ
ছবি ১. Google Chat যাচাইকরণ ও অনুমোদনের জন্য হাই-লেভেল ধাপ।

  1. Google Cloud প্রোজেক্ট কনফিগার করুন, Chat API চালু করুন এবং আপনার Chat অ্যাপ কনফিগার করুন: ডেভেলপমেন্টের সময়, আপনি একটি Google Cloud প্রোজেক্ট তৈরি করেন। Google Cloud প্রোজেক্টে, আপনি Chat API চালু করেন, আপনার Chat অ্যাপ কনফিগার করেন এবং যাচাইকরণ সেট-আপ করেন। আরও তথ্যের জন্য, Google Workspace-এ ডেভেলপ করুন এবং Chat অ্যাপ তৈরি করুন দেখুন।

  2. Chat API কল করা: আপনার অ্যাপ Chat API কল করলে, এটি Chat API-তে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল পাঠায়। আপনার অ্যাপ যদি কোনও পরিষেবা অ্যাকাউন্টের মাধ্যমে যাচাই করে, তাহলে ক্রেডেনশিয়াল আপনার অ্যাপের কোডের অংশ হিসেবে পাঠানো হয়। আপনার অ্যাপের যদি Chat API কল করার প্রয়োজন হয় এবং এর জন্য ব্যবহারকারীর যাচাইকরণ প্রয়োজন হয় যা এখনও মঞ্জুর করা হয়নি, তাহলে এটি ব্যবহারকারীকে সাইন-ইন করার জন্য প্রম্পট করে।

  3. রিসোর্সের জন্য অনুরোধ করা: আপনার অ্যাপ স্কোপ সহ অ্যাক্সেসের জন্য অনুরোধ করে যা আপনি যাচাইকরণ সেট-আপ করার সময় উল্লেখ করেন।

  4. সম্মতি চাওয়া: আপনার অ্যাপ ব্যবহারকারী হিসেবে যাচাই করলে, Google একটি OAuth সম্মতি স্ক্রিন দেখায় যাতে ব্যবহারকারী সিদ্ধান্ত নিতে পারেন যে আপনার অ্যাপকে অনুরোধ করা ডেটায় অ্যাক্সেস দেবেন কিনা। পরিষেবা অ্যাকাউন্টের মাধ্যমে যাচাইকরণের জন্য ব্যবহারকারীর সম্মতির প্রয়োজন হয় না।

  5. রিসোর্সের জন্য অনুমোদিত অনুরোধ পাঠানো: ব্যবহারকারী অনুমোদনের স্কোপে সম্মতি দিলে, আপনার অ্যাপ ক্রেডেনশিয়াল এবং ব্যবহারকারীর অনুমোদন করা স্কোপকে একটি অনুরোধে বান্ডেল করে। অ্যাক্সেস টোকেন পেতে Google-এর অনুমোদন সার্ভারে অনুরোধ পাঠানো হয়।

  6. Google একটি অ্যাক্সেস টোকেন ফেরত পাঠায়: অ্যাক্সেস টোকেনে অনুমোদিত স্কোপের একটি তালিকা থাকে। ফেরত পাঠানো স্কোপের তালিকা অনুরোধ করা স্কোপের চেয়ে বেশি সীমাবদ্ধ হলে, আপনার অ্যাপ টোকেন দ্বারা সীমিত যেকোনও ফিচার বন্ধ করে দেয়।

  7. অনুরোধ করা রিসোর্স অ্যাক্সেস করা: Chat API চালু করতে এবং Chat API রিসোর্স অ্যাক্সেস করতে আপনার অ্যাপ Google থেকে অ্যাক্সেস টোকেন ব্যবহার করে।

  8. রিফ্রেশ টোকেন পান (ঐচ্ছিক): আপনার অ্যাপকে যদি একটি অ্যাক্সেস টোকেনের লাইফটাইমের পরেও Google Chat API অ্যাক্সেস করতে হয়, তাহলে এটি একটি রিফ্রেশ টোকেন পেতে পারে। আরও তথ্যের জন্য, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করুন দেখুন।

  9. আরও রিসোর্সের জন্য অনুরোধ করা: আপনার অ্যাপের আরও অ্যাক্সেসের প্রয়োজন হলে, এটি ব্যবহারকারীকে নতুন স্কোপের অনুমতি দিতে বলে, যার ফলে অ্যাক্সেস টোকেন পাওয়ার জন্য নতুন অনুরোধ করা হয় (ধাপ ৩-৬)।

Chat অ্যাপের জন্য যাচাইকরণের প্রয়োজন হলে

Chat অ্যাপ ব্যবহারকারীর ইন্টার‍্যাকশনের উত্তরে বা অ্যাসিঙ্ক্রোনাসভাবে মেসেজ পাঠাতে পারে। এছাড়াও, তারা ব্যবহারকারীর হয়ে টাস্ক সম্পূর্ণ করতে পারে, যেমন Chat স্পেস তৈরি করা বা Chat স্পেসে থাকা লোকজনের তালিকা পাওয়া।

Chat অ্যাপকে কোনও ব্যবহারকারীর ইন্টার‍্যাকশনের উত্তর দেওয়ার জন্য যাচাইকরণ করতে হয় না, যদি না Chat অ্যাপ কোনও উত্তর প্রসেস করার সময় Chat API বা অন্য কোনও Google API-কে কল করে।

অ্যাসিঙ্ক্রোনাস মেসেজ পাঠাতে বা ব্যবহারকারীর হয়ে টাস্ক সম্পূর্ণ করতে, Chat অ্যাপ Chat API-তে RESTful অনুরোধ করে, যার জন্য যাচাইকরণ ও অনুমোদনের প্রয়োজন হয়।

ব্যবহারকারীর ইন্টার‍্যাকশনের উত্তরে যাচাইকরণের প্রয়োজন নেই

Google Chat অ্যাপকে ব্যবহারকারী হিসেবে যাচাই করতে হয় না অথবা ব্যবহারকারীর ইন্টার‍্যাকশন-এর সাথে সিঙ্ক করে উত্তর পেতে ও দিতে Chat অ্যাপকে যাচাই করতে হয় না।

ব্যবহারকারী যখনই কোনও Chat অ্যাপের সাথে ইন্টার‍্যাক্ট করেন বা সেটি চালু করেন, তখনই Google Chat অ্যাপ ইভেন্ট অবজেক্ট পায়, যার মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত থাকে:

  • কোনও ব্যবহারকারী Chat অ্যাপে মেসেজ পাঠান।
  • কোনও ব্যবহারকারী Chat অ্যাপকে @উল্লেখ করেন।
  • ব্যবহারকারী Chat অ্যাপের কোনও একটি কমান্ড চালু করেন।

নিচের ডায়াগ্রামটি Chat ব্যবহারকারী এবং Chat অ্যাপের মধ্যে অনুরোধ-প্রতিক্রিয়ার ক্রম দেখায়:

Chat অ্যাপ ব্যবহারকারীর ইন্টার‍্যাকশনের জন্য কোনও অনুমোদনের প্রয়োজন নেই
ছবি ২. Chat অ্যাপ ব্যবহারকারীর ইন্টার‍্যাকশনের জন্য যাচাইকরণের প্রয়োজন নেই।

  1. ব্যবহারকারী Google Chat-এ Chat অ্যাপে মেসেজ পাঠান।
  2. Google Chat অ্যাপে মেসেজটি ফরওয়ার্ড করে।
  3. অ্যাপটি মেসেজ পায়, সেটি প্রসেস করে এবং Google Chat-এ উত্তর পাঠায়।
  4. Google Chat ব্যবহারকারীর জন্য বা কোনও স্পেসে উত্তর রেন্ডার করে।

প্রতিটি Chat অ্যাপ ব্যবহারকারীর ইন্টার‍্যাকশনের জন্য এই ক্রম পুনরাবৃত্তি হয়।

অ্যাসিঙ্ক্রোনাস মেসেজ যাচাই করতে হবে

Chat অ্যাপ Chat API-তে অনুরোধ করলে, অ্যাসিঙ্ক্রোনাস মেসেজ পাঠানো হয়, যার জন্য যাচাইকরণ ও অনুমোদনের প্রয়োজন হয়।

Chat API কল করার মাধ্যমে, Chat অ্যাপ Google Chat-এ মেসেজ পোস্ট করতে পারে অথবা ব্যবহারকারীর হয়ে টাস্ক সম্পূর্ণ করতে ও ডেটা অ্যাক্সেস করতে পারে। যেমন, সার্ভার আউট হয়ে গেছে শনাক্ত করার পরে, Chat অ্যাপ Chat API-কে কল করতে পারে:

  • আউটেজ তদন্ত ও সমাধান করার জন্য একটি Chat স্পেস তৈরি করুন।
  • Chat স্পেসে লোকজনকে যোগ করো।
  • আউটেজ সম্পর্কে বিবরণ দিতে Chat স্পেসে মেসেজ পোস্ট করুন।

নিচের ডায়াগ্রামে Chat অ্যাপ ও Chat স্পেসের মধ্যে অ্যাসিঙ্ক্রোনাস মেসেজের ক্রম দেখানো হয়েছে:

অ্যাসিঙ্ক্রোনাস মেসেজের জন্য যাচাইকরণ প্রয়োজন
ছবি ৩. অ্যাসিঙ্ক্রোনাস মেসেজ যাচাই করতে হবে।

  1. Chat অ্যাপ spaces.messages.create পদ্ধতি ব্যবহার করে Chat API কল করার মাধ্যমে মেসেজ তৈরি করে এবং HTTP অনুরোধে ব্যবহারকারীর ক্রেডেনশিয়াল অন্তর্ভুক্ত করে।
  2. Google Chat, পরিষেবা অ্যাকাউন্ট বা ব্যবহারকারীর ক্রেডেনশিয়ালের মাধ্যমে Chat অ্যাপ যাচাই করে।
  3. 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 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 অ্যাপের ডিজাইন ও ফিচারের উপর নির্ভর করে, Chat API কল করার সময় আপনি দুই ধরনের যাচাইকরণই ব্যবহার করতে পারেন।

অ্যাসিঙ্ক্রোনাস Chat API কলের জন্য

নিম্নলিখিত সারণীতে Chat API পদ্ধতি এবং সেগুলির অনুমোদিত অনুমোদনের স্কোপের তালিকা দেওয়া আছে:

পদ্ধতি ব্যবহারকারীর পরিচয় যাচাইকরণ কাজ করে অ্যাপ যাচাইকরণ কাজ করে অনুমোদনের স্কোপ কাজ করে
Spaces  
স্পেস তৈরি করা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.spaces.create
  • chat.spaces
  • chat.import
অ্যাপ যাচাইকরণ এবং অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ:
  • chat.app.spaces.create
  • chat.app.spaces
স্পেস সেট-আপ করুন — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.spaces.create
  • chat.spaces
স্পেস পাওয়া ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.spaces.readonly
  • chat.spaces
অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারী যাচাইকরণ:
  • chat.admin.spaces.readonly
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
অ্যাপ যাচাইকরণ এবং অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ:
  • chat.app.spaces
স্পেসের তালিকা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.spaces.readonly
  • chat.spaces
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
স্পেস সার্চ করুন — অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারীর যাচাইকরণ:
  • chat.admin.spaces.readonly
স্পেস আপডেট করা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.spaces
  • chat.import
অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারীর যাচাইকরণ:
  • chat.admin.spaces
অ্যাপ যাচাইকরণ এবং অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ:
  • chat.app.spaces
স্পেস মুছে ফেলা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.delete
  • chat.import
অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারীর যাচাইকরণ:
  • chat.admin.delete
অ্যাপ যাচাইকরণ এবং অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ:
  • chat.app.delete
কোনও স্পেসের জন্য ইমপোর্ট করার প্রসেস সম্পূর্ণ করা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.import
সরাসরি মেসেজ খোঁজা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.spaces.readonly
  • chat.spaces
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
মেম্বার  
মেম্বার তৈরি করা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.memberships
  • chat.memberships.app
  • chat.import
অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারীর যাচাইকরণ:
  • chat.admin.memberships
অ্যাপ যাচাইকরণ এবং অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ:
  • chat.app.memberships
মেম্বারশিপ পাওয়া ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.memberships.readonly
  • chat.memberships
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারীর যাচাইকরণ:
  • chat.admin.memberships.readonly
মেম্বারের তালিকা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.memberships.readonly
  • chat.memberships
  • chat.import
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারী যাচাইকরণ:
  • chat.admin.memberships.readonly
মেম্বারকে মুছে ফেলা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.memberships
  • chat.memberships.app
  • chat.import
অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারীর যাচাইকরণ:
  • chat.admin.memberships
অ্যাপ যাচাইকরণ এবং অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ:
  • chat.app.memberships
মেম্বার আপডেট করা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.memberships
  • chat.import
অ্যাডমিনিস্ট্রেটরের বিশেষ সুবিধা ব্যবহার করে ব্যবহারকারীর যাচাইকরণ:
  • chat.admin.memberships
অ্যাপ যাচাইকরণ এবং অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ:
  • chat.app.memberships
মেসেজ  
মেসেজ তৈরি করুন ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages.create
  • chat.messages
  • chat.import
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
একটি মেসেজ পাওয়া ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages.readonly
  • chat.messages
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
অ্যাপ যাচাইকরণ এবং অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ:
  • chat.app.messages.readonly
মেসেজের তালিকা তৈরি করা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages.readonly
  • chat.messages
  • chat.import
অ্যাপ যাচাইকরণ এবং অ্যাডমিনিস্ট্রেটরের অনুমোদন সহ:
  • chat.app.messages.readonly
মেসেজ সার্চ করা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages.readonly
  • chat.messages
মেসেজ আপডেট করা ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages
  • chat.import
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
মেসেজ মুছে দেওয়া ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages
  • chat.import
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
মেসেজ পিন করে রাখা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.spaces.pins
  • chat.spaces
মেসেজ আনপিন করা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.spaces.pins
  • chat.spaces
পিন করা মেসেজের তালিকা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.spaces.pins.readonly
  • chat.spaces.readonly
  • chat.spaces.pins
  • chat.spaces
মেসেজে কার্ড আপডেট করা — অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
প্রতিক্রিয়া  
রিঅ্যাকশন তৈরি করুন — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages.reactions.create
  • chat.messages.reactions
  • chat.messages
  • chat.import
প্রতিক্রিয়ার তালিকা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages.reactions.readonly
  • chat.messages.reactions
  • chat.messages.readonly
  • chat.messages
প্রতিক্রিয়া মুছে দেওয়া — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages.reactions
  • chat.messages
  • chat.import
কাস্টম ইমোজি  
কাস্টম ইমোজি তৈরি করা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.customemojis
কাস্টম ইমোজি মুছে দেওয়া — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.customemojis
কাস্টম ইমোজি পান — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.customemojis
  • chat.customemojis.readonly
কাস্টম ইমোজির তালিকা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.customemojis
  • chat.customemojis.readonly
মিডিয়া ও অ্যাটাচমেন্ট  
ফাইল অ্যাটাচমেন্ট হিসেবে মিডিয়া আপলোড করা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages.create
  • chat.messages
  • chat.import
মিডিয়া ডাউনলোড করুন ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.messages.readonly
  • chat.messages
অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
মেসেজের অ্যাটাচমেন্ট খুঁজে আনা — অ্যাপ যাচাইকরণ ফিচারের মাধ্যমে:
  • chat.bot
ব্যবহারকারীর পড়ার স্ট্যাটাস
ব্যবহারকারীর স্পেস রিড স্টেট পাওয়া — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.readstate
  • chat.users.readstate.readonly
ব্যবহারকারীর স্পেস রিড স্টেট আপডেট করুন — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.readstate
ব্যবহারকারীর থ্রেড পড়ার স্ট্যাটাস পাওয়া — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.readstate
  • chat.users.readstate.readonly
ব্যবহারকারীর স্পেস সেটিংস
ব্যবহারকারীর স্পেস বিজ্ঞপ্তি সেটিং পান — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.spacesettings
ব্যবহারকারীর স্পেস বিজ্ঞপ্তি সেটিং আপডেট করা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.spacesettings
Space ইভেন্ট
স্পেস ইভেন্ট পান — ব্যবহারকারীর যাচাইকরণ-এর সাথে, আপনাকে অবশ্যই ইভেন্টের ধরন-এর উপর ভিত্তি করে একটি স্কোপ ব্যবহার করতে হবে:
  • মেসেজ সংক্রান্ত ইভেন্টের জন্য:
    • chat.messages
    • chat.messages.readonly
  • প্রতিক্রিয়া সম্পর্কিত ইভেন্টের জন্য:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • মেম্বারশিপ সংক্রান্ত ইভেন্টের জন্য:
    • chat.memberships
    • chat.memberships.readonly
  • স্পেস সম্পর্কিত ইভেন্টের জন্য:
    • chat.spaces
    • chat.spaces.readonly
স্পেস ইভেন্টের তালিকা তৈরি করা — ব্যবহারকারীর যাচাইকরণ-এর সাথে, আপনাকে প্রতিটি ইভেন্টের ধরনের জন্য একটি স্কোপ ব্যবহার করতে হবে যা অনুরোধে অন্তর্ভুক্ত:
  • মেসেজ সংক্রান্ত ইভেন্টের জন্য:
    • chat.messages
    • chat.messages.readonly
  • প্রতিক্রিয়া সম্পর্কিত ইভেন্টের জন্য:
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • মেম্বারশিপ সংক্রান্ত ইভেন্টের জন্য:
    • chat.memberships
    • chat.memberships.readonly
  • স্পেস সম্পর্কিত ইভেন্টের জন্য:
    • chat.spaces
    • chat.spaces.readonly
বিভাগ  
বিভাগ তৈরি করা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.sections
কোনও বিভাগ মুছে ফেলা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.sections
তালিকার বিভাগ — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.sections
  • chat.users.sections.readonly
বিভাগ আপডেট করুন — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.sections
কোনও বিভাগের পজিশন ঠিক করা — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.sections
বিভাগের আইটেম  
বিভাগের আইটেম সরানো — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.sections
তালিকা বিভাগের আইটেম — ব্যবহারকারীর যাচাইকরণ সহ:
  • chat.users.sections
  • chat.users.sections.readonly

Chat অ্যাপ ইন্টার‍্যাকশন ইভেন্টের জন্য

নিম্নলিখিত সারণীতে ব্যবহারকারীরা Chat অ্যাপের সাথে যেভাবে ইন্টার‍্যাক্ট করেন তার সাধারণ উপায় এবং যাচাইকরণ প্রয়োজন বা সমর্থিত কিনা তা তালিকাভুক্ত করা হয়েছে:

পরিস্থিতি যাচাইকরণের প্রয়োজন নেই ব্যবহারকারীর পরিচয় যাচাইকরণ কাজ করে অ্যাপ যাচাইকরণ কাজ করে
এদের থেকে মেসেজ পান:
Chat অ্যাপ ইন্টার‍্যাকশন ইভেন্ট — —
Apps Script কলব্যাক — —
Google Cloud Pub/Sub — —
মেসেজের উত্তর দিন:
সিঙ্ক্রোনাসভাবে, Chat অ্যাপ ইন্টার‍্যাকশন ইভেন্ট ব্যবহার করে — —
Apps Script কলব্যাক রিটার্ন ভ্যালু ব্যবহার করে সিঙ্ক্রোনাসভাবে — —
নতুন মেসেজ পাঠান:
ইনকামিং ওয়েবহুক সহ — —