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. ঐচ্ছিক: দীর্ঘ বিবরণ ফিল্ড পূরণ করুন।

  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 Cloud CLI ব্যবহার করে আপনার Chat অ্যাপ কনফিগার করা

Google Cloud কনসোল ব্যবহার করার পরিবর্তে, আপনি Google Cloud CLI (gcloud CLI) ব্যবহার করে কমান্ড লাইন থেকে Chat অ্যাপের কনফিগারেশন দেখতে ও আপডেট করতে পারবেন। যেমন, আপনি স্ক্রিপ্ট থেকে Chat অ্যাপ কনফিগার করতে পারেন অথবা আপনার কোডের সাথে স্টোর করা ফাইলে এর কনফিগারেশন রাখতে পারেন।

gcloud beta workspace-add-ons chat-app-config কমান্ড গ্রুপে নিম্নলিখিত কমান্ড আছে:

  • describe: কনফিগারেশন দেখায়।
  • update: প্রথমবার Chat অ্যাপ কনফিগার করে অথবা এর কনফিগারেশন পরিবর্তন করে।

কমান্ডগুলি Google Workspace অ্যাড-অন API-তে chatAppConfig রিসোর্স ব্যবহার করে।

শুরু করার আগে

  1. gcloud CLI ইনস্টল করুন। আপনি আগে gcloud CLI ইনস্টল করে থাকলে, gcloud components update রান করে লেটেস্ট ভার্সন আছে কিনা তা নিশ্চিত করুন।
  2. আপনার ব্যবহারকারীর অ্যাকাউন্ট দিয়ে gcloud CLI-তে সাইন-ইন করুন। কমান্ডে পরিষেবা অ্যাকাউন্ট কাজ করে না।

    gcloud auth login
  3. আপনার Chat অ্যাপের ক্লাউড প্রোজেক্টকে gcloud CLI-এর ডিফল্ট প্রোজেক্ট হিসেবে সেট করুন। প্রোজেক্ট আইডি ব্যবহার করুন, কারণ কমান্ডে প্রোজেক্ট নম্বর ব্যবহার করা যায় না।

    gcloud config set project PROJECT_ID

    বিকল্প হিসেবে, প্রতিটি কমান্ডে --project ফ্ল্যাগ যোগ করুন।

  4. ক্লাউড প্রোজেক্টে Google Workspace অ্যাড-অন API চালু করুন:

    gcloud services enable gsuiteaddons.googleapis.com
  5. ক্লাউড প্রোজেক্টে আপনার নিম্নলিখিত আইডেন্টিটি ও অ্যাক্সেস ম্যানেজমেন্ট (IAM) ভূমিকা আছে কিনা তা নিশ্চিত করুন:

    • কনফিগারেশন দেখতে ও আপডেট করতে Google Workspace অ্যাড-অন ডেভেলপার (roles/gsuiteaddons.developer) অথবা শুধু এটি দেখতে Google Workspace অ্যাড-অন রিডার (roles/gsuiteaddons.reader)। এইসব ভূমিকার মধ্যে পূর্বপ্রয়োজনীয়তা ও যাচাইকরণ বিভাগে তালিকাভুক্ত অনুমতি অন্তর্ভুক্ত থাকে।
    • পরিষেবা ব্যবহারকারী গ্রাহক (roles/serviceusage.serviceUsageConsumer)। gcloud CLI তার অনুরোধের জন্য কোটা প্রোজেক্ট হিসেবে Cloud প্রোজেক্ট ব্যবহার করে, যার জন্য serviceusage.services.use অনুমতি প্রয়োজন।

    মালিক ও এডিটর ভূমিকায় এই সব অনুমতি অন্তর্ভুক্ত থাকে। Chat অ্যাপের মালিক এবং Chat অ্যাপের দর্শক ভূমিকা, যা Google Cloud কনসোলে কনফিগারেশন পৃষ্ঠায় অ্যাক্সেস দেয়, তা যথেষ্ট নয়।

কনফিগারেশন দেখুন

আপনার Chat অ্যাপের কনফিগারেশন দেখতে, describe কমান্ড রান করুন:

gcloud beta workspace-add-ons chat-app-config describe

আউটপুটটি নিম্নলিখিতটির মতো:

avatarUri: https://www.gstatic.com/dynamite/images/quickstart-app-avatar.png
description: Helps manage tasks and schedules
displayName: Cymbal Assistant
errorLoggingEnabled: true
interactiveFeatureConfig:
  allowlistedTestingPrincipals:
  - user@example.com
  appCommands:
  - command: /help
    commandId: 1
    commandType: SLASH_COMMAND
    description: Show available commands
  connectionConfig:
    httpEndpointConfig:
      commonUrl: https://example.com/chat
  supportsMultiuserSpaces: true
  urlPatterns:
  - hostPattern: example.com
    pathPrefix: tasks/
name: projects/123456789012/chatAppConfig
state: ACTIVE

Cloud প্রোজেক্টে এখনও কোনও Chat অ্যাপ না থাকলে, কমান্ডটি সফল হয় এবং কনফিগারেশনের শুধুমাত্র name ফিল্ডটি প্রিন্ট করে:

name: projects/123456789012/chatAppConfig

আউটপুট পরিবর্তন করতে, নিম্নলিখিত ফ্ল্যাগগুলির মধ্যে একটি যোগ করুন:

  • --format=json: JSON ফর্ম্যাটে কনফিগারেশন প্রিন্ট করে।
  • --view=basic: ইন্টার‍্যাক্টিভ ফিচার সেটিংস বাদ দেয় (interactiveFeatureConfig)।
  • --format="value(displayName)": শুধু ডিসপ্লে নাম প্রিন্ট করে, অথবা Cloud প্রোজেক্টে এখনও Chat অ্যাপ না থাকলে, একটি ফাঁকা লাইন প্রিন্ট করে। কনফিগার করা Chat অ্যাপের সবসময় একটি ডিসপ্লে নাম থাকে, তাই আপনি স্ক্রিপ্টে এই ফ্ল্যাগ ব্যবহার করে চেক করতে পারবেন যে Chat অ্যাপ আছে কিনা।

কনফিগারেশন আপডেট করুন

প্রথমবার Chat অ্যাপ কনফিগার করতে অথবা এর কনফিগারেশন পরিবর্তন করতে, update কমান্ড রান করুন। ফ্ল্যাগ বা কনফিগারেশন ফাইলে সেটিংস উল্লেখ করুন। আপনি একটি কমান্ডে দুটি একত্রিত করতে পারবেন না।

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

ফ্ল্যাগ ব্যবহার করুন

নিম্নলিখিত উদাহরণটি এমন একটি Chat অ্যাপ কনফিগার করে যা HTTP এন্ডপয়েন্টে ইভেন্ট রিসিভ করে:

gcloud beta workspace-add-ons chat-app-config update \
    --display-name="Quickstart App" \
    --description="Quickstart app" \
    --avatar-uri=https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png \
    --http-endpoint-url=HTTP_ENDPOINT_URL \
    --supports-multiuser-spaces \
    --add-allowlisted-testing-principals=USER_EMAIL \
    --error-logging-enabled

নিম্নলিখিতগুলি পরিবর্তন করুন:

  • HTTP_ENDPOINT_URL: HTTPS URL যা Chat থেকে ইভেন্ট অবজেক্ট রিসিভ করে।
  • USER_EMAIL: আপনার Google Workspace সংস্থার কোনও ব্যক্তি বা গ্রুপের ইমেল আইডি যারা Chat অ্যাপ ইনস্টল ও পরীক্ষা করতে পারবেন, যেমন আপনার নিজের ইমেল আইডি।

কমান্ডটি আপডেট করা কনফিগারেশন প্রিন্ট করে।

নিচের সারণীতে Google Cloud কনসোলের Chat API কনফিগারেশন পৃষ্ঠায় সেটিংসের জন্য ফ্ল্যাগ তালিকাভুক্ত করা হয়েছে। প্রতিটি ফ্ল্যাগ সম্পর্কে বিস্তারিত জানতে, update কমান্ড রেফারেন্স দেখুন।

Google Cloud Console-এ সেটিং পতাকা
অ্যাপের নাম --display-name
অবতার URL --avatar-uri-এর সাথে এমন একটি ছবির HTTPS URL যা অবতারের প্রয়োজনীয়তা পূরণ করে, অথবা --clear-avatar-uri ডিফল্ট অবতার ব্যবহার করতে
বিবরণ --description
অ্যাপের স্ট্যাটাস --state=active বা --state=disabled
মার্কআপ সিনট্যাক্স --markup-syntax=markdown বা --markup-syntax=chat
স্পেস ও গ্রুপ কথোপকথনে যোগ দিন --supports-multiuser-spaces বা --no-supports-multiuser-spaces
কানেকশন সেটিংস নিম্নলিখিতগুলির মধ্যে যেকোনও একটি:
  • HTTP এন্ডপয়েন্ট URL: --http-endpoint-url
  • Apps স্ক্রিপ্ট: --apps-script-deployment-id
  • Cloud Pub/Sub: --pubsub-topic একই Cloud প্রোজেক্টে একটি বিষয়ের সাথে, projects/PROJECT_ID/topics/TOPIC_ID ফর্ম্যাটে
  • Dialogflow: --dialogflow-edition=es, অথবা --dialogflow-edition=cx-এর সাথে --dialogflow-agent এজেন্টের রিসোর্স নাম বা এনভায়রনমেন্টে সেট করা, যেমন projects/PROJECT_ID/locations/LOCATION/agents/AGENT_ID
দৃশ্যমানতা --add-allowlisted-testing-principals, --remove-allowlisted-testing-principals এবং --clear-allowlisted-testing-principals
লগিংয়ে সমস্যা লগ করুন --error-logging-enabled বা --no-error-logging-enabled

কমান্ড, লিঙ্ক প্রিভিউ এবং প্রতিটি ট্রিগারের জন্য আলাদা এন্ডপয়েন্টে কোনও ফ্ল্যাগ থাকে না। সেগুলি কনফিগার করতে, কনফিগারেশন ফাইল ব্যবহার করুন।

যেমন, অন্যান্য সেটিংস পরিবর্তন না করে আপনার Chat অ্যাপ বন্ধ করতে নিম্নলিখিত কমান্ড রান করুন। এটি আবার চালু করতে, --state=active ব্যবহার করুন।

gcloud beta workspace-add-ons chat-app-config update --state=disabled

কনফিগারেশন ফাইল ব্যবহার করুন

কোনও ফাইলে কনফিগারেশন রাখতে অথবা ফ্ল্যাগ নেই এমন সেটিংস কনফিগার করতে, update কমান্ডে YAML বা JSON ফাইল পাস করুন। ফাইলটি chatAppConfig রিসোর্সের ফিল্ড ব্যবহার করে, যা describe কমান্ড প্রিন্ট করে এমন একই ফিল্ড।

  1. আপডেট করার জন্য সেটিংস সহ একটি ফাইল তৈরি করুন। যেমন, নিম্নলিখিত কন্টেন্ট সহ chat_app_config.yaml নামের একটি ফাইল তৈরি করুন:

    displayName: Cymbal Assistant
    description: Helps manage tasks and schedules
    avatarUri: https://www.gstatic.com/dynamite/images/quickstart-app-avatar.png
    state: ACTIVE
    errorLoggingEnabled: true
    interactiveFeatureConfig:
      supportsMultiuserSpaces: true
      connectionConfig:
        httpEndpointConfig:
          commonUrl: https://example.com/chat
      appCommands:
      - commandId: 1
        commandType: SLASH_COMMAND
        command: /help
        description: Show available commands
      urlPatterns:
      - hostPattern: example.com
        pathPrefix: tasks/
      allowlistedTestingPrincipals:
      - USER_EMAIL
    

    USER_EMAIL-এর জায়গায় আপনার Google Workspace প্রতিষ্ঠানের কোনও ব্যক্তি বা গ্রুপের ইমেল আইডি লিখুন, যারা Chat অ্যাপ ইনস্টল ও পরীক্ষা করতে পারবেন।

  2. --config-file ফ্ল্যাগ সহ update কমান্ড রান করুন:

    gcloud beta workspace-add-ons chat-app-config update \
        --config-file=chat_app_config.yaml

Chat অ্যাপের বর্তমান কনফিগারেশন থেকে শুরু করতে, describe কমান্ডের আউটপুট একটি ফাইলে সেভ করুন:

gcloud beta workspace-add-ons chat-app-config describe > chat_app_config.yaml

তারপর ফাইলটি এডিট করুন, যে ফিল্ডগুলি পরিবর্তন করতে চান না সেগুলি মুছে দিন এবং update কমান্ডে ফাইলটি পাস করুন। ফাইলে এমন কোনও সেটিং থাকলে যা কমান্ড আপডেট করতে পারে না, তাহলে কমান্ড কাজ করে না। আরও জানতে, সীমাবদ্ধতা দেখুন।

update কমান্ডটি ফাইলের name ফিল্ডটি উপেক্ষা করে। এটি সবসময় gcloud CLI-তে আপনার সেট করা ক্লাউড প্রোজেক্ট আপডেট করে, তাই আপনি একই ফাইল ব্যবহার করে অন্য ক্লাউড প্রোজেক্টে Chat অ্যাপ কনফিগার করতে পারবেন।

কমান্ড কীভাবে আপনার পরিবর্তন প্রয়োগ করে

  • আপনি যে সেটিংস নির্দিষ্ট করেন শুধু সেটিই পরিবর্তন হয়। ফ্ল্যাগ সহ, কমান্ড আপনার পাস করা ফ্ল্যাগের সেটিংস পরিবর্তন করে। কনফিগারেশন ফাইলের মাধ্যমে, এটি ফাইলে থাকা ফিল্ড পরিবর্তন করে, তাই ফাইলে সম্পূর্ণ কনফিগারেশন থাকার প্রয়োজন হয় না। কানেকশন সেটিংসের ক্ষেত্রে ব্যতিক্রম আছে: আপনার সেট করা কানেকশনের ধরন বর্তমান ধরনকে প্রতিস্থাপন করে এবং আপনার সেট করা Dialogflow সংস্করণ পুরো Dialogflow কনফিগারেশনকে প্রতিস্থাপন করে।
  • তালিকা সম্পূর্ণভাবে পরিবর্তন করা হয়। ফাইলে appCommands, urlPatterns বা allowlistedTestingPrincipals ফিল্ড থাকলে, ফাইলের তালিকাটি বর্তমান তালিকাকে প্রতিস্থাপন করে। পরিবর্তে, আলাদা আলাদা টেস্টার যোগ করতে বা সরাতে, --add-allowlisted-testing-principals এবং --remove-allowlisted-testing-principals ফ্ল্যাগ ব্যবহার করুন।
  • কোনও ভ্যালু না থাকলে সেটিং মুছে যায়। যেমন, কোনও ফাইলে interactiveFeatureConfig-এর অধীনে urlPatterns: [] থাকলে, সেটি সব লিঙ্ক প্রিভিউ URL প্যাটার্ন সরিয়ে দেয়।
  • কোনও কমান্ড কাজ না করলে, কোনও পরিবর্তন হয় না। কোনও ভ্যালু সঠিক না হলে, কমান্ডটি সমস্যাটি প্রিন্ট করে এবং কনফিগারেশনটি যেমন ছিল তেমনই রেখে দেয়।
  • অনুরোধের ক্ষেত্রে রেটের সীমা প্রযোজ্য। প্রতিটি ক্লাউড প্রোজেক্ট এবং প্রতিটি সংস্থার জন্য, API প্রতি মিনিটে পড়ার অনুরোধ এবং আপডেট করার অনুরোধের সংখ্যা সীমিত করে। প্রতিটি update কমান্ড একটি করে আপডেট করার অনুরোধ পাঠায়। আপনি যদি ফ্ল্যাগ সহ টেস্টার যোগ করেন বা সরিয়ে দেন, তাহলে কমান্ডটি একটি রিড রিকোয়েস্টও পাঠায়। একাধিক সেটিংস পরিবর্তন করতে, প্রতিটি সেটিংসের জন্য একটি করে কমান্ড চালানোর পরিবর্তে একটি কমান্ড বা একটি ফাইলে সেগুলি পাস করুন।

সীমাবদ্ধতা

  • কমান্ডগুলি শুধুমাত্র Google Workspace অ্যাড-অন হিসাবে তৈরি করা Chat অ্যাপগুলিকে সমর্থন করে।
  • কমান্ডে পরিষেবা অ্যাকাউন্ট বা পরিষেবা অ্যাকাউন্টের ছদ্মবেশ কাজ করে না। আপনাকে অবশ্যই ব্যবহারকারীর অ্যাকাউন্ট দিয়ে gcloud CLI-তে সাইন-ইন করতে হবে।
  • একটি ক্লাউড প্রোজেক্টে একটি Chat অ্যাপ কনফিগারেশন থাকে এবং কমান্ড এটি মুছে ফেলতে পারে না। লোকজনকে Chat অ্যাপ ব্যবহার করা থেকে আটকাতে, এর স্ট্যাটাস 'বন্ধ করা আছে' হিসেবে সেট করুন অথবা Cloud প্রোজেক্ট মুছে দিন।
  • লাইভ Chat অ্যাপে একটি আপডেট প্রযোজ্য হয়। কমান্ডের কোনও ড্রাফ্ট বা ড্রাই-রান মোড নেই।
  • Google Workspace Marketplace-এ Chat অ্যাপ প্রকাশিত হলে বা পর্যালোচনাধীন থাকলে, কমান্ডের মাধ্যমে এর ডিসপ্লে নাম, অবতার, বিবরণ, কমান্ড বা লিঙ্ক প্রিভিউ URL প্যাটার্ন পরিবর্তন করা যাবে না।
  • কমান্ডগুলি chatAppConfig রিসোর্স-এর সেটিংসকে সমর্থন করে। রিসোর্সে অন্তর্ভুক্ত নয় এমন কোনও সেটিং কনফিগার করতে, Google Cloud কনসোল ব্যবহার করুন।

সমস্যার সমাধান করুন

কোনও কমান্ড কাজ না করলে, নিম্নলিখিত সারণী থেকে সমস্যার মেসেজের টেক্সট খুঁজে নিন। মেসেজটি যদি INVALID_ARGUMENT-এর মতো কোনও স্ট্যাটাস দিয়ে শুরু হয়, তাহলে Google Workspace অ্যাড-অন API অনুরোধটি বাতিল করে দিয়েছে এবং স্ট্যাটাসের পরে থাকা টেক্সট সমস্যাটি বর্ণনা করে।

ত্রুটি মেসেজে রয়েছে কারণ সমাধান
Invalid choice: 'chat-app-config' অথবা Invalid choice: 'workspace-add-ons' কমান্ডে beta অন্তর্ভুক্ত নেই অথবা আপনার gcloud CLI-এর ভার্সনে কমান্ড অন্তর্ভুক্ত নেই। gcloud beta workspace-add-ons chat-app-config দিয়ে কমান্ড শুরু করুন। সমস্যাটি সমাধান না হলে, gcloud CLI লেটেস্ট ভার্সনে আপডেট করুন।
PROJECT ID প্রোজেক্টটি একটি প্রোজেক্ট নম্বরে সেট করা আছে। প্রোজেক্ট আইডি অনুযায়ী প্রোজেক্ট সেট করুন।
Failed to parse value(s) in protobuf কনফিগারেশন ফাইলে এমন একটি ফিল্ড আছে যা gcloud CLI শনাক্ত করতে পারে না। সমস্যার মেসেজে ফিল্ডের নাম উল্লেখ করা থাকে। describe কমান্ডের আউটপুটের সাথে ফিল্ডের নাম তুলনা করুন। ফিল্ডটি নতুন হলে, gcloud CLI লেটেস্ট ভার্সনে আপডেট করুন।
does not have permission to access projects instance API অনুরোধ প্রত্যাখ্যান করেছে। এই মেসেজের পরে থাকা টেক্সটে কারণ উল্লেখ করা আছে। যেমন:
  • আপনার অ্যাকাউন্টে প্রয়োজনীয় IAM ভূমিকা নেই। টেক্সটে Caller does not have required permission to use project থাকলে, পরিষেবা ব্যবহারকারী কনজিউমার ভূমিকা নেই।
  • Cloud প্রোজেক্টে Google Workspace অ্যাড-অন API চালু করা নেই।
  • আপনি একটি পরিষেবা অ্যাকাউন্ট দিয়ে সাইন-ইন করেছেন।
শুরু করার আগে বিভাগে প্রয়োজনীয়তা চেক করুন।
INVALID_ARGUMENT একটি ভ্যালু সঠিক নয়। যেমন, ডিসপ্লে নাম ৩ থেকে ২৫টি অক্ষরের মধ্যে হতে হবে এবং বিবরণ ১ থেকে ৪০টি অক্ষরের মধ্যে হতে হবে। মেসেজে not found or deleted থাকলে, প্রোজেক্ট আইডি সঠিক নয়। সমস্যার মেসেজে যে ভ্যালু দেখানো হয়েছে সেটি ঠিক করে আবার কমান্ড রান করুন।
FAILED_PRECONDITION Chat অ্যাপ অনুরোধের অনুমতি দেয় না। যেমন, এটি Google Workspace অ্যাড-অন হিসেবে তৈরি করা হয়নি অথবা এটি Google Workspace Marketplace-এ প্রকাশ করা হয়েছে এবং সেটিং পরিবর্তন করা যাবে না। সমস্যার মেসেজে দেওয়া নির্দেশাবলী অনুসরণ করুন। Google Workspace অ্যাড-অন নয় এমন Chat অ্যাপ কনফিগার করতে, Google Cloud কনসোল ব্যবহার করুন অথবা এটি কনভার্ট করুন।
RESOURCE_EXHAUSTED বা 429 API, ক্লাউড প্রোজেক্ট বা আপনার সংস্থার জন্য খুব কম সময়ে অনেক বেশি অনুরোধ পেয়েছে। এক মিনিট অপেক্ষা করে আবার কমান্ড রান করুন।

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

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

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

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

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

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

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)

ব্যবহারের সীমা

chatAppConfig পদ্ধতিতে প্রোজেক্ট প্রতি কোটা আছে। আপনি কোটা পেরিয়ে গেলে, 429: Too many requests HTTP স্ট্যাটাস কোড সহ অনুরোধটি ব্যর্থ হয়। কোটার সীমার জন্য, Google Workspace অ্যাড-অন API ব্যবহারের সীমা দেখুন।

সমস্যার সমাধান করা

chatAppConfig অনুরোধ ব্যর্থ হলে, HTTP স্ট্যাটাস কোড এবং ত্রুটি প্রতিক্রিয়ার message ফিল্ড চেক করুন। নিচের সারণীতে সাধারণ সমস্যা, সেগুলির কারণ এবং কীভাবে সমাধান করবেন তা তালিকাভুক্ত করা হয়েছে।

HTTP স্ট্যাটাস কোড সাধারণ কারণ রেজোলিউশন
400: Bad Request (INVALID_ARGUMENT)
  • updateMask-এ এমন একটি ফিল্ড আছে যা নেই অথবা আপডেট করা যাবে না।
  • কোনও ফিল্ডের ভ্যালু নেই বা ভুল আছে। যেমন, interactiveFeatureConfig-এ connectionConfig অন্তর্ভুক্ত নেই।
ভুল ফিল্ডের জন্য message ফিল্ড চেক করুন এবং অনুরোধটি সংশোধন করুন। কাজ করে এমন ফিল্ড ও ভ্যালুর জন্য, projects.chatAppConfig রেফারেন্স দেখুন।
400: Bad Request (FAILED_PRECONDITION)
  • Chat অ্যাপটি Google Workspace অ্যাড-অন হিসেবে তৈরি করা হয়নি।
  • এই ফিল্ড পরিবর্তন করা যাবে না কারণ Chat অ্যাপটি Google Workspace Marketplace-এ প্রকাশ করা হয়েছে।
  • নতুন ভ্যালু আগে থেকে থাকা Chat অ্যাপ কনফিগারেশনের সাথে মানানসই নয়।
  • Chat অ্যাপকে Google Workspace অ্যাড-অনে কনভার্ট করুন অথবা Google Cloud কনসোলে এটি কনফিগার করুন।
  • প্রকাশিত তালিকা আপডেট করতে message ফিল্ডে দেওয়া নির্দেশাবলী অনুসরণ করুন।
  • সমস্যাযুক্ত সেটিংয়ের জন্য message ফিল্ড চেক করুন, এবং একই অনুরোধে দুটি সেটিংই আপডেট করুন, অথবা প্রথমে আগে থেকে থাকা সেটিং পরিবর্তন করুন।
403: Forbidden (PERMISSION_DENIED)
  • যাচাই করা ব্যবহারকারীর কাছে ক্লাউড প্রোজেক্টে প্রয়োজনীয় IAM অনুমতি নেই।
  • ব্যবহারকারীর অ্যাকাউন্টের পরিবর্তে পরিষেবা অ্যাকাউন্টের মাধ্যমে অনুরোধটি যাচাই করা হয়েছে।
  • ব্যবহারকারীকে পূর্বশর্ত এবং যাচাইকরণ-এ তালিকাভুক্ত অনুমতি দিন।
  • https://www.googleapis.com/auth/cloud-platform স্কোপের মাধ্যমে একজন হিউম্যান ইউজার হিসেবে যাচাই করুন।
404: Not Found (NOT_FOUND) রিসোর্সের নামে ক্লাউড প্রোজেক্টের অস্তিত্ব নেই অথবা যাচাই করা ব্যবহারকারী এটি অ্যাক্সেস করতে পারবেন না। রিসোর্সের নামে সঠিক প্রোজেক্ট নম্বর ব্যবহার করা হয়েছে কিনা তা চেক করুন, ফর্ম্যাট হল projects/PROJECT_NUMBER/chatAppConfig, এবং ব্যবহারকারীর ক্লাউড প্রোজেক্টে অ্যাক্সেস আছে কিনা তা চেক করুন।
429: Too Many Requests (RESOURCE_EXHAUSTED) প্রোজেক্ট প্রতি কোটা পেরিয়ে গেছে। অপেক্ষা করুন এবং পরে আবার অনুরোধ করুন। সীমা সম্পর্কে জানতে, ব্যবহারের সীমা দেখুন।

আগে থেকে থাকা 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 কনসোল-এ, gcloud CLI-এর মাধ্যমে অথবা 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 অ্যাড-অনে পরিবর্তন করুন দেখুন।