চ্যাট অ্যাপ এবং Google চ্যাট এপিআই অনুরোধগুলিকে প্রমাণীকরণ এবং অনুমোদন করুন

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

প্রক্রিয়ার সারসংক্ষেপ

নিম্নলিখিত চিত্রটি Google Chat-এর জন্য প্রমাণীকরণ এবং অনুমোদনের উচ্চ-স্তরের ধাপগুলি দেখায়:

গুগল চ্যাট প্রমাণীকরণ এবং অনুমোদনের জন্য উচ্চ-স্তরের পদক্ষেপ
চিত্র ১. গুগল চ্যাট প্রমাণীকরণ এবং অনুমোদনের জন্য উচ্চ-স্তরের পদক্ষেপ।

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

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

  3. রিসোর্স রিকোয়েস্ট করুন : আপনার অ্যাপ প্রমাণীকরণ সেট আপ করার সময় আপনার নির্দিষ্ট করা স্কোপগুলির সাথে অ্যাক্সেসের জন্য অনুরোধ করে।

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

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

  6. গুগল একটি অ্যাক্সেস টোকেন ফেরত দেয়: অ্যাক্সেস টোকেনে মঞ্জুরিপ্রাপ্ত স্কোপের একটি তালিকা থাকে। যদি ফিরে আসা স্কোপের তালিকা অনুরোধকৃত স্কোপের চেয়ে বেশি সীমাবদ্ধ হয়, তাহলে আপনার অ্যাপ টোকেন দ্বারা সীমাবদ্ধ যেকোনো বৈশিষ্ট্য বন্ধ করে দেয়।

  7. অনুরোধকৃত রিসোর্স অ্যাক্সেস করুন: আপনার অ্যাপটি চ্যাট এপিআই চালু করতে এবং চ্যাট এপিআই রিসোর্স অ্যাক্সেস করতে গুগলের অ্যাক্সেস টোকেন ব্যবহার করে।

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

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

যখন চ্যাট অ্যাপগুলির প্রমাণীকরণের প্রয়োজন হয়

চ্যাট অ্যাপগুলি ব্যবহারকারীর মিথস্ক্রিয়ার প্রতিক্রিয়ায় অথবা অ্যাসিঙ্ক্রোনাসভাবে বার্তা পাঠাতে পারে। তারা ব্যবহারকারীর পক্ষ থেকেও কাজ সম্পন্ন করতে পারে, যেমন একটি চ্যাট স্পেস তৈরি করা বা একটি চ্যাট স্পেসে থাকা ব্যক্তিদের তালিকা পাওয়া।

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

ব্যবহারকারীর পক্ষ থেকে অ্যাসিঙ্ক্রোনাস বার্তা পাঠাতে বা কাজ সম্পাদন করতে, চ্যাট অ্যাপগুলি চ্যাট API- তে RESTful অনুরোধ করে, যার জন্য প্রমাণীকরণ এবং অনুমোদন প্রয়োজন।

ব্যবহারকারীর ইন্টারঅ্যাকশনের প্রতিক্রিয়াগুলির জন্য প্রমাণীকরণের প্রয়োজন হয় না

ইন্টারঅ্যাকশন ইভেন্ট গ্রহণ এবং সমলয়ভাবে প্রতিক্রিয়া জানাতে Google Chat অ্যাপগুলিকে ব্যবহারকারী বা Chat অ্যাপ হিসাবে প্রমাণীকরণের প্রয়োজন নেই।

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

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

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

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

  1. ব্যবহারকারী Google Chat-এ Chat অ্যাপে একটি বার্তা পাঠান।
  2. গুগল চ্যাট অ্যাপে বার্তাটি ফরোয়ার্ড করে।
  3. অ্যাপটি বার্তাটি গ্রহণ করে, প্রক্রিয়া করে এবং গুগল চ্যাটে প্রতিক্রিয়া জানায়।
  4. গুগল চ্যাট ব্যবহারকারীর জন্য অথবা একটি স্পেসে প্রতিক্রিয়া রেন্ডার করে।

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

অ্যাসিঙ্ক্রোনাস বার্তাগুলির জন্য প্রমাণীকরণ প্রয়োজন

অ্যাসিঙ্ক্রোনাস বার্তাগুলি তখন ঘটে যখন একটি চ্যাট অ্যাপ চ্যাট API- তে একটি অনুরোধ করে, যার জন্য প্রমাণীকরণ এবং অনুমোদন প্রয়োজন।

চ্যাট এপিআই-তে কল করার মাধ্যমে, চ্যাট অ্যাপগুলি গুগল চ্যাটে বার্তা পোস্ট করতে পারে অথবা কাজগুলি সম্পূর্ণ করতে পারে এবং ব্যবহারকারীর পক্ষে ডেটা অ্যাক্সেস করতে পারে। উদাহরণস্বরূপ, সার্ভার বিভ্রাট সনাক্ত করার পরে, একটি চ্যাট অ্যাপ চ্যাট এপিআই-তে কল করতে পারে:

  • বিভ্রাটের তদন্ত এবং সমাধানের জন্য নিবেদিত একটি চ্যাট স্পেস তৈরি করুন।
  • চ্যাট স্পেসে লোকেদের যোগ করুন।
  • বিভ্রাট সম্পর্কে বিস্তারিত জানাতে চ্যাট স্পেসে একটি বার্তা পোস্ট করুন।

নিচের চিত্রটি একটি চ্যাট অ্যাপ এবং একটি চ্যাট স্পেসের মধ্যে একটি অ্যাসিঙ্ক্রোনাস বার্তা ক্রম দেখায়:

অ্যাসিঙ্ক্রোনাস বার্তাগুলির জন্য প্রমাণীকরণ প্রয়োজন
চিত্র ৩. অ্যাসিঙ্ক্রোনাস বার্তাগুলির জন্য প্রমাণীকরণ প্রয়োজন।

  1. একটি চ্যাট অ্যাপ spaces.messages.create পদ্ধতি ব্যবহার করে চ্যাট API কল করে একটি বার্তা তৈরি করে এবং HTTP অনুরোধে ব্যবহারকারীর শংসাপত্র অন্তর্ভুক্ত করে।
  2. গুগল চ্যাট পরিষেবা অ্যাকাউন্ট বা ব্যবহারকারীর শংসাপত্রের সাহায্যে চ্যাট অ্যাপটিকে প্রমাণীকরণ করে।
  3. গুগল চ্যাট অ্যাপের বার্তা একটি নির্দিষ্ট চ্যাট স্পেসে রেন্ডার করে।

চ্যাট এপিআই স্কোপ

OAuth সম্মতি স্ক্রিনটি কনফিগার করুন এবং ব্যবহারকারী এবং অ্যাপ পর্যালোচকদের কাছে কোন তথ্য প্রদর্শিত হবে তা নির্ধারণ করার জন্য স্কোপগুলি নির্বাচন করুন এবং আপনার অ্যাপটি নিবন্ধন করুন যাতে আপনি পরে এটি প্রকাশ করতে পারেন।

আপনার অ্যাপে প্রদত্ত অ্যাক্সেসের স্তর নির্ধারণ করতে, আপনাকে অনুমোদনের স্কোপগুলি সনাক্ত করতে হবে এবং ঘোষণা করতে হবে। একটি অনুমোদনের স্কোপ হল একটি OAuth 2.0 URI স্ট্রিং যাতে Google Workspace অ্যাপের নাম, এটি কী ধরণের ডেটা অ্যাক্সেস করে এবং অ্যাক্সেসের স্তর থাকে।

অ-সংবেদনশীল স্কোপ

স্কোপ কোড বিবরণ
https://www.googleapis.com/auth/chat.bot

চ্যাট অ্যাপগুলিকে চ্যাট দেখতে এবং বার্তা পাঠাতে দেয়।

এই স্কোপটি শুধুমাত্র পরিষেবা অ্যাকাউন্টের মাধ্যমে অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই স্কোপ ব্যবহার করে ব্যবহারকারীর শংসাপত্র বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে প্রমাণীকরণ করতে পারবেন না।

সংবেদনশীল স্কোপ

স্কোপ কোড বিবরণ
https://www.googleapis.com/auth/chat.spaces চ্যাটে কথোপকথন এবং স্পেস তৈরি করুন এবং মেটাডেটা (ইতিহাস সেটিংস এবং অ্যাক্সেস সেটিংস সহ) দেখুন বা সম্পাদনা করুন।
https://www.googleapis.com/auth/chat.spaces.create চ্যাটে নতুন কথোপকথন তৈরি করুন।
https://www.googleapis.com/auth/chat.spaces.readonly চ্যাটে চ্যাট এবং স্পেস দেখুন।
https://www.googleapis.com/auth/chat.memberships চ্যাটে কথোপকথন দেখুন, যোগ করুন, আপডেট করুন এবং সদস্যদের সরিয়ে দিন।
https://www.googleapis.com/auth/chat.memberships.app Google Chat-এ কথোপকথন যোগ করে এবং সরিয়ে দেয়।
https://www.googleapis.com/auth/chat.memberships.readonly চ্যাট কথোপকথনে সদস্যদের দেখুন।
https://www.googleapis.com/auth/chat.messages.create চ্যাটে বার্তা লিখুন এবং পাঠান।
https://www.googleapis.com/auth/chat.messages.reactions চ্যাটে মেসেজে প্রতিক্রিয়া দেখুন, যোগ করুন এবং মুছুন।
https://www.googleapis.com/auth/chat.messages.reactions.create চ্যাটে কোনও বার্তায় প্রতিক্রিয়া যোগ করুন।
https://www.googleapis.com/auth/chat.messages.reactions.readonly চ্যাটে কোনও বার্তার প্রতিক্রিয়া দেখুন।
https://www.googleapis.com/auth/chat.users.readstate চ্যাট কথোপকথনের শেষ পঠনের সময় দেখুন এবং পরিবর্তন করুন।
https://www.googleapis.com/auth/chat.users.readstate.readonly চ্যাট কথোপকথনের শেষ পঠনের সময় দেখুন।
https://www.googleapis.com/auth/chat.admin.spaces.readonly চ্যাটে অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন চ্যাট এবং স্পেস দেখুন।
https://www.googleapis.com/auth/chat.admin.spaces চ্যাটে অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন চ্যাট এবং স্পেসগুলি দেখুন বা সম্পাদনা করুন।
https://www.googleapis.com/auth/chat.admin.memberships.readonly চ্যাটে প্রশাসকের ডোমেনের মালিকানাধীন কথোপকথনে সদস্য এবং পরিচালকদের দেখুন।
https://www.googleapis.com/auth/chat.admin.memberships চ্যাটে অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন কথোপকথনে সদস্য এবং পরিচালকদের দেখুন, যোগ করুন, আপডেট করুন এবং সরান।
https://www.googleapis.com/auth/chat.app.spaces

চ্যাট অ্যাপ হিসেবে চ্যাটে কথোপকথন এবং স্পেস তৈরি করুন এবং মেটাডেটা (ইতিহাস সেটিংস এবং অ্যাক্সেস সেটিংস সহ) দেখুন বা আপডেট করুন। প্রশাসকের অনুমোদন প্রয়োজন।

এই স্কোপটি শুধুমাত্র পরিষেবা অ্যাকাউন্টের মাধ্যমে অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই স্কোপ ব্যবহার করে ব্যবহারকারীর শংসাপত্র বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে প্রমাণীকরণ করতে পারবেন না।

https://www.googleapis.com/auth/chat.app.spaces.create

চ্যাট অ্যাপ হিসেবে চ্যাটে নতুন কথোপকথন এবং স্পেস তৈরি করুন। প্রশাসকের অনুমোদন প্রয়োজন।

এই স্কোপটি শুধুমাত্র পরিষেবা অ্যাকাউন্টের মাধ্যমে অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই স্কোপ ব্যবহার করে ব্যবহারকারীর শংসাপত্র বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে প্রমাণীকরণ করতে পারবেন না।

https://www.googleapis.com/auth/chat.app.memberships

চ্যাট অ্যাপ হিসেবে চ্যাটে কথোপকথন এবং স্পেস থেকে সদস্যদের দেখুন, যোগ করুন, আপডেট করুন এবং সরান। প্রশাসকের অনুমোদন প্রয়োজন।

এই স্কোপটি শুধুমাত্র পরিষেবা অ্যাকাউন্টের মাধ্যমে অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই স্কোপ ব্যবহার করে ব্যবহারকারীর শংসাপত্র বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে প্রমাণীকরণ করতে পারবেন না।

https://www.googleapis.com/auth/chat.customemojis চ্যাটে কাস্টম ইমোজি দেখুন, তৈরি করুন এবং মুছুন।
https://www.googleapis.com/auth/chat.customemojis.readonly চ্যাটে কাস্টম ইমোজি দেখুন।
https://www.googleapis.com/auth/chat.users.spacesettings চ্যাট ব্যবহারকারীর স্থান সেটিংস দেখুন এবং আপডেট করুন।

সীমাবদ্ধ সুযোগ

স্কোপ কোড বিবরণ
https://www.googleapis.com/auth/chat.delete চ্যাটে কথোপকথন এবং স্পেস মুছে ফেলুন এবং সংশ্লিষ্ট ফাইলগুলিতে অ্যাক্সেস সরিয়ে দিন।
https://www.googleapis.com/auth/chat.import চ্যাটে স্পেস, মেসেজ এবং মেম্বারশিপ ইমপোর্ট করুন। আরও তথ্যের জন্য, ডেটা ইমপোর্ট করার জন্য চ্যাট অ্যাপগুলিকে অনুমোদন করুন দেখুন।
https://www.googleapis.com/auth/chat.messages বার্তাগুলি দেখুন, রচনা করুন, পাঠান, আপডেট করুন এবং মুছে ফেলুন, এবং বার্তাগুলিতে প্রতিক্রিয়া যোগ করুন, দেখুন এবং মুছে ফেলুন।
https://www.googleapis.com/auth/chat.messages.readonly চ্যাটে বার্তা এবং প্রতিক্রিয়া দেখুন।
https://www.googleapis.com/auth/chat.app.messages.readonly

চ্যাট অ্যাপ হিসেবে চ্যাটে বার্তা এবং প্রতিক্রিয়া দেখুন। প্রশাসকের অনুমোদন প্রয়োজন।

এই স্কোপটি শুধুমাত্র পরিষেবা অ্যাকাউন্টের মাধ্যমে অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই স্কোপ ব্যবহার করে ব্যবহারকারীর শংসাপত্র বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে প্রমাণীকরণ করতে পারবেন না।

https://www.googleapis.com/auth/chat.admin.delete অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন কথোপকথন এবং স্পেস মুছে ফেলুন এবং চ্যাটে সংশ্লিষ্ট ফাইলগুলিতে অ্যাক্সেস সরিয়ে ফেলুন।
https://www.googleapis.com/auth/chat.app.delete

চ্যাট অ্যাপ হিসেবে চ্যাটে কথোপকথন এবং স্পেস মুছে ফেলুন এবং সংশ্লিষ্ট ফাইলগুলিতে অ্যাক্সেস সরিয়ে ফেলুন। প্রশাসকের অনুমোদন প্রয়োজন।

এই স্কোপটি শুধুমাত্র পরিষেবা অ্যাকাউন্টের মাধ্যমে অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই স্কোপ ব্যবহার করে ব্যবহারকারীর শংসাপত্র বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে প্রমাণীকরণ করতে পারবেন না।

পূর্ববর্তী সারণির স্কোপগুলি নিম্নলিখিত সংজ্ঞা অনুসারে তাদের সংবেদনশীলতা নির্দেশ করে:

যদি আপনার অ্যাপের অন্য কোনও Google API-তে অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনি সেই স্কোপগুলিও যোগ করতে পারেন। Google API স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google API-তে অ্যাক্সেস করার জন্য OAuth 2.0 ব্যবহার করা দেখুন।

Google Workspace API-এর স্কোপ সম্পর্কে আরও জানতে, OAuth সম্মতি স্ক্রিন কনফিগার করুন দেখুন এবং স্কোপ বেছে নিন ।

প্রয়োজনীয় প্রমাণীকরণের প্রকারগুলি

চ্যাট অ্যাপগুলি চ্যাট API ব্যবহার করে দুটি উপায়ে প্রমাণীকরণ এবং অনুমোদন করতে পারে:

ব্যবহারকারী প্রমাণীকরণ
ব্যবহারকারীর প্রমাণীকরণের মাধ্যমে একটি চ্যাট অ্যাপ ব্যবহারকারীর ডেটা অ্যাক্সেস করতে পারে এবং ব্যবহারকারীর পক্ষ থেকে পদক্ষেপগুলি সম্পূর্ণ করতে পারে। OAuth স্কোপ অনুমোদিত ডেটা এবং পদক্ষেপগুলি নির্দিষ্ট করে। যদি না চ্যাট অ্যাপটি অ্যাডমিন ইনস্টল করা থাকে বা ডোমেন-ওয়াইড ডেলিগেশন দেওয়া হয়, তাহলে প্রথমবার যখন চ্যাট অ্যাপটি ব্যবহারকারীর পক্ষ থেকে কোনও পদক্ষেপ নেয়, তখন ব্যবহারকারীকে OAuth সম্মতি স্ক্রিন ব্যবহার করে চ্যাট অ্যাপটিকে অনুমোদন করতে হবে।
অ্যাপ প্রমাণীকরণ

অ্যাপ প্রমাণীকরণের মাধ্যমে একটি চ্যাট অ্যাপ পরিষেবা অ্যাকাউন্টের শংসাপত্র ব্যবহার করতে এবং ডেটা অ্যাক্সেস করতে এবং নিজেই কাজগুলি সম্পূর্ণ করতে পারে। যেহেতু চ্যাট অ্যাপ রিসোর্স অ্যাক্সেস এবং কাজ করার জন্য নিজস্ব শংসাপত্র ব্যবহার করে, তাই শেষ ব্যবহারকারীদের চ্যাট অ্যাপের API কলগুলি অনুমোদন করার প্রয়োজন হয় না এবং আপনি OAuth অনুমোদনের স্কোপগুলি OAuth সম্মতি স্ক্রিনে যোগ করতে পারবেন না যা অ্যাপ অনুমোদন সমর্থন করে।

দুই ধরণের OAuth অনুমোদনের স্কোপ অ্যাপ প্রমাণীকরণ সমর্থন করে:

  • https://www.googleapis.com/auth/chat.bot : আপনার চ্যাট অ্যাপ এই অনুমোদনের সুযোগ সমর্থন করে এমন Google Chat API পদ্ধতিতে কল করে এমন রিসোর্স তৈরি করতে, আপডেট করতে, পেতে, তালিকাভুক্ত করতে বা মুছে ফেলতে পারে, যেমন স্পেসের বার্তা যেখানে শেষ ব্যবহারকারীরা আপনার চ্যাট অ্যাপ যোগ করে। আপনার চ্যাট অ্যাপ এই অনুমোদনের সুযোগটি স্ব-অনুমোদন করতে পারে, কোনও প্রশাসক বা শেষ ব্যবহারকারীর অনুমোদনের প্রয়োজন নেই।
  • https://www.googleapis.com/auth/chat.app.* : এই স্কোপগুলি ব্যবহার করার জন্য একবার প্রশাসকের অনুমোদন প্রয়োজন। প্রশাসকের অনুমোদন পেতে, আপনি Google Workspace Marketplace-সামঞ্জস্যপূর্ণ OAuth ক্লায়েন্ট তৈরি করে এবং Google Workspace Marketplace SDK-তে অ্যাপটি কনফিগার করে প্রশাসকের অনুমোদন পাওয়ার জন্য Chat অ্যাপের পরিষেবা অ্যাকাউন্ট প্রস্তুত করেন । এই স্কোপগুলি আপনার Chat অ্যাপকে নির্দিষ্ট Google Chat API পদ্ধতিতে কল করার অনুমতি দেয়। উদাহরণস্বরূপ, chat.app.spaces.create অ্যাপগুলিকে চ্যাট স্পেস তৈরি করার অনুমতি দেয়।

যদি কোনও পদ্ধতি ব্যবহারকারী বা অ্যাপ উভয় প্রমাণীকরণ সমর্থন করে, তাহলে চ্যাট API আপনার ব্যবহৃত প্রমাণীকরণের ধরণের উপর ভিত্তি করে বিভিন্ন ফলাফল প্রদান করে:

  • অ্যাপ প্রমাণীকরণের ক্ষেত্রে, পদ্ধতিগুলি কেবল সেই রিসোর্সগুলি ফেরত দেয় যা চ্যাট অ্যাপ অ্যাক্সেস করতে পারে।
  • ব্যবহারকারী প্রমাণীকরণের মাধ্যমে, পদ্ধতিগুলি কেবল সেই সংস্থানগুলি ফেরত দেয় যা ব্যবহারকারী অ্যাক্সেস করতে পারে।

উদাহরণস্বরূপ, অ্যাপ অনুমোদনের মাধ্যমে spaces.list() পদ্ধতিতে কল করলে চ্যাট অ্যাপটি যে স্পেসের সদস্য, তার তালিকা ফেরত আসে। ব্যবহারকারী অনুমোদনের মাধ্যমে spaces.list() পদ্ধতিতে কল করলে ব্যবহারকারী যে স্পেসের সদস্য, তার তালিকা ফেরত আসে। বাস্তবে, আপনার চ্যাট অ্যাপের ডিজাইন এবং বৈশিষ্ট্যের উপর নির্ভর করে চ্যাট API কল করার সময় আপনি উভয় ধরণের প্রমাণীকরণ ব্যবহার করতে পারেন।

অ্যাসিঙ্ক্রোনাস চ্যাট এপিআই কলের জন্য

নিম্নলিখিত টেবিলে Chat API পদ্ধতি এবং তাদের সমর্থিত অনুমোদনের সুযোগগুলি তালিকাভুক্ত করা হয়েছে:

পদ্ধতি ব্যবহারকারী প্রমাণীকরণ সমর্থিত অ্যাপ প্রমাণীকরণ সমর্থিত অনুমোদনের সুযোগ সমর্থিত
স্পেস
একটি স্থান তৈরি করুন ব্যবহারকারী প্রমাণীকরণের সাথে:
  • 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
  • chat.import
অ্যাপ প্রমাণীকরণের মাধ্যমে:
  • chat.bot
একটি বার্তা মুছুন ব্যবহারকারী প্রমাণীকরণের সাথে:
  • chat.messages
  • chat.import
অ্যাপ প্রমাণীকরণের মাধ্যমে:
  • 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
মহাকাশ ইভেন্ট
মহাকাশ সংক্রান্ত ইভেন্টগুলি পান — ব্যবহারকারী প্রমাণীকরণের ক্ষেত্রে, আপনাকে ইভেন্টের ধরণের উপর ভিত্তি করে একটি স্কোপ ব্যবহার করতে হবে:
  • বার্তা সম্পর্কিত ইভেন্টের জন্য:
    • 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

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

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

দৃশ্যকল্প কোনও প্রমাণীকরণের প্রয়োজন নেই ব্যবহারকারী প্রমাণীকরণ সমর্থিত অ্যাপ প্রমাণীকরণ সমর্থিত
এর থেকে বার্তা গ্রহণ করুন:
চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্ট — —
অ্যাপস স্ক্রিপ্ট কলব্যাক — —
গুগল ক্লাউড পাব/সাব — —
বার্তাগুলির উত্তর দিন:
সিঙ্ক্রোনাসভাবে, একটি চ্যাট অ্যাপ ইন্টারঅ্যাকশন ইভেন্ট ব্যবহার করে — —
সিঙ্ক্রোনাসভাবে, একটি অ্যাপস স্ক্রিপ্ট কলব্যাক ব্যবহার করে মান ফেরত দেওয়া হচ্ছে — —
নতুন বার্তা পাঠান:
ইনকামিং ওয়েবহুক সহ — —