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

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

প্রক্রিয়ার সংক্ষিপ্ত বিবরণ

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

1. একটি গুগল ক্লাউড প্রজেক্ট কনফিগার করুন, চ্যাট এপিআই সক্রিয় করুন এবং আপনার চ্যাট অ্যাপ কনফিগার করুন: ডেভেলপমেন্টের সময়, আপনি একটি গুগল ক্লাউড প্রজেক্ট তৈরি করেন। গুগল ক্লাউড প্রজেক্টে, আপনি চ্যাট এপিআই সক্রিয় করেন, আপনার চ্যাট অ্যাপ কনফিগার করেন এবং অথেনটিকেশন সেট আপ করেন। আরও তথ্যের জন্য, ‘ডেভেলপ অন গুগল ওয়ার্কস্পেস’ এবং ‘বিল্ড এ চ্যাট অ্যাপ’ দেখুন।

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

3. রিসোর্সের জন্য অনুরোধ : আপনার অ্যাপ সেইসব স্কোপের মাধ্যমে অ্যাক্সেসের অনুরোধ করে, যা আপনি অথেনটিকেশন সেট আপ করার সময় নির্দিষ্ট করে দেন।

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

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

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

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

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

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

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

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

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

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

ব্যবহারকারীর ক্রিয়াকলাপের প্রতিক্রিয়া জানাতে প্রমাণীকরণের প্রয়োজন হয় না।

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

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

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

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

1. ব্যবহারকারী গুগল চ্যাটের চ্যাট অ্যাপে একটি বার্তা পাঠান।
2. গুগল চ্যাট বার্তাটি অ্যাপে পাঠিয়ে দেয়।
3. অ্যাপটি বার্তাটি গ্রহণ করে, সেটির প্রক্রিয়াকরণ করে এবং গুগল চ্যাটে একটি প্রতিক্রিয়া ফেরত পাঠায়।
4. গুগল চ্যাট ব্যবহারকারীকে বা একটি নির্দিষ্ট স্থানে প্রতিক্রিয়াটি প্রদর্শন করে।

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

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

যখন কোনো চ্যাট অ্যাপ চ্যাট এপিআই-এর কাছে অনুরোধ পাঠায়, তখন অ্যাসিঙ্ক্রোনাস মেসেজ তৈরি হয়, যার জন্য প্রমাণীকরণ এবং অনুমোদন প্রয়োজন।

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

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

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

1. একটি চ্যাট অ্যাপ spaces.messages.create মেথড ব্যবহার করে চ্যাট এপিআই কল করার মাধ্যমে একটি মেসেজ তৈরি করে এবং এইচটিটিপি রিকোয়েস্টে ব্যবহারকারীর ক্রেডেনশিয়াল অন্তর্ভুক্ত করে।
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	গুগল চ্যাটের কথোপকথনে নিজেকে যুক্ত করা এবং সরিয়ে ফেলা।
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.readonly	চ্যাট অ্যাপ হিসেবে চ্যাট-এ মেটাডেটা (হিস্ট্রি সেটিংস সহ) দেখুন। এর জন্য অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপটি শুধুমাত্র সার্ভিস অ্যাকাউন্ট ব্যবহার করে অ্যাপ অথেনটিকেশন সমর্থন করে। এই স্কোপ ব্যবহার করে আপনি ইউজার ক্রেডেনশিয়াল বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে অথেনটিকেশন করতে পারবেন না।
https://www.googleapis.com/auth/chat.app.spaces.create	একটি চ্যাট অ্যাপ হিসেবে চ্যাট-এ নতুন কথোপকথন এবং স্পেস তৈরি করুন। এর জন্য অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপটি শুধুমাত্র সার্ভিস অ্যাকাউন্ট ব্যবহার করে অ্যাপ অথেনটিকেশন সমর্থন করে। এই স্কোপ ব্যবহার করে আপনি ইউজার ক্রেডেনশিয়াল বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে অথেনটিকেশন করতে পারবেন না।
https://www.googleapis.com/auth/chat.app.memberships	একটি চ্যাট অ্যাপ হিসেবে চ্যাট-এর মধ্যে কথোপকথন এবং স্পেস থেকে সদস্যদের দেখুন, যোগ করুন, আপডেট করুন এবং সরিয়ে দিন। এর জন্য অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপটি শুধুমাত্র সার্ভিস অ্যাকাউন্ট ব্যবহার করে অ্যাপ অথেনটিকেশন সমর্থন করে। এই স্কোপ ব্যবহার করে আপনি ইউজার ক্রেডেনশিয়াল বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে অথেনটিকেশন করতে পারবেন না।
https://www.googleapis.com/auth/chat.app.memberships.readonly	চ্যাট অ্যাপ হিসেবে চ্যাট-এর কথোপকথন এবং স্পেসের সদস্যদের দেখুন। এর জন্য অ্যাডমিনিস্ট্রেটরের অনুমোদন প্রয়োজন। এই স্কোপটি শুধুমাত্র সার্ভিস অ্যাকাউন্ট ব্যবহার করে অ্যাপ অথেনটিকেশন সমর্থন করে। এই স্কোপ ব্যবহার করে আপনি ইউজার ক্রেডেনশিয়াল বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে অথেনটিকেশন করতে পারবেন না।
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.users.sections	চ্যাটে আপনার সেকশনগুলো দেখুন, তৈরি করুন, আপডেট করুন এবং মুছে ফেলুন; চ্যাটে আপনার সেকশনের আইটেমগুলো সরান এবং তালিকাভুক্ত করুন।
https://www.googleapis.com/auth/chat.users.sections.readonly	চ্যাটে আপনার সেকশনগুলো এবং সেগুলোর আইটেমগুলো দেখুন।

সীমাবদ্ধ পরিধি

স্কোপ কোড	বর্ণনা
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 Services: User Data Policy and Additional Requirements for Specific API Scopes ”। আরও দেখুন “Steps for apps requesting restricted scopes ”।

আপনার অ্যাপের যদি অন্য কোনো গুগল এপিআই-তে অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনি সেই স্কোপগুলোও যোগ করতে পারেন। গুগল এপিআই স্কোপ সম্পর্কে আরও তথ্যের জন্য, “Using OAuth 2.0 to Access Google APIs” দেখুন।

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

প্রয়োজনীয় প্রমাণীকরণের প্রকারভেদ

চ্যাট অ্যাপগুলো চ্যাট এপিআই-এর সাথে দুইভাবে প্রমাণীকরণ ও অনুমোদন করতে পারে:

ব্যবহারকারী প্রমাণীকরণ

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

অ্যাপ প্রমাণীকরণ

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

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

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

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

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

নিম্নলিখিত সারণিতে চ্যাট এপিআই মেথডসমূহ এবং তাদের সমর্থিত অনুমোদন স্কোপগুলো তালিকাভুক্ত করা হলো:

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

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

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

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

সম্পর্কিত বিষয়

• Google Workspace-এ প্রমাণীকরণ এবং অনুমোদন সম্পর্কে একটি সার্বিক ধারণা পেতে, প্রমাণীকরণ ও অনুমোদন সম্পর্কে জানুন (Learn about authentication & authorization) দেখুন।
• গুগল ক্লাউডে প্রমাণীকরণ এবং অনুমোদন সম্পর্কে একটি সার্বিক ধারণা পেতে, প্রমাণীকরণ সার্বিক ধারণা দেখুন।
• সার্ভিস অ্যাকাউন্ট সম্পর্কে আরও জানতে, সার্ভিস অ্যাকাউন্টস দেখুন।
• Google API-গুলো কীভাবে OAuth 2.0 ব্যবহার করে সে সম্পর্কে আরও জানতে, “Using OAuth 2.0 to Access Google APIs” দেখুন।
• ব্যবহারকারীর পরিচয়পত্র বা একটি পরিষেবা অ্যাকাউন্ট দিয়ে প্রমাণীকরণ এবং অনুমোদন সেট আপ করুন।
• সূক্ষ্ম OAuth অনুমতিগুলি পরিচালনা করতে, Google Chat অ্যাপগুলির জন্য সূক্ষ্ম OAuth অনুমতিগুলি পরিচালনা দেখুন।