Google Chat API কনফিগার করা

আপনার তৈরি করা প্রতিটি Google Chat অ্যাপের জন্য নিজস্ব Google Cloud প্রোজেক্ট প্রয়োজন, যেখানে Chat API চালু ও কনফিগার করা আছে।

ব্যবহারকারী যাচাইকরণ সহ শুধু-পড়া-যাবে এমন API কল করতে, যেমন স্পেস পাওয়া এবং মেসেজের তালিকা তৈরি করা, আপনাকে শুধু API চালু করতে এবং OAuth ক্লায়েন্ট তৈরি করতে হবে।

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

পূর্বশর্ত

• Google Chat-এ অ্যাক্সেস সহ Google Workspace-এর Business বা Enterprise অ্যাকাউন্ট।
• Google Cloud প্রোজেক্ট তৈরি করুন।
• OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন কনফিগার করুন।
• Google Chat API চালু করুন।

আপনার Chat অ্যাপের জন্য ডিসপ্লে নাম, অবতার ও বিবরণ বেছে নিন

Chat API চালু করার সময়, আপনি Chat অ্যাপের বিবরণ কনফিগার করেন যা Chat-এ ব্যবহারকারীদের দেখানো হয়। এতে ডিসপ্লে নাম, অবতার ও বিবরণ অন্তর্ভুক্ত থাকে। এইসব বিবরণ শুধু Chat-এ দেখা যায়। Marketplace-এ আপনার Chat অ্যাপ প্রকাশ করতে, আপনাকে অবশ্যই সেই বিবরণ উল্লেখ করতে হবে যা আপনার Chat অ্যাপের Marketplace তালিকায় দেখা যায়।

Chat অ্যাপ কনফিগার করার আগে, নিম্নলিখিত তথ্য প্রস্তুত করুন:

ফিল্ড	বিবরণ	ফর্ম্যাট
অ্যাপের নাম	Chat অ্যাপের জন্য ডিসপ্লে নাম।	সর্বাধিক ২৫টি বর্ণসাংখ্যিক অক্ষর
অবতার URL	আপনার Chat অ্যাপের অবতার হিসেবে যে ছবি দেখানো হয়।	একটি HTTPS URL যা একটি বর্গাকার গ্রাফিক্স ছবি (PNG বা JPEG) নির্দেশ করে। সাজেস্ট করা সাইজ হল ২৫৬ x ২৫৬ পিক্সেল বা তার বেশি।
বিবরণ	Chat অ্যাপের উদ্দেশ্যের সংক্ষিপ্ত বিবরণ।	সর্বাধিক ৪০টি বর্ণসাংখ্যিক অক্ষর

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

যেমন, আপনি spaces.create() মেথড কল করলে, Chat অ্যাপের নাম অন্তর্ভুক্ত করে কে স্পেস তৈরি করেছে তার বিবরণে, যেমনটি নিম্নলিখিত ছবিতে দেখানো হয়েছে:

ছবি ১. spaces.create() পদ্ধতি ব্যবহার করে কোনও ব্যবহারকারীর হয়ে স্পেস তৈরি করা হলে, Chat যে অ্যাট্রিবিউশন মেসেজ দেখায়।

Chat অ্যাপের সাথে ইন্টার‍্যাক্ট করতে, ব্যবহারকারীরাও নিম্নলিখিত উপায়ে এই তথ্য দেখেন বা ব্যবহার করেন:

• Chat অ্যাপকে কোনও স্পেসে যোগ করতে বা সেটিতে মেসেজ পাঠাতে @উল্লেখ করুন।
• Chat অ্যাপের মাধ্যমে সরাসরি মেসেজ খুঁজে নিয়ে শুরু করুন। অ্যাপ মেনুতে, সরাসরি মেসেজ Chat অ্যাপের নাম ও অবতার দেখায়।
• কম্পোজ বার থেকে, ব্যবহারকারীরা Chat অ্যাপ ব্রাউজ করতে এবং সেগুলির নাম, অবতার ও বিবরণ দেখতে পারবেন।

Google Cloud কনসোলে আপনার Chat অ্যাপ কনফিগার করুন

আপনার Chat অ্যাপের বিবরণ থাকলে, আপনার Cloud প্রোজেক্ট খুলুন এবং Chat API কনফিগার করুন:

1. Google Cloud কনসোলে, Chat API পৃষ্ঠায় যান এবং কনফিগারেশন পৃষ্ঠায় ক্লিক করুন:

   Chat API কনফিগারেশন পৃষ্ঠায় যান

2. অ্যাপ্লিকেশন তথ্য বিকল্পের অধীনে, অ্যাপের নাম, অবতার URL, এবং বিবরণ ফিল্ড পূরণ করুন।

3. ঐচ্ছিক: মার্কআপ সিনট্যাক্স মেনু থেকে, আপনার Chat অ্যাপের মেসেজের জন্য ডিফল্ট মার্কআপ সিনট্যাক্স (Markdown অথবা Chat) বেছে নিন। টেক্সট ফর্ম্যাটিং এবং API অনুরোধের জন্য Chat কীভাবে মার্কআপ সিনট্যাক্স নির্ধারণ করে সেই সম্পর্কে আরও জানতে, মেসেজ ফর্ম্যাট করুন দেখুন।

4. ইন্টার‍্যাক্টিভ ফিচার বিকল্পের অধীনে, আপনার Chat অ্যাপ ব্যবহারকারীর ইন্টার‍্যাকশনে সাড়া দেয় কিনা তা কনফিগার করুন:

   মনে রাখবেন: আপনার Chat অ্যাপ যদি শুধু Chat API কল করে এবং ব্যবহারকারীর ইন্টার‍্যাকশন রিসিভ বা তার উত্তর না দেয়, তাহলে ইন্টার‍্যাক্টিভ ফিচার চালু করুন বিকল্প বন্ধ রাখুন এবং পরবর্তী ধাপে যান।

   ইন্টার‍্যাক্টিভ Chat অ্যাপ তৈরি করতে, ইন্টার‍্যাক্টিভ ফিচার চালু করুন বিকল্প চালু করুন এবং নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

   1. ফাংশনালিটি-এর অধীনে:
      • ঐচ্ছিক: Chat অ্যাপের সাথে ১:১ সরাসরি মেসেজের হোম ট্যাবে হোমপেজ কার্ড দেখাতে অ্যাপ হোমকে সাপোর্ট করুন বিকল্প বেছে নিন।
      • আপনার Chat অ্যাপ ইনস্টল ও ব্যবহার করার জন্য উপলভ্য করতে, স্পেস ও গ্রুপ কথোপকথনে যোগ দিন বিকল্প বেছে নিন। ডিফল্ট হিসেবে, ব্যবহারকারী ও Chat অ্যাপের মধ্যে নির্দিষ্ট স্পেসে ব্যবহারকারী Chat অ্যাপ ইনস্টল ও মেসেজ করতে পারেন। এছাড়াও, একাধিক ব্যক্তির সাথে স্পেসে ব্যবহারকারী Chat অ্যাপ যোগ করতে ও ইন্টার‍্যাক্ট করতে পারেন।

   2. কানেকশন সেটিংস বিকল্পের মধ্যে, আপনি Chat থেকে ইভেন্ট অবজেক্ট রিসিভ করার জন্য যে আর্কিটেকচার ব্যবহার করতে চান সেটি বেছে নিন:

      • HTTP পরিষেবা ব্যবহার করতে, HTTP এন্ডপয়েন্ট URL বেছে নিন এবং একটি URL প্রদান করুন।
      • Google Apps Script প্রোজেক্ট ব্যবহার করতে, Apps Script বেছে নিন এবং প্রোজেক্টের জন্য ডিপ্লয়মেন্ট আইডি দিন।
      • Dialogflow এজেন্ট ব্যবহার করতে, Dialogflow বেছে নিন, Dialogflow CX বা Dialogflow ES বেছে নিন এবং এজেন্টের রিসোর্সের নাম দিন।
      • Pub/Sub ব্যবহার করতে, Cloud Pub/Sub বেছে নিন এবং বিষয়ের নাম লিখুন।
      সতর্কতা: Apps Script ডেপ্লয়মেন্ট আইডি আগে থেকেই ভরা থাকলে, Cloud প্রোজেক্ট আগে থেকে থাকা Google Workspace অ্যাড-অনের সাথে কানেক্ট করা থাকে। আপনি Chat API-তে ডিপ্লয়মেন্ট আইডি আপডেট করলে, আপনার অ্যাড-অনের জন্য ডিপ্লয়মেন্ট আইডি আপডেট করা হয় এবং Google Workspace Marketplace-এ আপনার তালিকার উপর প্রভাব পড়তে পারে। আপনার অ্যাড-অন কনফিগারেশন পর্যালোচনা করতে, Google Workspace Marketplace SDK-তে আপনার অ্যাপ কনফিগার করুন দেখুন।

   3. ঐচ্ছিক: নির্দিষ্ট এন্ডপয়েন্ট বা ফাংশনে ইভেন্ট অবজেক্ট রাউট করতে, কানেকশন সেটিংস > ট্রিগার বিকল্পে যান এবং নিম্নলিখিত Chat ট্রিগারের জন্য কলব্যাক এন্ডপয়েন্ট বা ফাংশন প্রদান বা আপডেট করুন:

      মনে রাখবেন: Apps Script-এর ক্ষেত্রে, আপনি ট্রিগার আপডেট না করলে, আপনাকে অবশ্যই ডিফল্ট কলব্যাক ফাংশন প্রয়োগ করতে হবে যা এই বিভাগে পপুলেট করা হয় (যেমন onMessage, onAddedToSpace, onRemovedFromSpace, onAppCommand এবং onAppHome)।
      • অ্যাপ হোম (যদি অ্যাপ হোম সাপোর্ট করে বিকল্প চালু থাকে): কোনও ব্যবহারকারী Chat অ্যাপের সাথে ১:১ সরাসরি মেসেজে হোম ট্যাব খোলেন।
      • স্পেসে যোগ করা হয়েছে: কোনও ব্যবহারকারী গ্রুপ কথোপকথন বা স্পেসে Chat অ্যাপ যোগ করেন অথবা ১:১ মেসেজের জন্য Chat অ্যাপ ইনস্টল করেন।
      • মেসেজ: কোনও ব্যবহারকারী Chat অ্যাপে মেসেজ পাঠান। যেমন, কোনও ব্যবহারকারী Chat অ্যাপে সরাসরি মেসেজ পাঠান অথবা একাধিক ব্যক্তির সাথে কোনও স্পেসে Chat অ্যাপকে @উল্লেখ করেন।
      • স্পেস থেকে সরানো হয়েছে: কোনও ব্যবহারকারী স্পেস থেকে Chat অ্যাপ আনইনস্টল করে বা সরিয়ে দেয়।
      • অ্যাপ কমান্ড: ব্যবহারকারী Chat অ্যাপ থেকে কোনও কুইক কমান্ড, স্ল্যাশ কমান্ড বা মেসেজ অ্যাকশন চালু করেন।

   4. ঐচ্ছিক: অন্যান্য ইন্ট্যার‍্যাক্টিভ ফিচার যোগ করুন, যেমন স্টার্টার প্রম্পট, কমান্ড (দ্রুত কমান্ড, স্ল্যাশ কমান্ড, এবং মেসেজ অ্যাকশন), অথবা লিঙ্ক প্রিভিউ।

   5. দৃশ্যমানতা বিকল্পের অধীনে, আপনার ইমেল আইডি উল্লেখ করুন যাতে আপনি Google Workspace Marketplace-এ প্রকাশ করার আগে Chat অ্যাপ ইনস্টল ও পরীক্ষা করতে পারেন। আপনি আপনার Google Workspace সংস্থা থেকে সর্বাধিক পাঁচজন ব্যক্তি বা এক বা একাধিক Google Group নির্দিষ্ট করতে পারেন।

5. ঐচ্ছিক: Google Cloud Logging ব্যবহার করতে, লগ বিকল্পের অধীনে, লগিংয়ে লগ সংক্রান্ত সমস্যা চেকবক্স বেছে নিন। আরও তথ্যের জন্য, Chat অ্যাপের জন্য কোয়েরি সংক্রান্ত সমস্যার লগ দেখুন।

6. সেভ করুন বিকল্পে ক্লিক করুন।

আপনি কনফিগারেশন সেভ করার পরে, Chat API-এর দৃশ্যমানতা সেটিংয়ে আপনি যাদের উল্লেখ করেছেন, তারা Chat অ্যাপ ইনস্টল, টেস্ট বা ব্যবহার করতে পারবেন। আপনার Chat অ্যাপ টেস্ট ও ডিবাগ করা শুরু করতে, Google Chat অ্যাপের জন্য ইন্টার‍্যাক্টিভ ফিচার টেস্ট করুন দেখুন।

Google Workspace অ্যাড-অন API ব্যবহার করে আপনার Chat অ্যাপ কনফিগার করুন

ডেভেলপার প্রিভিউ: Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হিসেবে উপলভ্য, যা নির্দিষ্ট কিছু ফিচারে আগেভাগে অ্যাক্সেস প্রদান করে।

Google Cloud কনসোলে ম্যানুয়ালি আপনার Chat অ্যাপ কনফিগার করার পরিবর্তে, Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামে এনরোল করা আপনার Google Cloud প্রোজেক্ট ব্যবহার করে প্রোগ্রাম্যাটিক্যালি, Google Workspace add-ons API-এ chatAppConfig রিসোর্স ব্যবহার করে Google Workspace অ্যাড-অন হিসেবে তৈরি করা Chat অ্যাপের কনফিগারেশন পড়তে ও আপডেট করতে পারবেন।

chatAppConfig হল একটি সিঙ্গলটন রিসোর্স যা প্রতিটি ক্লাউড প্রোজেক্টের জন্য সবসময় থাকে। প্রথমবার কনফিগারেশন সেভ করার আগে, রিসোর্সে একটি খালি কনফিগারেশন থাকে (যা GetChatAppConfig প্রথমবার সেভ করার আগে রিসোর্সটি পড়লে রিটার্ন করে)। রিসোর্সটি আগে থেকেই উপস্থিত আছে, তাই আপনাকে এটি আলাদা করে তৈরি করতে হবে না—প্রাথমিক কনফিগারেশন সেভ করতে এবং আগে থেকে উপস্থিত কনফিগারেশন আপডেট করতে UpdateChatAppConfig উভয়ই ব্যবহার করুন।

মনে রাখবেন: chatAppConfig পদ্ধতি শুধুমাত্র Google Workspace অ্যাড-অন হিসেবে তৈরি করা Chat অ্যাপের ক্ষেত্রে কাজ করে। আগে থেকে থাকা Chat অ্যাপ আপগ্রেড করতে, Google Chat অ্যাপকে Google Workspace অ্যাড-অনে পরিবর্তন করুন দেখুন।

পূর্বশর্ত এবং যাচাইকরণ

GetChatAppConfig বা UpdateChatAppConfig-এ কল করার আগে, নিম্নলিখিত প্রয়োজনীয় কাজগুলি সম্পূর্ণ করুন:

1. আপনার Google Cloud প্রোজেক্ট Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামে নথিভুক্ত করুন।
2. আপনার Cloud প্রোজেক্টে Google Workspace অ্যাড-অন API (gsuiteaddons.googleapis.com) চালু করুন। বিকল্প হিসেবে, আপনি Google Chat API (chat.googleapis.com) চালু করতে পারেন, যদি আপনি Google Cloud কনসোলে Chat অ্যাপ কনফিগারেশন দেখতে বা আপডেট করতে চান অথবা Chat API কল করতে চান।
3. OAuth 2.0 ক্রেডেনশিয়াল ব্যবহার করে হিউম্যান ইউজার হিসেবে যাচাই করুন, যার মধ্যে https://www.googleapis.com/auth/cloud-platform স্কোপ অন্তর্ভুক্ত। chatAppConfig পদ্ধতির জন্য পরিষেবা অ্যাকাউন্ট যাচাইকরণ কাজ করে না।
4. যাচাইকৃত ব্যবহারকারীর টার্গেট ক্লাউড প্রোজেক্টে প্রয়োজনীয় আইডেন্টিটি ও অ্যাক্সেস ম্যানেজমেন্ট (IAM) সংক্রান্ত অনুমতি আছে কিনা তা নিশ্চিত করুন:
   • gsuiteaddons.chatAppConfigs.get এবং chat.bots.get-কে কনফিগারেশন (GetChatAppConfig) পড়ার অনুমতি দিন।
   • কনফিগারেশন (UpdateChatAppConfig) আপডেট করতে gsuiteaddons.chatAppConfigs.update এবং chat.bots.update।
5. আপনি ক্লায়েন্ট লাইব্রেরি ব্যবহার করলে, আপনার রেজিস্টার করা ডেভেলপার প্রিভিউ অ্যাকাউন্ট দিয়ে ডেভেলপার প্রিভিউ ক্লায়েন্ট লাইব্রেরি ডাউনলোড করুন।

Chat অ্যাপ কনফিগারেশন আপডেট করো

প্রথমবার Chat অ্যাপ কনফিগার করতে বা আগে থেকে থাকা কনফিগারেশন আপডেট করতে, আপনার Cloud প্রোজেক্টের জন্য chatAppConfig রিসোর্সের সিঙ্গলটনে PATCH অনুরোধ (UpdateChatAppConfig) পাঠান:

• কোনও ক্লাউড প্রোজেক্টে প্রথমবার সেভ করার সময়, chatAppConfig, displayName (৩ থেকে ২৫টি অক্ষর) এবং description (১ থেকে ৪০টি অক্ষর) প্রয়োজন। আপনি প্রথমবার সেভ করার সময় interactiveFeatureConfig বাদ দিলে, Chat অ্যাপটি নন-ইন্টার‍্যাক্টিভ হিসেবে কনফিগার করা হয়।
• পরবর্তী আপডেটের জন্য, আপডেট করার জন্য কমা দ্বারা পৃথক করা ফিল্ডগুলি নির্দিষ্ট করতে ঐচ্ছিক updateMask কোয়েরি প্যারামিটার ব্যবহার করুন (অথবা সমস্ত প্রদত্ত ফিল্ড আপডেট করতে updateMask বাদ দিন)। পুনরাবৃত্ত ফিল্ড (appCommands, urlPatterns, অথবা allowlistedTestingPrincipals) আপডেট করলে সম্পূর্ণ তালিকাটি বদলে যায়।

PATCH https://gsuiteaddons.googleapis.com/v1/projects/PROJECT_NUMBER/chatAppConfig?updateMask=displayName,description,avatarUri,state,errorLoggingEnabled,markupSyntax,interactiveFeatureConfig
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "name": "projects/PROJECT_NUMBER/chatAppConfig",
  "displayName": "Cymbal Assistant",
  "description": "Helps manage tasks and schedules",
  "avatarUri": "https://www.gstatic.com/dynamite/images/quickstart-app-avatar.png",
  "state": "ACTIVE",
  "errorLoggingEnabled": true,
  "markupSyntax": "MARKUP_SYNTAX_MARKDOWN",
  "interactiveFeatureConfig": {
    "supportsMultiuserSpaces": false,
    "connectionConfig": {
      "httpEndpointConfig": {
        "commonUrl": "https://example.com/chat"
      }
    },
    "appCommands": [
      {
        "commandType": "SLASH_COMMAND",
        "commandId": 1,
        "command": "/help",
        "description": "Show available commands",
        "dialogEnabled": false
      }
    ],
    "urlPatterns": [
      {
        "hostPattern": "example.com",
        "pathPrefix": "tasks/"
      }
    ],
    "allowlistedTestingPrincipals": [
      "USER_EMAIL"
    ]
  }
}

অনুরোধ URL, হেডার ও বডিতে নিম্নলিখিতগুলি পরিবর্তন করুন:

• PROJECT_NUMBER: আপনার Chat অ্যাপ হোস্ট করা Cloud প্রোজেক্টের সংখ্যাসূচক প্রোজেক্ট নম্বর।
• ACCESS_TOKEN: https://www.googleapis.com/auth/cloud-platform স্কোপের সাথে অনুমোদিত ব্যবহারকারীর OAuth 2.0 অ্যাক্সেস টোকেন।
• USER_EMAIL: Chat অ্যাপ পরীক্ষা করার জন্য আপনার Google Workspace সংস্থা থেকে একটি ইমেল আইডি বা Google Group-কে অনুমতি তালিকায় যোগ করুন (যেমন, আপনার নিজের ইমেল আইডি)।
• আপনার Chat অ্যাপের ভ্যালু সহ অনুরোধের বডিতে (যেমন displayName, description, avatarUri এবং interactiveFeatureConfig, আপনার এন্ডপয়েন্ট কনফিগারেশন, কমান্ড, লিঙ্ক প্রিভিউ URL প্যাটার্ন এবং টেস্টিং প্রিন্সিপাল সহ) উদাহরণ কনফিগারেশন ফিল্ড। সব কাজ করে এমন ফিল্ড এবং এন্ডপয়েন্ট বিকল্পের বিবরণের জন্য, projects.chatAppConfig REST রেফারেন্স এবং projects.chatAppConfig.patch দেখুন।

Chat অ্যাপ কনফিগারেশন পাওয়া

কোনও ক্লাউড প্রোজেক্টের জন্য বর্তমান Chat অ্যাপ কনফিগারেশন পড়তে, GetChatAppConfig-এ কল করুন। আপনি ঐচ্ছিক view কোয়েরি প্যারামিটার (ChatAppConfigView) পাস করতে পারবেন:

• BASIC (ডিফল্ট): interactiveFeatureConfig ছাড়াই প্রাথমিক মেটাডেটা রিটার্ন করে।
• FULL: interactiveFeatureConfig সহ সব কনফিগারেশন ফিল্ড ফিরিয়ে দেয়।

Cloud প্রোজেক্টের জন্য Chat অ্যাপ কনফিগারেশন এখনও সেভ করা না হলে, পদ্ধতিটি একটি খালি ChatAppConfig অবজেক্ট রিটার্ন করে।

HTTP

GET https://gsuiteaddons.googleapis.com/v1/projects/PROJECT_NUMBER/chatAppConfig?view=FULL
Authorization: Bearer ACCESS_TOKEN

Node.js

const {GSuiteAddOnsClient} = require('@google-cloud/gsuiteaddons').v1;

const client = new GSuiteAddOnsClient();

async function getChatAppConfig() {
  const [response] = await client.getChatAppConfig({
    name: 'projects/PROJECT_NUMBER/chatAppConfig',
    view: 'FULL',
  });
  console.log(JSON.stringify(response, null, 2));
}

getChatAppConfig();

Python

from google.cloud import gsuiteaddons_v1

client = gsuiteaddons_v1.GSuiteAddOnsClient()

request = gsuiteaddons_v1.GetChatAppConfigRequest(
    name="projects/PROJECT_NUMBER/chatAppConfig",
    view=gsuiteaddons_v1.GetChatAppConfigRequest.ChatAppConfigView.FULL,
)
response = client.get_chat_app_config(request=request)
print(response)

আগে থেকে থাকা Google Workspace অ্যাড-অনের ক্ষেত্রে বিবেচ্য বিষয়

অন্যান্য Google Workspace অ্যাপ্লিকেশনকে এক্সটেন্ড করে এমন Google Workspace অ্যাড-অনের তুলনায় চ্যাট অ্যাপের জন্য আলাদা কনফিগারেশন প্রয়োজন। আপনার অ্যাড-অন যদি অন্যান্য Google Workspace অ্যাপ্লিকেশনকে এক্সটেন্ড করে, তাহলে Chat অ্যাপ কনফিগার করার জন্য নিম্নলিখিত প্রয়োজনীয়তাগুলি বিবেচনা করুন:

• ব্যক্তিগত ব্যবহারকারী এবং Google Workspace অ্যাডমিনিস্ট্রেটর, উভয়কেই Marketplace থেকে আপনার অ্যাড-অন ইনস্টল করার সুবিধা দিতে হবে। আপনি Marketplace SDK-তে এইসব ইনস্টলেশন সেটিংস কনফিগার করেন।
• Chat অ্যাপ আপনার কনফিগার করা নাম ও লোগো ব্যবহার করে না অন্যান্য Google Workspace অ্যাপ্লিকেশনের জন্য addons.common অবজেক্টে ম্যানিফেস্ট-এর।
• Google Workspace Marketplace-এ প্রকাশিত অ্যাড-অনের জন্য, আপনি Google Chat API কনফিগারেশন সেটিংসে কোনও পরিবর্তনের ড্রাফ্ট সেভ করতে পারবেন না। আপনি Chat API কনফিগারেশন সেটিংস আপডেট ও সেভ করার পরে, আপডেট করা Chat অ্যাপ অবিলম্বে সব বর্তমান ব্যবহারকারীর জন্য উপলভ্য হয়ে যায়। আপনার Marketplace তালিকা আপডেট করতে, কোনও পরিবর্তন জমা দেওয়ার আগে আপনি একটি ড্রাফ্ট তৈরি করতে পারেন।
• আপনি যদি Apps Script ব্যবহার করে অ্যাড-অন তৈরি করে থাকেন:
  • আপনার অ্যাড-অন কনফিগারেশনের বাকি অংশের জন্য যে Apps Script ডিপ্লয়মেন্ট আইডি ব্যবহার করেন, আপনাকে অবশ্যই সেই একই আইডি ব্যবহার করতে হবে।
  • Chat-এ টেস্ট ডেপ্লয়মেন্ট ইনস্টল করার জন্য আপনি Apps Script এডিটর ব্যবহার করতে পারবেন না। পরিবর্তে, আপনাকে সরাসরি Chat UI থেকে সেগুলি ইনস্টল করতে হবে।
• আপনি HTTP পরিষেবা ব্যবহার করে আপনার অ্যাড-অন তৈরি করলে, Google Workspace অ্যাড-অন API ব্যবহার করে তৈরি করা projects.deployments ম্যানিফেস্টে Chat অ্যাপ কনফিগারেশনের যেকোনও বিবরণ বাদ দিন। Google Workspace Marketplace SDK-তে আপনি যে HTTP ডেপ্লয়মেন্ট উল্লেখ করেন তা শুধুমাত্র অন্যান্য Google Workspace অ্যাপ্লিকেশনের জন্য ব্যবহার করা হয়। পরিবর্তে, Google Cloud কনসোল-এ বা Google Workspace অ্যাড-অন API-এ chatAppConfig রিসোর্স ব্যবহার করে আপনার Chat অ্যাপ কনফিগার করুন।

Chat API কনফিগার করার জন্য অন্যান্য ব্যক্তিকে অনুমতি দিন

আপনি Chat অ্যাপের মালিক বা Chat অ্যাপের দর্শক Google Cloud Identity Access Management (IAM) ভূমিকা প্রদান করে Chat অ্যাপ কনফিগারেশন পৃষ্ঠায় নির্দিষ্ট ব্যবহারকারীদের অ্যাক্সেস দিতে পারবেন। এইসব ভূমিকা সহ ব্যবহারকারীরা API ও পরিষেবা ড্যাশবোর্ড ব্যবহার করে Chat অ্যাপের কনফিগারেশন পৃষ্ঠায় নেভিগেট করতে পারবেন না, তবে Chat অ্যাপের হোস্ট ক্লাউড প্রোজেক্টের জন্য Google Cloud কনসোলে নেভিগেট করে কনফিগারেশন পৃষ্ঠা অ্যাক্সেস করতে পারবেন:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

যেখানে PROJECT_ID হল Chat অ্যাপ হোস্ট করা Google Cloud প্রোজেক্টের প্রোজেক্ট আইডি।

প্রোজেক্ট ভূমিকায় থাকা ব্যবহারকারীরাও অ্যাপ কনফিগারেশন পৃষ্ঠা অ্যাক্সেস করতে পারবেন।

resourcemanager.projects.(get|update) অনুমতি সহ কাস্টম ভূমিকা থাকা ব্যবহারকারীরা Chat অ্যাপ কনফিগারেশন অ্যাক্সেস করতে পারবেন না। কাস্টম রোলের জন্য, পরিবর্তে chat.bots.(get|update) অনুমতি (এবং Google Workspace অ্যাড-অন API কল করার সময় gsuiteaddons.chatAppConfigs.(get|update)) ব্যবহার করুন।

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

• Chat অ্যাপ আর্কিটেকচার বেছে নিন
• ব্যবহারকারীর ইন্টার‍্যাকশন রিসিভ করা ও তার উত্তর দেওয়া
• Google Chat অ্যাপের জন্য ইন্টার‍্যাক্টিভ ফিচার পরীক্ষা করা

অ্যাড-অন নয় এমন Chat অ্যাপ: Google Chat API কনফিগার করা

আপনি যদি এমন কোনও Chat অ্যাপ ম্যানেজ করেন যা Google Workspace অ্যাড-অন নয়, তাহলে আপনার কনফিগারেশন প্রতিটি ইভেন্টের ট্রিগারের পরিবর্তে সব ইন্টার‍্যাকশন ইভেন্টের জন্য একটি এন্ডপয়েন্ট ব্যবহার করে:

1. Google Cloud কনসোলে, Chat API কনফিগারেশন পৃষ্ঠায় যান:

   Chat API কনফিগারেশন পৃষ্ঠায় যান

2. ইন্টার‍্যাক্টিভ ফিচার বিকল্পের মধ্যে, ইন্টার‍্যাক্টিভ ফিচার চালু করুন বিকল্প চালু করুন।

3. Google Workspace অ্যাড-অন হিসেবে এই Chat অ্যাপ তৈরি করুন বিকল্প থেকে টিকচিহ্ন সরিয়ে দিন। কনফার্ম করার জন্য একটি ডায়ালগ খুলবে। ডায়ালগে, বন্ধ করুন বিকল্পে ক্লিক করুন।

4. ফাংশনালিটি বিকল্পের অধীনে, প্রয়োজন অনুযায়ী অ্যাপ হোম সাপোর্ট করুন অথবা স্পেস ও গ্রুপ কথোপকথনে যোগ দিন বিকল্প বেছে নিন।

5. কানেকশন সেটিংস বিকল্পের অধীনে, আপনার Chat অ্যাপের জন্য একটি এন্ডপয়েন্ট উল্লেখ করুন (HTTP এন্ডপয়েন্ট URL, Apps Script ডিপ্লয়মেন্ট আইডি, Cloud Pub/Sub বিষয়ের নাম, অথবা Dialogflow)।

6. ঐচ্ছিক কমান্ড, লিঙ্ক প্রিভিউ, দৃশ্যমানতা এবং লগ কনফিগার করুন, তারপর সেভ করুন বিকল্পে ক্লিক করুন।

Google Chat-এর কার্যকারিতা বাড়ায় এমন Google Workspace অ্যাড-অনে অ্যাড-অন নয় এমন Chat অ্যাপ আপগ্রেড করতে, Google Chat অ্যাপকে Google Workspace অ্যাড-অনে কনভার্ট করুন দেখুন।