Event

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

ব্যবহারকারীর মিথস্ক্রিয়া থেকে ইভেন্টগুলি গ্রহণ করার পাশাপাশি, চ্যাট অ্যাপগুলি স্পেসগুলিতে পরিবর্তনগুলি সম্পর্কে ইভেন্টগুলি গ্রহণ করতে পারে, যেমন যখন কোনও স্পেসে নতুন সদস্য যোগ করা হয়। স্পেস ইভেন্টগুলি সম্পর্কে জানতে, Google Chat থেকে ইভেন্টগুলির সাথে কাজ করুন দেখুন।

দ্রষ্টব্য: এই ইভেন্টটি শুধুমাত্র চ্যাট ইন্টারঅ্যাকশন ইভেন্টের জন্য ব্যবহৃত হয়। আপনার Chat অ্যাপটি Google Workspace অ্যাড-অন হিসেবে তৈরি করা থাকলে, অ্যাড-অন ডকুমেন্টেশনে Chat ইভেন্ট অবজেক্ট দেখুন।

JSON প্রতিনিধিত্ব 
{
  "type": enum (EventType),
  "eventTime": string,
  "token": string,
  "threadKey": string,
  "message": {
    object (Message)
  },
  "user": {
    object (User)
  },
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "action": {
    object (FormAction)
  },
  "configCompleteRedirectUrl": string,
  "isDialogEvent": boolean,
  "dialogEventType": enum (DialogEventType),
  "common": {
    object (CommonEventObject)
  },
  "appCommandMetadata": {
    object (AppCommandMetadata)
  }
}
ক্ষেত্র
type

enum ( EventType )

চ্যাট অ্যাপের সাথে ব্যবহারকারীর ইন্টারঅ্যাকশনের ধরন , যেমন MESSAGE বা ADDED_TO_SPACE ।

eventTime

string ( Timestamp format)

ইন্টারঅ্যাকশন ইভেন্ট কখন ঘটেছে তা নির্দেশ করে টাইমস্ট্যাম্প।

token

string

একটি গোপন মান যা লিগ্যাসি চ্যাট অ্যাপগুলি Google-এর কাছ থেকে অনুরোধ করা হয়েছে কিনা তা যাচাই করতে ব্যবহার করতে পারে। Google এলোমেলোভাবে টোকেন তৈরি করে এবং এর মান স্থির থাকে। আপনি Google ক্লাউড কনসোলে চ্যাট API কনফিগারেশন পৃষ্ঠা থেকে টোকেন পেতে, প্রত্যাহার করতে বা পুনরুত্পাদন করতে পারেন।

আধুনিক চ্যাট অ্যাপ এই ক্ষেত্রটি ব্যবহার করে না। এটি API প্রতিক্রিয়া এবং চ্যাট API কনফিগারেশন পৃষ্ঠা থেকে অনুপস্থিত।

threadKey

string

ইন্টারঅ্যাকশন ইভেন্টের সাথে সম্পর্কিত থ্রেডের জন্য চ্যাট অ্যাপ-সংজ্ঞায়িত কী। আরও তথ্যের জন্য spaces.messages.thread.threadKey দেখুন।

message

object ( Message )

ADDED_TO_SPACE , CARD_CLICKED , এবং MESSAGE ইন্টারঅ্যাকশন ইভেন্টের জন্য, যে বার্তাটি ইন্টারঅ্যাকশন ইভেন্টটিকে ট্রিগার করেছে, যদি প্রযোজ্য হয়।

user

object ( User )

যে ব্যবহারকারী চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করেছেন।

thread

object ( Thread )

যে থ্রেডে ব্যবহারকারী চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করেছেন। এটি একটি নতুন প্রেরিত বার্তা দ্বারা তৈরি একটি নতুন থ্রেডে হতে পারে৷ ইন্টারঅ্যাকশন ইভেন্ট একটি নির্দিষ্ট বার্তা বা থ্রেডের সাথে যুক্ত হলে এই ক্ষেত্রটি পপুলেট করা হয়।

space

object ( Space )

যে স্থানটিতে ব্যবহারকারী চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করেছেন।

action

object ( FormAction )

CARD_CLICKED ইন্টারঅ্যাকশন ইভেন্টগুলির জন্য, ব্যবহারকারী যখন একটি কার্ড বা ডায়ালগ ক্লিক করে তখন ফর্ম অ্যাকশন ডেটা সম্পর্কিত৷ আরও জানতে, কার্ডগুলিতে ব্যবহারকারীদের দ্বারা ফর্ম ডেটা ইনপুট পড়ুন দেখুন।

configCompleteRedirectUrl

string

এই URLটি MESSAGE , ADDED_TO_SPACE , এবং APP_COMMAND ইন্টারঅ্যাকশন ইভেন্টগুলির জন্য তৈরি করা হয়েছে৷ Google Chat-এর বাইরে অনুমোদন বা কনফিগারেশন ফ্লো সম্পূর্ণ করার পরে, ব্যবহারকারীদের এই ইউআরএলে রিডাইরেক্ট করতে হবে যাতে Google Chat-এ সংকেত দেওয়া যায় যে অনুমোদন বা কনফিগারেশন ফ্লো সফল হয়েছে। আরও তথ্যের জন্য, অন্যান্য পরিষেবা এবং সরঞ্জামগুলির সাথে একটি চ্যাট অ্যাপ সংযুক্ত করুন দেখুন৷

isDialogEvent

boolean

CARD_CLICKED এবং MESSAGE ইন্টারঅ্যাকশন ইভেন্টের জন্য, ব্যবহারকারী একটি ডায়ালগের সাথে ইন্টারঅ্যাক্ট করছেন বা করতে চলেছেন কিনা।

dialogEventType

enum ( DialogEventType )

প্রাপ্ত ডায়ালগ ইন্টারঅ্যাকশন ইভেন্টের ধরন।

common

object ( CommonEventObject )

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

appCommandMetadata

object ( AppCommandMetadata )

চ্যাট অ্যাপ কমান্ড সম্পর্কে মেটাডেটা।

CommonEventObject

সাধারণ ইভেন্ট অবজেক্ট হল সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা ব্যবহারকারীর ক্লায়েন্ট থেকে অ্যাড-অনে সাধারণ, হোস্ট-স্বাধীন তথ্য বহন করে। এই তথ্যে ব্যবহারকারীর লোকেল, হোস্ট অ্যাপ এবং প্ল্যাটফর্মের মতো বিশদ বিবরণ অন্তর্ভুক্ত রয়েছে।

হোমপেজ এবং প্রাসঙ্গিক ট্রিগার ছাড়াও, ব্যবহারকারী যখন উইজেটগুলির সাথে ইন্টারঅ্যাক্ট করে তখন অ্যাড-অনগুলি ইভেন্ট অবজেক্টকে অ্যাকশন কলব্যাক ফাংশনে পাঠায়। আপনার অ্যাড-অনের কলব্যাক ফাংশন ব্যবহারকারীর ক্লায়েন্টে খোলা উইজেটের বিষয়বস্তু নির্ধারণ করতে সাধারণ ইভেন্ট অবজেক্টকে জিজ্ঞাসা করতে পারে। উদাহরণস্বরূপ, আপনার অ্যাড-অন ইভেন্টঅবজেক্ট. eventObject.commentEventObject.formInputs অবজেক্টে একটি টেক্সটইনপুট উইজেটে ব্যবহারকারীর প্রবেশ করা টেক্সটটি সনাক্ত করতে পারে।

চ্যাট অ্যাপ্লিকেশানগুলির জন্য, উইজেটের সাথে ইন্টারঅ্যাক্ট করার সময় ব্যবহারকারী যে ফাংশনটি ব্যবহার করেছিলেন তার নাম৷

JSON প্রতিনিধিত্ব 
{
  "userLocale": string,
  "hostApp": enum (HostApp),
  "platform": enum (Platform),
  "timeZone": {
    object (TimeZone)
  },
  "formInputs": {
    string: {
      object (Inputs)
    },
    ...
  },
  "parameters": {
    string: string,
    ...
  },
  "invokedFunction": string
}
ক্ষেত্র
userLocale

string

ডিফল্টরূপে নিষ্ক্রিয়. ISO 639 ভাষার কোড- ISO 3166 দেশ/অঞ্চল কোডের বিন্যাসে ব্যবহারকারীর ভাষা এবং দেশ/অঞ্চল সনাক্তকারী। উদাহরণস্বরূপ, en-US .

এই ক্ষেত্রটি চালু করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে addOns.common.useLocaleFromApp true হিসাবে সেট করতে হবে৷ আপনার অ্যাড-অনের সুযোগ তালিকায় অবশ্যই https://www.googleapis.com/auth/script.locale অন্তর্ভুক্ত থাকতে হবে। আরো বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন।

hostApp

enum ( HostApp )

ইভেন্ট অবজেক্ট তৈরি হওয়ার সময় অ্যাড-অন সক্রিয় থাকা হোস্ট অ্যাপটিকে নির্দেশ করে। সম্ভাব্য মানগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:

  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
  • CHAT
platform

enum ( Platform )

প্ল্যাটফর্ম enum যা প্ল্যাটফর্মটি নির্দেশ করে যেখানে ইভেন্টটি উদ্ভূত হয় ( WEB , IOS , বা ANDROID )৷ চ্যাট অ্যাপ দ্বারা সমর্থিত নয়।

timeZone

object ( TimeZone )

ডিফল্টরূপে নিষ্ক্রিয়. সমন্বিত ইউনিভার্সাল টাইম (UTC) থেকে টাইমজোন আইডি এবং অফসেট। এই ক্ষেত্রটি চালু করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে addOns.common.useLocaleFromApp true হিসাবে সেট করতে হবে৷ আপনার অ্যাড-অনের সুযোগ তালিকায় অবশ্যই https://www.googleapis.com/auth/script.locale অন্তর্ভুক্ত থাকতে হবে। আরো বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন।

শুধুমাত্র ইভেন্ট প্রকারের জন্য সমর্থিত CARD_CLICKED এবং SUBMIT_DIALOG ।

formInputs

map (key: string, value: object ( Inputs ))

প্রদর্শিত কার্ডে উইজেটগুলির বর্তমান মান ধারণকারী একটি মানচিত্র। মানচিত্র কী হল প্রতিটি উইজেটের সাথে বরাদ্দ করা স্ট্রিং আইডি।

মানচিত্র মান বস্তুর গঠন উইজেট ধরনের উপর নির্ভর করে:

দ্রষ্টব্য : নিম্নলিখিত উদাহরণগুলি অ্যাপস স্ক্রিপ্টের V8 রানটাইমের জন্য ফর্ম্যাট করা হয়েছে৷ আপনি যদি Rhino রানটাইম ব্যবহার করেন, তাহলে আপনাকে অবশ্যই মানের পরে [""] যোগ করতে হবে। উদাহরণস্বরূপ, e.commonEventObject.formInputs.employeeName.stringInputs.value[0] এর পরিবর্তে, ইভেন্ট অবজেক্টটিকে e.commonEventObject.formInputs.employeeName[""].stringInputs.value[0] হিসাবে ফর্ম্যাট করুন। Apps স্ক্রিপ্টে রানটাইম সম্পর্কে আরও জানতে, V8 রানটাইম ওভারভিউ দেখুন।

  • একক-মূল্যবান উইজেট (উদাহরণস্বরূপ, একটি পাঠ্য বাক্স): স্ট্রিংগুলির একটি তালিকা (শুধুমাত্র একটি উপাদান)।

উদাহরণ : একটি টেক্সট ইনপুট উইজেটের জন্য, যার ID হিসেবে employeeName আছে, এর সাথে পাঠ্য ইনপুট মান অ্যাক্সেস করুন: e.commonEventObject.formInputs.employeeName.stringInputs.value[0] ।

  • বহু-মূল্যবান উইজেট (উদাহরণস্বরূপ, চেকবক্স গ্রুপ): স্ট্রিংগুলির একটি তালিকা।

উদাহরণ : participants আইডি হিসাবে একটি বহু-মূল্যের উইজেটের জন্য, এর সাথে মান অ্যারে অ্যাক্সেস করুন: e.commonEventObject.formInputs.participants.stringInputs.value ।

উদাহরণ : myDTPicker এর আইডি সহ পিকারের জন্য, e.commonEventObject.formInputs.myDTPicker.dateTimeInput ব্যবহার করে DateTimeInput অবজেক্ট অ্যাক্সেস করুন।

  • শুধুমাত্র তারিখ বাছাইকারী : একটি DateInput object ।

উদাহরণ : myDatePicker এর আইডি সহ পিকারের জন্য, e.commonEventObject.formInputs.myDatePicker.dateInput ব্যবহার করে DateInput অবজেক্ট অ্যাক্সেস করুন।

  • একটি টাইম-ওনলি পিকার : একটি TimeInput object ।

উদাহরণ : myTimePicker এর আইডি সহ পিকারের জন্য, e.commonEventObject.formInputs.myTimePicker.timeInput ব্যবহার করে TimeInput অবজেক্ট অ্যাক্সেস করুন।

parameters

map (key: string, value: string)

actionParameters বা Action.setParameters() ব্যবহার করে কোনও অ্যাকশনে আপনি যে কোনও অতিরিক্ত প্যারামিটার সরবরাহ করেন।

ডেভেলপার প্রিভিউ: অ্যাড-অনগুলির জন্য যা Google চ্যাটকে প্রসারিত করে , ব্যবহারকারীরা মাল্টিসিলেক্ট মেনুতে যা টাইপ করে তার উপর ভিত্তি করে আইটেমগুলি সাজেস্ট করতে, "autocomplete_widget_query" কী ( event.commonEventObject.parameters["autocomplete_widget_query"] ) এর মান ব্যবহার করুন। আপনি একটি ডাটাবেস অনুসন্ধান করতে এই মানটি ব্যবহার করতে পারেন এবং ব্যবহারকারীদের টাইপ করার সাথে সাথে নির্বাচনযোগ্য আইটেমগুলির পরামর্শ দিতে পারেন। বিশদ বিবরণের জন্য, Google চ্যাট ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ এবং প্রক্রিয়া করুন দেখুন।

invokedFunction

string

আহ্বান করার ফাংশনের নাম।

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

টাইমজোন

সমন্বিত ইউনিভার্সাল টাইম (UTC) থেকে টাইমজোন আইডি এবং অফসেট। শুধুমাত্র ইভেন্ট প্রকারের জন্য সমর্থিত CARD_CLICKED এবং SUBMIT_DIALOG ।

JSON প্রতিনিধিত্ব 
{
  "id": string,
  "offset": integer
}
ক্ষেত্র
id

string

IANA TZ টাইম জোন ডাটাবেস কোড, যেমন "আমেরিকা/টরন্টো"।

offset

integer

সমন্বিত ইউনিভার্সাল টাইম (UTC) থেকে মিলিসেকেন্ডে ব্যবহারকারীর টাইমজোন অফসেট।

ইনপুট

ডেটার প্রকারগুলি যা ব্যবহারকারীরা কার্ড বা ডায়ালগে ইনপুট করতে পারে৷ ইনপুট টাইপ নির্ভর করে উইজেট যে ধরনের মান গ্রহণ করে তার উপর।

JSON প্রতিনিধিত্ব 
{

  // Union field inputs can be only one of the following:
  "stringInputs": {
    object (StringInputs)
  },
  "dateTimeInput": {
    object (DateTimeInput)
  },
  "dateInput": {
    object (DateInput)
  },
  "timeInput": {
    object (TimeInput)
  }
  // End of list of possible types for union field inputs.
}
ক্ষেত্র

ইউনিয়ন ফিল্ড inputs ।

inputs নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

stringInputs

object ( StringInputs )

স্ট্রিংগুলির একটি তালিকা যা ব্যবহারকারী একটি উইজেটে ইনপুট করে এমন মানগুলিকে প্রতিনিধিত্ব করে৷

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

dateTimeInput

object ( DateTimeInput )

একটি DateTimePicker উইজেট থেকে তারিখ এবং সময় ইনপুট মান যা একটি তারিখ এবং সময় উভয়ই গ্রহণ করে।

dateInput

object ( DateInput )

একটি DateTimePicker উইজেট থেকে তারিখ ইনপুট মান যা শুধুমাত্র তারিখ মান গ্রহণ করে।

timeInput

object ( TimeInput )

একটি DateTimePicker উইজেট থেকে সময় ইনপুট মান যা শুধুমাত্র সময়ের মান গ্রহণ করে।

স্ট্রিংইনপুট

নিয়মিত উইজেটগুলির জন্য ইনপুট পরামিতি। একক-মূল্যবান উইজেটের জন্য, এটি একটি একক মান তালিকা। বহু-মূল্যবান উইজেটের জন্য, যেমন চেকবক্স, সমস্ত মান উপস্থাপন করা হয়।

JSON প্রতিনিধিত্ব 
{
  "value": [
    string
  ]
}
ক্ষেত্র
value[]

string

ব্যবহারকারীর দ্বারা প্রবেশ করা স্ট্রিংগুলির একটি তালিকা৷

DateTimeInput

তারিখ এবং সময় ইনপুট মান.

JSON প্রতিনিধিত্ব 
{
  "msSinceEpoch": string,
  "hasDate": boolean,
  "hasTime": boolean
}
ক্ষেত্র
msSinceEpoch

string ( int64 format)

যুগের সময় থেকে সময়, মিলিসেকেন্ডে।

hasDate

boolean

datetime ইনপুট একটি ক্যালেন্ডার তারিখ অন্তর্ভুক্ত কিনা।

hasTime

boolean

datetime ইনপুট একটি টাইমস্ট্যাম্প অন্তর্ভুক্ত কিনা।

তারিখ ইনপুট

তারিখ ইনপুট মান.

JSON প্রতিনিধিত্ব 
{
  "msSinceEpoch": string
}
ক্ষেত্র
msSinceEpoch

string ( int64 format)

যুগের সময় থেকে সময়, মিলিসেকেন্ডে।

টাইমইনপুট

সময় ইনপুট মান.

JSON প্রতিনিধিত্ব 
{
  "hours": integer,
  "minutes": integer
}
ক্ষেত্র
hours

integer

২৪ ঘণ্টার ঘড়িতে ঘণ্টা।

minutes

integer

ঘণ্টা পেরিয়ে মিনিটের সংখ্যা। বৈধ মান 0 থেকে 59।

AppCommandMetadata

একটি চ্যাট অ্যাপ কমান্ড সম্পর্কে মেটাডেটা।

JSON প্রতিনিধিত্ব 
{
  "appCommandId": integer,
  "appCommandType": enum (AppCommandType)
}
ক্ষেত্র
appCommandId

integer

চ্যাট এপিআই কনফিগারেশনে নির্দিষ্ট কমান্ডের জন্য আইডি।

appCommandType

enum ( AppCommandType )

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