Event

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

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

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

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

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

আধুনিক চ্যাট অ্যাপগুলো এই ফিল্ডটি ব্যবহার করে না। এটি এপিআই রেসপন্স এবং চ্যাট এপিআই কনফিগারেশন পেজে অনুপস্থিত।

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-এর বাইরে কোনো অনুমোদন বা কনফিগারেশন প্রক্রিয়া সম্পন্ন করার পর, ব্যবহারকারীদের অবশ্যই এই URL-এ রিডাইরেক্ট করতে হবে, যাতে Google Chat বুঝতে পারে যে অনুমোদন বা কনফিগারেশন প্রক্রিয়াটি সফল হয়েছে। আরও তথ্যের জন্য, “অন্যান্য পরিষেবা এবং টুলের সাথে একটি চ্যাট অ্যাপ সংযুক্ত করুন” দেখুন।

isDialogEvent

boolean

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

dialogEventType

enum ( DialogEventType )

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

common

object ( CommonEventObject )

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

appCommandMetadata

object ( AppCommandMetadata )

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

কমনইভেন্টঅবজেক্ট

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

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

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

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 )

প্ল্যাটফর্ম এনাম যা নির্দেশ করে ইভেন্টটি কোন প্ল্যাটফর্ম থেকে উদ্ভূত হয়েছে ( 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 রানটাইমের জন্য ফরম্যাট করা হয়েছে। আপনি যদি রাইনো রানটাইম ব্যবহার করেন, তাহলে আপনাকে অবশ্যই মানের পরে [""] যোগ করতে হবে। উদাহরণস্বরূপ, e.commonEventObject.formInputs.employeeName.stringInputs.value[0] এর পরিবর্তে, ইভেন্ট অবজেক্টটিকে e.commonEventObject.formInputs.employeeName[""].stringInputs.value[0] হিসাবে ফরম্যাট করুন। অ্যাপস স্ক্রিপ্টে রানটাইম সম্পর্কে আরও জানতে, V8 রানটাইম ওভারভিউ দেখুন।

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

উদাহরণ : 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() ব্যবহার করে আপনি কোনো অ্যাকশনে যে কোনো অতিরিক্ত প্যারামিটার সরবরাহ করেন।

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

invokedFunction

string

যে ফাংশনটি কল করতে হবে তার নাম।

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

টাইমজোন

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

JSON উপস্থাপনা 
{
  "id": string,
  "offset": integer
}
ক্ষেত্র
id

string

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

offset

integer

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

ইনপুট

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

JSON উপস্থাপনা 
{

  "stringInputs": {
    object (StringInputs)
  },
  "dateTimeInput": {
    object (DateTimeInput)
  },
  "dateInput": {
    object (DateInput)
  },
  "timeInput": {
    object (TimeInput)
  }
}
ক্ষেত্র
নিম্নলিখিতটি হলো পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলির একটি তালিকা। একটি উত্তরে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
stringInputs

object ( StringInputs )

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

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

dateTimeInput

object ( DateTimeInput )

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

dateInput

object ( DateInput )

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

timeInput

object ( TimeInput )

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

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

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

সাধারণ উইজেটগুলোর জন্য ইনপুট প্যারামিটার। একক-মান বিশিষ্ট উইজেটগুলোর ক্ষেত্রে, এটি একটি একক মানের তালিকা। চেকবক্সের মতো বহু-মান বিশিষ্ট উইজেটগুলোর ক্ষেত্রে, সমস্ত মান প্রদর্শিত হয়।

JSON উপস্থাপনা 
{
  "value": [
    string
  ]
}
ক্ষেত্র
value[]

string

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

তারিখসময়ইনপুট

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

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

ঘণ্টার পর মিনিটের সংখ্যা। বৈধ মান হলো ০ থেকে ৫৯।

অ্যাপকমান্ডমেটাডেটা

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

JSON উপস্থাপনা 
{
  "appCommandId": integer,
  "appCommandType": enum (AppCommandType)
}
ক্ষেত্র
appCommandId

integer

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

appCommandType

enum ( AppCommandType )

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