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

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

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

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

পূর্বশর্ত

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

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

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

ফিল্ড বিবরণ ফর্ম্যাট
অ্যাপের নাম Chat অ্যাপের জন্য ডিসপ্লে নাম। সর্বাধিক ২৫টি বর্ণসাংখ্যিক অক্ষর
অবতার URL আপনার Chat অ্যাপের অবতার হিসেবে যে ছবি দেখানো হয়। একটি HTTPS URL যা একটি বর্গাকার গ্রাফিক্স ছবি (PNG বা JPEG) নির্দেশ করে। সাজেস্ট করা সাইজ হল ২৫৬ x ২৫৬ পিক্সেল বা তার বেশি।
বিবরণ Chat অ্যাপের সংক্ষিপ্ত বিবরণ, যা ব্যবহারকারীরা Chat-এ অ্যাপ সার্চ করলে দেখানো হয়। সর্বাধিক ৪০টি বর্ণসাংখ্যিক অক্ষর
দীর্ঘ বিবরণ ঐচ্ছিক। Chat অ্যাপ কী করতে পারে তার বিবরণ, ব্যবহারকারীরা Chat অ্যাপের সাথে কথোপকথন শুরু করলে বা এজেন্টের জন্য সেশন হোম পেজ খুললে দেখানো হয়। ডেভেলপার প্রিভিউ প্রোগ্রাম-এর অংশ হিসেবে উপলভ্য। বর্তমানে শুধুমাত্র Google Cloud কনসোল ব্যবহার করে অ্যাপ কনফিগারেশন আপডেট করার সময় কাজ করে এবং Google Workspace অ্যাড-অন API-এর মাধ্যমে কাজ করে না। সর্বাধিক ২৫০টি অক্ষর

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

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

Google 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. ঐচ্ছিক: বিস্তারিত বিবরণ ফিল্ড পূরণ করুন (Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রাম-এর অংশ হিসেবে উপলভ্য)।

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

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

    ইন্টার‍্যাক্টিভ 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 বেছে নিন এবং টপিকের নাম লিখুন।

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

      • অ্যাপ হোম (যদি অ্যাপ হোম সাপোর্ট করে বিকল্প চালু থাকে): ব্যবহারকারী Chat অ্যাপের সাথে ১:১ সরাসরি মেসেজে হোম ট্যাব খোলেন।
      • স্পেসে যোগ করা হয়েছে: কোনও ব্যবহারকারী গ্রুপ কথোপকথন বা স্পেসে Chat অ্যাপ যোগ করেন অথবা ১:১ মেসেজের জন্য Chat অ্যাপ ইনস্টল করেন।
      • মেসেজ: কোনও ব্যবহারকারী Chat অ্যাপে মেসেজ পাঠান। যেমন, কোনও ব্যবহারকারী Chat অ্যাপে সরাসরি মেসেজ পাঠান অথবা একাধিক ব্যক্তির সাথে কোনও স্পেসে Chat অ্যাপকে @উল্লেখ করেন।
      • স্পেস থেকে সরিয়ে দেওয়া হয়েছে: কোনও ব্যবহারকারী স্পেস থেকে Chat অ্যাপ আনইনস্টল করে বা সরিয়ে দেয়।
      • অ্যাপ কমান্ড: ব্যবহারকারী Chat অ্যাপ থেকে কোনও কুইক কমান্ড, স্ল্যাশ কমান্ড বা মেসেজ অ্যাকশন চালু করেন।

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

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

      • আপনার অ্যাপ ইনস্টল ও টেস্ট করতে, আপনার নিজের ইমেল আইডি লিখুন।
      • Marketplace-এ প্রকাশ না করেই কোনও টিম বা আপনার সম্পূর্ণ সংস্থা জুড়ে ইন্টার্নাল Chat অ্যাপ শেয়ার করতে, এক বা একাধিক Google Group লিখুন। গ্রুপে মেম্বারের সংখ্যার কোনও সীমা নেই। আপনার অ্যাপ chat.app.* স্কোপের জন্য অনুরোধ করলে, অ্যাডমিনিস্ট্রেটরের অনুমোদনের জন্য আপনাকে এখনও অ্যাপ প্রকাশ করতে হবে।
      • আপনার অ্যাডমিনিস্ট্রেটর যদি Marketplace-এ অ্যাপ ইনস্টল করার সুবিধা সাদা তালিকায় থাকা অ্যাপের মধ্যে সীমাবদ্ধ করে দেন, তাহলে Google Cloud কনসোল ডেভেলপমেন্টের জন্য এই ফিল্ডটি পাঁচজন স্বতন্ত্র ব্যবহারকারীর ইমেল আইডিতে সীমাবদ্ধ করে দেয়। অ্যাডমিনিস্ট্রেটর অ্যাপটিকে অনুমোদিত তালিকায় যোগ করার পরেই গ্রুপের দৃশ্যমানতা প্রযোজ্য হয়।

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

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

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

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

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

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

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

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

  1. Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামে আপনার Google Cloud প্রোজেক্ট এনরোল করুন।
  2. আপনার Cloud প্রোজেক্টে Google Workspace অ্যাড-অন API (gsuiteaddons.googleapis.com) চালু করুন। বিকল্প হিসেবে, আপনি Google Cloud কনসোলে Chat অ্যাপ কনফিগারেশন দেখতে বা আপডেট করতে চাইলে অথবা Chat API কল করতে চাইলে, Google Chat API (chat.googleapis.com) চালু করতে পারেন।
  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 অ্যাপ হোস্ট করা ক্লাউড প্রোজেক্টের সংখ্যাসূচক প্রোজেক্ট নম্বর।
  • ACCESS_TOKEN: https://www.googleapis.com/auth/cloud-platform স্কোপের সাথে অনুমোদিত ব্যবহারকারীর OAuth 2.0 অ্যাক্সেস টোকেন।
  • USER_EMAIL: আপনার Google Workspace সংস্থার একটি ইমেল আইডি বা Google Group, Chat অ্যাপ (যেমন, আপনার নিজের ইমেল আইডি) পরীক্ষা করার জন্য অনুমতি তালিকায় যোগ করতে।
  • আপনার 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 অ্যাড-অনের তুলনায় Chat অ্যাপের জন্য আলাদা কনফিগারেশন প্রয়োজন। আপনার অ্যাড-অন যদি অন্যান্য Google Workspace অ্যাপ্লিকেশনকে এক্সটেন্ড করে, তাহলে Chat অ্যাপ কনফিগার করার জন্য নিম্নলিখিত প্রয়োজনীয়তাগুলি বিবেচনা করুন:

  • ব্যক্তিগত ব্যবহারকারী এবং Google Workspace অ্যাডমিনিস্ট্রেটর, উভয়কেই Marketplace থেকে আপনার অ্যাড-অন ইনস্টল করার সুবিধা দিতে হবে। আপনি Marketplace SDK-তে এইসব ইনস্টলেশন সেটিংস কনফিগার করেন।
  • Chat অ্যাপ, ম্যানিফেস্ট-এর addons.common অবজেক্টে অন্যান্য Google Workspace অ্যাপ্লিকেশনের জন্য আপনার কনফিগার করা নাম এবং লোগো ব্যবহার করে না।
  • Google Workspace Marketplace-এ প্রকাশিত অ্যাড-অনের জন্য, আপনি Google Chat API কনফিগারেশন সেটিংসে কোনও পরিবর্তনের ড্রাফ্ট সেভ করতে পারবেন না। আপনি Chat API কনফিগারেশন সেটিংস আপডেট ও সেভ করার পরে, আপডেট করা Chat অ্যাপ অবিলম্বে সব বর্তমান ব্যবহারকারীর জন্য উপলভ্য হয়ে যায়। আপনার Marketplace লিস্টিং আপডেট করতে, কোনও পরিবর্তন জমা দেওয়ার আগে আপনি ড্রাফ্ট তৈরি করতে পারবেন।
  • আপনি যদি Apps Script ব্যবহার করে অ্যাড-অন তৈরি করে থাকেন:
  • আপনি 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 প্রোজেক্টের প্রোজেক্ট আইডি।

অ্যাড-অন নয় এমন 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 অ্যাড-অনে পরিবর্তন করুন দেখুন।