REST Resource: projects.chatAppConfig

রিসোর্স: ChatAppConfig

Google Workspace অ্যাড-অন হিসেবে তৈরি করা Google Chat অ্যাপের কনফিগারেশন দেখায়।

JSON উপস্থাপনা 
{
  "name": string,
  "displayName": string,
  "description": string,
  "interactiveFeatureConfig": {
    object (InteractiveFeatureConfig)
  },
  "avatarUri": string,
  "state": enum (AppState),
  "errorLoggingEnabled": boolean,
  "markupSyntax": enum (MarkupSyntax)
}
ফিল্ড
name

string

প্রয়োজনীয়। শনাক্তকারী। Chat অ্যাপ কনফিগারেশনের রিসোর্স নাম।

ফর্ম্যাট: projects/{project}/chatAppConfig, যেখানে {project} হল Google Cloud প্রোজেক্ট নম্বর।
displayName

string

প্রয়োজনীয়। Chat অ্যাপের ডিসপ্লে নাম। দৈর্ঘ্য ৩ থেকে ২৫টি অক্ষরের মধ্যে হতে হবে।
description

string

প্রয়োজনীয়। Chat অ্যাপের সংক্ষিপ্ত বিবরণ। ১ থেকে ৪০টি অক্ষরের মধ্যে হতে হবে।
interactiveFeatureConfig

object (InteractiveFeatureConfig)

ঐচ্ছিক। অ্যাপের ইন্টার‍্যাক্টিভ ফিচারের সেটিংস। এটি প্রদান করা না হলে, অ্যাপটি নন-ইন্টার‍্যাক্টিভ হবে, অর্থাৎ এটি Chat API ব্যবহার করতে পারবে, কিন্তু ব্যবহারকারীরা অ্যাপের সাথে ইন্টার‍্যাক্ট করতে পারবেন না।
avatarUri

string

ঐচ্ছিক। অ্যাপের অবতার ছবির URL। এটি অবশ্যই একটি HTTPS URL হতে হবে যা একটি বর্গাকার (১:১ অ্যাসপেক্ট রেশিও) PNG ছবি হোস্ট করে। সাজেস্ট করা ন্যূনতম সাইজ: ২৫৬ x ২৫৬ পিক্সেল। নির্দিষ্ট করা না থাকলে, ডিফল্ট অ্যাপ অবতার ব্যবহার করা হবে।
state

enum (AppState)

ঐচ্ছিক। অ্যাপের স্ট্যাটাস। উল্লেখ করা না থাকলে ডিফল্ট হিসেবে ACTIVE।
errorLoggingEnabled

boolean

ঐচ্ছিক। Cloud Logging-এ সমস্যা লগ করা হবে কিনা। উল্লেখ করা না থাকলে false হল ডিফল্ট।
markupSyntax

enum (MarkupSyntax)

ঐচ্ছিক। এই Chat অ্যাপের মাধ্যমে পাঠানো বা পড়া মেসেজের জন্য ডিফল্ট মার্কআপ সিনট্যাক্স। নির্দিষ্ট করা না থাকলে ডিফল্ট হিসেবে MARKUP_SYNTAX_MARKDOWN।

AppState

Chat অ্যাপের বর্তমান স্ট্যাটাস।

Enums
APP_STATE_UNSPECIFIED ডিফল্ট ভ্যালু। অনির্দিষ্ট।
ACTIVE Chat API কনফিগারেশন পৃষ্ঠায় LIVE-এ ম্যাপ করে। অ্যাপটি অ্যাক্টিভ আছে, এটি খুঁজে পাওয়া যাবে এবং যাদের কাছে দৃশ্যমান তারা ব্যবহার করতে পারবেন।
DISABLED অ্যাপটি বন্ধ করা হয়েছে, এটি আর কেউ খুঁজে পাবেন না এবং কেউ আর অ্যাপের সাথে কথা বলতে পারবেন না।

InteractiveFeatureConfig

অ্যাপের ইন্টার‍্যাক্টিভ ফিচার-এর জন্য সেটিংস।

JSON উপস্থাপনা 
{
  "connectionConfig": {
    object (ConnectionConfig)
  },
  "appCommands": [
    {
      object (AppCommand)
    }
  ],
  "urlPatterns": [
    {
      object (UrlPattern)
    }
  ],
  "allowlistedTestingPrincipals": [
    string
  ],
  "supportsMultiuserSpaces": boolean
}
ফিল্ড
connectionConfig

object (ConnectionConfig)

প্রয়োজনীয়। অ্যাপটি কীভাবে Google Chat থেকে ইভেন্ট পায়।
appCommands[]

object (AppCommand)

ঐচ্ছিক। অ্যাপ কমান্ডের জন্য কনফিগারেশন।
urlPatterns[]

object (UrlPattern)

ঐচ্ছিক। লিঙ্ক প্রিভিউয়ের জন্য কনফিগারেশন।
allowlistedTestingPrincipals[]

string

ঐচ্ছিক। আপনার Google Workspace ডোমেনে থাকা ব্যবহারকারী ও গ্রুপের ইমেল আইডি যারা অ্যাপটি খুঁজে পেতে ও ব্যবহার করতে পারবেন।
supportsMultiuserSpaces

boolean

ঐচ্ছিক। অ্যাপটি ১:১ হিউম্যান DM, গ্রুপ চ্যাট এবং স্পেসে যোগ করা যাবে কিনা। উল্লেখ করা না থাকলে false হল ডিফল্ট।

ConnectionConfig

অ্যাপ কীভাবে ইভেন্ট রিসিভ করে।

JSON উপস্থাপনা 
{

  "httpEndpointConfig": {
    object (HttpEndpointConfig)
  },
  "appsScriptEndpointConfig": {
    object (AppsScriptEndpointConfig)
  },
  "cloudPubSubEndpointConfig": {
    object (CloudPubSubEndpointConfig)
  },
  "dialogflowEndpointConfig": {
    object (DialogflowEndpointConfig)
  }
}
ফিল্ড
কানেকশনের ধরন। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
httpEndpointConfig

object (HttpEndpointConfig)

HTTP এন্ডপয়েন্ট কনফিগারেশন।
appsScriptEndpointConfig

object (AppsScriptEndpointConfig)

Apps স্ক্রিপ্ট ডিপ্লয়মেন্ট কনফিগারেশন।
cloudPubSubEndpointConfig

object (CloudPubSubEndpointConfig)

Pub/Sub টপিক কনফিগারেশন।
dialogflowEndpointConfig

object (DialogflowEndpointConfig)

Dialogflow কনফিগারেশন।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

HttpEndpointConfig

HTTP এন্ডপয়েন্ট কনফিগারেশন।

JSON উপস্থাপনা 
{

  "commonUrl": string,
  "perEventEndpointConfig": {
    object (HttpPerEventEndpointConfig)
  }
}
ফিল্ড
HTTP এন্ডপয়েন্ট URL কনফিগারেশন। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
commonUrl

string

ঐচ্ছিক। Google Chat যে HTTPS URL-এ সব ইন্টার‍্যাক্টিভ ইভেন্ট পাঠায়।
perEventEndpointConfig

object (HttpPerEventEndpointConfig)

ঐচ্ছিক। আলাদা HTTPS URL যেখানে Google Chat প্রতিটি ধরনের ইন্টার‍্যাক্টিভ ইভেন্ট পাঠায়।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

HttpPerEventEndpointConfig

নির্দিষ্ট ইভেন্টের ধরনের জন্য HTTP এন্ডপয়েন্ট কনফিগারেশন।

JSON উপস্থাপনা 
{
  "appCommandEndpoint": string,
  "addedToSpaceEndpoint": string,
  "messageEndpoint": string,
  "removedFromSpaceEndpoint": string
}
ফিল্ড
appCommandEndpoint

string

প্রয়োজনীয়। অ্যাপ কমান্ড ইভেন্টের জন্য HTTPS URL এন্ডপয়েন্ট।
addedToSpaceEndpoint

string

প্রয়োজনীয়। স্পেস ইভেন্টে যোগ করার জন্য HTTPS URL এন্ডপয়েন্ট।
messageEndpoint

string

প্রয়োজনীয়। মেসেজ ইভেন্টের জন্য HTTPS URL এন্ডপয়েন্ট।
removedFromSpaceEndpoint

string

প্রয়োজনীয়। স্পেস ইভেন্ট থেকে সরিয়ে দেওয়ার জন্য HTTPS URL এন্ডপয়েন্ট।

AppsScriptEndpointConfig

Apps স্ক্রিপ্ট এন্ডপয়েন্ট কনফিগারেশন।

JSON উপস্থাপনা 
{
  "deploymentId": string,
  "perEventEndpointConfig": {
    object (AppsScriptPerEventEndpointConfig)
  }
}
ফিল্ড
deploymentId

string

প্রয়োজনীয়। Apps Script ডিপ্লয়মেন্ট আইডি।
perEventEndpointConfig

object (AppsScriptPerEventEndpointConfig)

ঐচ্ছিক। প্রতিটি ধরনের ইন্টার‍্যাক্টিভ ইভেন্টের জন্য Google Chat যে Apps Script ফাংশন কল করে তার নাম। উল্লেখ করা না থাকলে, Chat প্রতিটি ইভেন্টের ধরনের জন্য ডিফল্ট ফাংশন কল করে।

AppsScriptPerEventEndpointConfig

নির্দিষ্ট ইভেন্টের ধরনের জন্য Apps Script এন্ডপয়েন্ট কনফিগারেশন।

JSON উপস্থাপনা 
{
  "appCommandEndpoint": string,
  "addedToSpaceEndpoint": string,
  "messageEndpoint": string,
  "removedFromSpaceEndpoint": string
}
ফিল্ড
appCommandEndpoint

string

ঐচ্ছিক। অ্যাপ কমান্ড ইভেন্টের জন্য ফাংশনের নাম। নির্দিষ্ট করা না থাকলে, ডিফল্ট onAppCommand ফাংশনের নাম ব্যবহার করা হবে।
addedToSpaceEndpoint

string

ঐচ্ছিক। স্পেস ইভেন্টে যোগ করার জন্য ফাংশনের নাম। নির্দিষ্ট করা না থাকলে, ডিফল্ট onAddedToSpace ফাংশনের নাম ব্যবহার করা হবে।
messageEndpoint

string

ঐচ্ছিক। মেসেজ ইভেন্টের জন্য ফাংশনের নাম। নির্দিষ্ট করা না থাকলে, ডিফল্ট onMessage ফাংশনের নাম ব্যবহার করা হবে।
removedFromSpaceEndpoint

string

ঐচ্ছিক। স্পেস ইভেন্ট থেকে সরিয়ে দেওয়ার জন্য ফাংশনের নাম। নির্দিষ্ট করা না থাকলে, ডিফল্ট onRemovedFromSpace ফাংশনের নাম ব্যবহার করা হবে।

CloudPubSubEndpointConfig

Pub/Sub এন্ডপয়েন্ট কনফিগারেশন।

JSON উপস্থাপনা 
{
  "topic": string
}
ফিল্ড
topic

string

প্রয়োজনীয়। Pub/Sub বিষয় যেখানে Google Chat সব ইন্টার‍্যাক্টিভ ইভেন্ট প্রকাশ করে। বিষয়টি অবশ্যই অ্যাপের মতো একই Google Cloud প্রোজেক্টে থাকতে হবে এবং Chat-এর কাছে বিষয়ে মেসেজ প্রকাশ করার অনুমতি থাকতে হবে। বিস্তারিত জানতে, Pub/Sub-এর সাহায্যে Google Chat অ্যাপ তৈরি করুন।

ফর্ম্যাট: projects/{project}/topics/{topic}

DialogflowEndpointConfig

Dialogflow এন্ডপয়েন্ট কনফিগারেশন।

JSON উপস্থাপনা 
{
  "dialogflowEdition": enum (DialogflowEdition),
  "agent": string
}
ফিল্ড
dialogflowEdition

enum (DialogflowEdition)

প্রয়োজনীয়। Dialogflow সংস্করণ।
agent

string

ঐচ্ছিক। Dialogflow CX এজেন্ট বা এনভায়রনমেন্টের নাম। Dialogflow CX-এর জন্য প্রয়োজনীয়। Dialogflow ES-এর জন্য সেট করবেন না।

ফর্ম্যাট: projects/{project}/locations/{location}/agents/{agent} বা projects/{project}/locations/{location}/agents/{agent}/environments/{environment}।

DialogflowEdition

Dialogflow এডিশনের ধরন।

Enums
DIALOGFLOW_EDITION_UNSPECIFIED ডিফল্ট ভ্যালু। অনির্দিষ্ট।
ES Dialogflow ES সংস্করণ। এই সংস্করণ ব্যবহার করতে, অ্যাপের মতো একই Google Cloud প্রোজেক্টে একটি Dialogflow ES এজেন্ট থাকতে হবে। Google Chat সেই এজেন্টের কাছে সব ইন্টার‍্যাক্টিভ ইভেন্ট পাঠায়।
CX Dialogflow CX সংস্করণ। এই সংস্করণ ব্যবহার করতে, অ্যাপের মতো একই Google Cloud প্রোজেক্টে একটি Dialogflow CX এজেন্ট থাকতে হবে এবং agent ফিল্ডে নির্দিষ্ট করতে হবে। Google Chat সেই এজেন্টের কাছে সব ইন্ট্যার‍্যাক্টিভ ইভেন্ট পাঠায়।

AppCommand

অ্যাপ কমান্ড-এর জন্য কনফিগারেশন।

JSON উপস্থাপনা 
{
  "commandType": enum (CommandType),
  "commandId": integer,
  "command": string,
  "displayName": string,
  "description": string,
  "dialogEnabled": boolean,
  "loadingNotificationMessage": string
}
ফিল্ড
commandType

enum (CommandType)

প্রয়োজনীয়। এই কমান্ডের ধরন।
commandId

integer

প্রয়োজনীয়। কমান্ডের আইডি (১-১০০০)। অ্যাপের মধ্যে অনন্য হতে হবে।
command

string

ঐচ্ছিক। কমান্ডের নাম। SLASH_COMMAND-এর জন্য প্রয়োজন, অন্য কমান্ডের ধরনের জন্য সেট করবেন না। "/" দিয়ে শুরু হতে হবে, যেমন, "/command"।
displayName

string

ঐচ্ছিক। কমান্ডের ব্যবহার করা সহজ এমন ডিসপ্লে নাম। MESSAGE_ACTION এবং QUICK_COMMAND-এর জন্য প্রয়োজন, SLASH_COMMAND-এর জন্য সেট করবেন না।
description

string

প্রয়োজনীয়। কমান্ডের সংক্ষিপ্ত বিবরণ।
dialogEnabled

boolean

ঐচ্ছিক। এই কমান্ড কোনও ডায়ালগ ট্রিগার করবে কিনা। উল্লেখ করা না থাকলে, ডিফল্ট হিসেবে false সেট করা হয়।
loadingNotificationMessage

string

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

CommandType

অ্যাপ কমান্ডের ধরন।

Enums
COMMAND_TYPE_UNSPECIFIED ডিফল্ট ভ্যালু। অনির্দিষ্ট।
SLASH_COMMAND '/' টাইপ করে তারপরে কমান্ডের নাম লিখে কমান্ড চালু করা হয়। এটি মেসেজ টেক্সটে অতিরিক্ত আর্গুমেন্ট গ্রহণ করতে পারে।
QUICK_COMMAND মেসেজ কম্পোজ করার কন্টেক্সট মেনু থেকে একটি কুইক কমান্ড চালু করা হয়েছে। কুইক কমান্ডে অতিরিক্ত আর্গুমেন্ট গ্রহণ করা হয় না।
MESSAGE_ACTION মেসেজের প্রাসঙ্গিক মেনু থেকে একটি কমান্ড চালু করা হয়েছে।

UrlPattern

লিঙ্ক প্রিভিউ-এর জন্য কনফিগারেশন।

JSON উপস্থাপনা 
{
  "hostPattern": string,
  "pathPrefix": string
}
ফিল্ড
hostPattern

string

প্রয়োজনীয়। যে ডোমেনটি ম্যাচ করতে হবে। "subdomain.example.com"-এর মতো নির্দিষ্ট সাবডোমেন বা সম্পূর্ণ ডোমেন ম্যাচ করতে, লিডিং ওয়াইল্ডকার্ড অক্ষর হিসেবে অ্যাস্টেরিস্ক (*) যোগ করুন। যেমন, "*.example.com" ডোমেন "https://subdomain.example.com" এবং "https://any.number.of.subdomains.example.com" ডোমেনের সাথে ম্যাচ করে।
pathPrefix

string

ঐচ্ছিক। হোস্ট প্যাটার্নে যোগ করা পাথের প্রিফিক্স। ফাঁকা থাকলে, হোস্ট প্যাটার্নে সব URL-এর সাথে মিল আছে। যেমন, হোস্ট প্যাটার্ন "subdomain.example.com"-এর সাথে পেয়ার করা হলে, "https://subdomain.example.com/path/" দিয়ে শুরু হওয়া পৃষ্ঠার URL-এর সাথে ম্যাচ করতে "path/" উল্লেখ করুন।

MarkupSyntax

এই Chat অ্যাপের জন্য মেসেজের টেক্সট ফর্ম্যাট করতে ব্যবহৃত মার্কআপ সিনট্যাক্স।

Enums
MARKUP_SYNTAX_UNSPECIFIED ডিফল্ট ভ্যালু। অনির্দিষ্ট। markup_syntax চালু করার আগে তৈরি করা Chat অ্যাপে এই ভ্যালু থাকে এবং স্পষ্টভাবে আপডেট না করা পর্যন্ত MARKUP_SYNTAX_CHAT ব্যবহার করে।
MARKUP_SYNTAX_CHAT Google Chat-এর মার্কআপ সিনট্যাক্স ব্যবহার করে। আরও তথ্যের জন্য https://developers.google.com/workspace/chat/format-messages#format-texts দেখুন।
MARKUP_SYNTAX_MARKDOWN মার্কডাউন সিনট্যাক্স ব্যবহার করে। এই সিনট্যাক্স CommonMark স্পেসিফিকেশনের উপর ভিত্তি করে তৈরি, এতে অতিরিক্ত এক্সটেনশন রয়েছে। আরও তথ্যের জন্য https://developers.google.com/workspace/chat/format-messages#format-texts দেখুন।

পদ্ধতি

get

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

patch

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