Cards v1

কার্ড

কার্ড হলো একটি UI উপাদান যা টেক্সট এবং ছবির মতো UI উইজেট ধারণ করতে পারে।

JSON উপস্থাপনা 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
ক্ষেত্র
header

object ( CardHeader )

কার্ডের হেডার। হেডারে সাধারণত একটি শিরোনাম এবং একটি ছবি থাকে।

sections[]

object ( Section )

বিভাগগুলো একটি রেখা বিভাজক দ্বারা বিভক্ত।

cardActions[]

object ( CardAction )

এই কার্ডের কার্যকলাপ।

name

string

কার্ডটির নাম।

কার্ডহেডার

JSON উপস্থাপনা 
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
ক্ষেত্র
title

string

শিরোনাম অবশ্যই উল্লেখ করতে হবে। হেডারের একটি নির্দিষ্ট উচ্চতা রয়েছে: যদি শিরোনাম এবং উপ-শিরোনাম উভয়ই উল্লেখ করা হয়, তবে প্রতিটি এক লাইনে স্থান পাবে। যদি শুধু শিরোনাম উল্লেখ করা হয়, তবে সেটি উভয় লাইনেই স্থান পাবে।

subtitle

string

কার্ড হেডারের উপশিরোনাম।

imageStyle

enum ( ImageStyle )

ছবির ধরণ (যেমন, বর্গাকার বর্ডার বা বৃত্তাকার বর্ডার)।

imageUrl

string

কার্ড হেডারে থাকা ছবিটির ইউআরএল।

ইমেজস্টাইল

এনাম
IMAGE_STYLE_UNSPECIFIED
IMAGE বর্গাকার বর্ডার।
AVATAR বৃত্তাকার সীমানা।

বিভাগ

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

JSON উপস্থাপনা 
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
ক্ষেত্র
header

string

বিভাগের শিরোনাম। ফরম্যাট করা টেক্সট সমর্থিত। টেক্সট ফরম্যাট করার বিষয়ে আরও তথ্যের জন্য, Google Chat অ্যাপে টেক্সট ফরম্যাট করা এবং Google Workspace অ্যাড-অন-এ টেক্সট ফরম্যাট করা দেখুন।

widgets[]

object ( WidgetMarkup )

একটি বিভাগে অবশ্যই অন্তত একটি উইজেট থাকতে হবে।

উইজেটমার্কআপ

উইজেট হলো একটি UI উপাদান যা টেক্সট এবং ছবি প্রদর্শন করে।

JSON উপস্থাপনা 
{
  "buttons": [
    {
      object (Button)
    }
  ],

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
}
ক্ষেত্র
buttons[]

object ( Button )

বাটনগুলির একটি তালিকা। বাটনগুলিও oneof data এবং এই ফিল্ডগুলির মধ্যে কেবল একটিই সেট করা উচিত।

একটি WidgetMarkup নিম্নলিখিত আইটেমগুলির মধ্যে কেবল একটিই থাকতে পারে। আরও আইটেম প্রদর্শন করার জন্য আপনি একাধিক WidgetMarkup ফিল্ড ব্যবহার করতে পারেন। নিম্নলিখিতটি হলো পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলির একটি তালিকা। একটি রেসপন্সে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
textParagraph

object ( TextParagraph )

এই উইজেটে একটি পাঠ্য অনুচ্ছেদ প্রদর্শন করুন।

image

object ( Image )

এই উইজেটে একটি ছবি প্রদর্শন করুন।

keyValue

object ( KeyValue )

এই উইজেটে একটি কী-ভ্যালু আইটেম প্রদর্শন করুন।

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

পাঠ্য অনুচ্ছেদ

একটি অনুচ্ছেদ। ফরম্যাট করা টেক্সট সমর্থিত। টেক্সট ফরম্যাট করার বিষয়ে আরও তথ্যের জন্য, Google Chat অ্যাপে টেক্সট ফরম্যাট করা এবং Google Workspace অ্যাড-অন-এ টেক্সট ফরম্যাট করা দেখুন।

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

string

ছবি

একটি ছবি যা একটি URL দ্বারা নির্দিষ্ট করা থাকে এবং যাতে একটি onclick অ্যাকশন থাকতে পারে।

JSON উপস্থাপনা 
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}
ক্ষেত্র
imageUrl

string

ছবিটির ইউআরএল।

onClick

object ( OnClick )

onclick অ্যাকশন।

aspectRatio

number

এই ছবিটির অ্যাস্পেক্ট রেশিও (প্রস্থ এবং উচ্চতা)। ছবিটি লোড হওয়ার অপেক্ষায় থাকাকালীন, এই ফিল্ডটি আপনাকে ছবিটির জন্য সঠিক উচ্চতা সংরক্ষণ করতে দেয়। এটি ছবিটির বিল্ট-ইন অ্যাস্পেক্ট রেশিওকে ওভাররাইড করার জন্য নয়। যদি এটি সেট করা না থাকে, তাহলে সার্ভার ছবিটি প্রিফেচ করে এটি পূরণ করে নেয়।

অনক্লিক

একটি onclick অ্যাকশন (উদাহরণস্বরূপ, একটি লিঙ্ক খোলা)।

JSON উপস্থাপনা 
{

  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
}
ক্ষেত্র
নিম্নলিখিতটি হলো পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলির একটি তালিকা। একটি উত্তরে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
action

object ( FormAction )

নির্দিষ্ট করা থাকলে, এই onclick অ্যাকশনের মাধ্যমে একটি ফর্ম অ্যাকশন ট্রিগার হয়।

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

ফর্মঅ্যাকশন

ফর্ম অ্যাকশন বলতে বোঝায় ফর্ম সাবমিট করার পরের আচরণ। উদাহরণস্বরূপ, ফর্মটি পরিচালনা করার জন্য আপনি অ্যাপস স্ক্রিপ্ট কল করতে পারেন।

JSON উপস্থাপনা 
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
ক্ষেত্র
actionMethodName

string

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

parameters[]

object ( ActionParameter )

কর্ম পরামিতিগুলির তালিকা।

অ্যাকশনপ্যারামিটার

অ্যাকশন মেথড কল করার সময় সরবরাহ করার জন্য স্ট্রিং প্যারামিটারগুলোর তালিকা। উদাহরণস্বরূপ, তিনটি স্নুজ বাটনের কথা ভাবুন: এখনই স্নুজ করুন, একদিন স্নুজ করুন, আগামী সপ্তাহে স্নুজ করুন। আপনি স্ট্রিং প্যারামিটারগুলোর তালিকায় স্নুজের ধরন এবং স্নুজের সময় পাস করে action method = snooze() ব্যবহার করতে পারেন।

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

string

অ্যাকশন স্ক্রিপ্টের প্যারামিটারের নাম।

value

string

প্যারামিটারটির মান।

মূলমান

একটি UI এলিমেন্টে একটি কী (লেবেল) এবং একটি ভ্যালু (কন্টেন্ট) থাকে। এই এলিমেন্টটিতে onclick বাটনের মতো কিছু অ্যাকশনও থাকতে পারে।

JSON উপস্থাপনা 
{
  "topLabel": string,
  "content": string,
  "contentMultiline": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  "icon": enum (Icon),
  "iconUrl": string

  "button": {
    object (Button)
  }
}
ক্ষেত্র
topLabel

string

শীর্ষ লেবেলের লেখা। ফরম্যাট করা লেখা সমর্থিত। লেখা ফরম্যাট করার বিষয়ে আরও তথ্যের জন্য, Google Chat অ্যাপে লেখা ফরম্যাট করা এবং Google Workspace অ্যাড-অন-এ লেখা ফরম্যাট করা দেখুন।

content

string

বিষয়বস্তুর টেক্সট। ফরম্যাট করা টেক্সট সমর্থিত এবং সর্বদা আবশ্যক। টেক্সট ফরম্যাট করার বিষয়ে আরও তথ্যের জন্য, Google Chat অ্যাপে টেক্সট ফরম্যাট করা এবং Google Workspace অ্যাড-অন-এ টেক্সট ফরম্যাট করা দেখুন।

contentMultiline

boolean

যদি বিষয়বস্তুটি একাধিক লাইনের হতে হয়।

bottomLabel

string

নিচের লেবেলের লেখা। ফরম্যাট করা টেক্সট সমর্থিত। টেক্সট ফরম্যাট করার বিষয়ে আরও তথ্যের জন্য, Google Chat অ্যাপে টেক্সট ফরম্যাট করা এবং Google Workspace অ্যাড-অন-এ টেক্সট ফরম্যাট করা দেখুন।

onClick

object ( OnClick )

onclick অ্যাকশন। শুধুমাত্র উপরের লেবেল, নিচের লেবেল এবং কন্টেন্ট অঞ্চল ক্লিকযোগ্য।

icons, top_label এবং bottom_label এর মধ্যে অন্তত একটি অবশ্যই সংজ্ঞায়িত থাকতে হবে। নিম্নলিখিতটি হলো পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলোর একটি তালিকা। একটি রেসপন্সে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা হবে:
icon

enum ( Icon )

একটি এনুম ভ্যালু যা চ্যাট এপিআই দ্বারা সংশ্লিষ্ট আইকন ইমেজ দিয়ে প্রতিস্থাপিত হয়।

iconUrl

string

একটি URL দ্বারা নির্দিষ্ট আইকন।

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

object ( Button )

এমন একটি বাটন, যেটিতে ক্লিক করে কোনো কাজ সম্পন্ন করা যায়।

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

আইকন

সমর্থিত আইকনসমূহের সেট।

এনাম
ICON_UNSPECIFIED
AIRPLANE
BOOKMARK
BUS
CAR
CLOCK
CONFIRMATION_NUMBER_ICON
DOLLAR
DESCRIPTION
EMAIL
EVENT_PERFORMER
EVENT_SEAT
FLIGHT_ARRIVAL
FLIGHT_DEPARTURE
HOTEL
HOTEL_ROOM_TYPE
INVITE
MAP_PIN
MEMBERSHIP
MULTIPLE_PEOPLE
OFFER
PERSON
PHONE
RESTAURANT_ICON
SHOPPING_CART
STAR
STORE
TICKET
TRAIN
VIDEO_CAMERA
VIDEO_PLAY

বোতাম

একটি বাটন। এটি টেক্সট বাটন অথবা ইমেজ বাটন হতে পারে।

JSON উপস্থাপনা 
{

  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
}
ক্ষেত্র
নিম্নলিখিতটি হলো পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলির একটি তালিকা। একটি উত্তরে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
textButton

object ( TextButton )

টেক্সট এবং onclick অ্যাকশন সহ একটি বাটন।

imageButton

object ( ImageButton )

ছবি এবং onclick অ্যাকশন সহ একটি বাটন।

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

টেক্সটবাটন

টেক্সট এবং onclick অ্যাকশন সহ একটি বাটন।

JSON উপস্থাপনা 
{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}
ক্ষেত্র
text

string

বাটনটির লেখা।

onClick

object ( OnClick )

বাটনটির onclick অ্যাকশন।

ইমেজবাটন

একটি onclick অ্যাকশনসহ ইমেজ বাটন।

JSON উপস্থাপনা 
{
  "onClick": {
    object (OnClick)
  },
  "name": string,

  "icon": enum (Icon),
  "iconUrl": string
}
ক্ষেত্র
onClick

object ( OnClick )

onclick অ্যাকশন।

name

string

এই imageButton নাম যা অ্যাক্সেসিবিলিটির জন্য ব্যবহৃত হয়। এই নামটি নির্দিষ্ট করা না থাকলে ডিফল্ট মান প্রদান করা হয়।

আইকনটি একটি Icon এনাম (Icon enum অথবা একটি ইউআরএল (URL) দ্বারা নির্দিষ্ট করা যেতে পারে। নিচে পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলোর একটি তালিকা দেওয়া হলো। একটি রেসপন্সে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা হবে:
icon

enum ( Icon )

একটি enum দ্বারা নির্দিষ্ট আইকন, যা চ্যাট এপিআই (Chat API) দ্বারা প্রদত্ত একটি আইকনকে নির্দেশ করে।

iconUrl

string

একটি URL দ্বারা নির্দিষ্ট আইকন।

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

কার্ডঅ্যাকশন

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

গুগল চ্যাট অ্যাপ দ্বারা সমর্থিত নয়।

JSON উপস্থাপনা 
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
ক্ষেত্র
actionLabel

string

লেবেলটি আগে অ্যাকশন মেনু আইটেমে প্রদর্শিত হতো।

onClick

object ( OnClick )

এই অ্যাকশন আইটেমটির জন্য onclick অ্যাকশন।