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

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

প্রক্রিয়া ওভারভিউ

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

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

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

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

  3. রিকোয়েস্ট রিসোর্স : আপনার অ্যাপটি স্কোপ সহ অ্যাক্সেসের জন্য জিজ্ঞাসা করে যা আপনি প্রমাণীকরণ সেট আপ করার সময় নির্দিষ্ট করেন।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

চ্যাট API স্কোপ

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.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.admin.delete অ্যাডমিনিস্ট্রেটরের ডোমেনের মালিকানাধীন কথোপকথন এবং স্থানগুলি মুছুন এবং চ্যাটে সংশ্লিষ্ট ফাইলগুলির অ্যাক্সেস সরান৷
https://www.googleapis.com/auth/chat.app.delete

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

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

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

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

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

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

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

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

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

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

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

অ্যাসিঙ্ক্রোনাস চ্যাট 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.messages.readonly
  • chat.messages
  • chat.import
একটি বার্তা আপডেট করুন ব্যবহারকারীর প্রমাণীকরণ সহ:
  • 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
মিডিয়া এবং সংযুক্তি
একটি ফাইল সংযুক্তি হিসাবে মিডিয়া আপলোড করুন - ব্যবহারকারীর প্রমাণীকরণ সহ:
  • 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.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

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

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

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