Cards v2

object ( CardHeader )

কার্ডের হেডার। একটি হেডারে সাধারণত একটি প্রধান ছবি এবং একটি শিরোনাম থাকে। হেডারগুলি সর্বদা একটি কার্ডের উপরে প্রদর্শিত হয়।

object ( Section )

উইজেটের একটি সংগ্রহ রয়েছে। প্রতিটি বিভাগের নিজস্ব, ঐচ্ছিক হেডার রয়েছে। বিভাগগুলি দৃশ্যত একটি লাইন বিভাজক দ্বারা পৃথক করা হয়। Google Chat অ্যাপে একটি উদাহরণের জন্য, একটি কার্ডের একটি অংশ সংজ্ঞায়িত করুন দেখুন।

enum ( DividerStyle )

হেডার, বিভাগ এবং ফুটারের মধ্যে বিভাজক শৈলী।

object ( CardAction )

কার্ডের ক্রিয়া। কার্ডের টুলবার মেনুতে ক্রিয়া যোগ করা হয়।

Google Workspace অ্যাড-অনের জন্য উপলব্ধ এবং Google Chat অ্যাপের জন্য অনুপলব্ধ।

উদাহরণস্বরূপ, নিম্নলিখিত JSON Settings এবং Send Feedback বিকল্পগুলির সাথে একটি কার্ড অ্যাকশন মেনু তৈরি করে:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]

string

কার্ডের নাম। কার্ড নেভিগেশনে কার্ড শনাক্তকারী হিসেবে ব্যবহৃত হয়।

Google Workspace অ্যাড-অনের জন্য উপলব্ধ এবং Google Chat অ্যাপের জন্য অনুপলব্ধ।

object ( CardFixedFooter )

এই কার্ডের নীচে দেখানো স্থির পাদলেখ।

primaryButton বা secondaryButton নির্দিষ্ট না করে fixedFooter সেট করলে ত্রুটি দেখা দেয়। চ্যাট অ্যাপের জন্য, আপনি ডায়ালগে ফিক্সড ফুটার ব্যবহার করতে পারেন, কিন্তু কার্ড মেসেজ নয়।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনের জন্য উপলব্ধ।

enum ( DisplayStyle )

Google Workspace অ্যাড-অনগুলিতে, peekCardHeader এর প্রদর্শন বৈশিষ্ট্য সেট করে।

Google Workspace অ্যাড-অনের জন্য উপলব্ধ এবং Google Chat অ্যাপের জন্য অনুপলব্ধ।

object ( CardHeader )

প্রাসঙ্গিক বিষয়বস্তু প্রদর্শনের সময়, পিক কার্ড হেডার একটি স্থানধারক হিসেবে কাজ করে যাতে ব্যবহারকারী হোমপেজ কার্ড এবং প্রাসঙ্গিক কার্ডের মধ্যে নেভিগেট করতে পারেন।

Google Workspace অ্যাড-অনের জন্য উপলব্ধ এবং Google Chat অ্যাপের জন্য অনুপলব্ধ।

string

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

string

কার্ড হেডারের সাবটাইটেল। যদি নির্দিষ্ট করা থাকে, তাহলে title নিচে নিজস্ব লাইনে প্রদর্শিত হবে।

enum ( ImageType )

ছবিটি কাটছাঁট করার জন্য ব্যবহৃত আকৃতি।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনের জন্য উপলব্ধ।

string

কার্ড হেডারে থাকা ছবির HTTPS URL।

string

এই ছবির বিকল্প টেক্সট যা অ্যাক্সেসিবিলিটির জন্য ব্যবহৃত হয়েছে।

string

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

object ( Widget )

বিভাগের সমস্ত উইজেট। কমপক্ষে একটি উইজেট থাকতে হবে।

boolean

এই অংশটি সঙ্কুচিত করা যাবে কিনা তা নির্দেশ করে।

সংকোচনযোগ্য বিভাগগুলি কিছু বা সমস্ত উইজেট লুকিয়ে রাখে, তবে ব্যবহারকারীরা আরও দেখান ক্লিক করে লুকানো উইজেটগুলি প্রকাশ করার জন্য বিভাগটি প্রসারিত করতে পারেন। ব্যবহারকারীরা কম দেখান ক্লিক করে আবার উইজেটগুলি লুকিয়ে রাখতে পারেন।

কোন উইজেটগুলি লুকানো আছে তা নির্ধারণ করতে, uncollapsibleWidgetsCount নির্দিষ্ট করুন।

integer

একটি অংশ আড়াল করার পরেও দৃশ্যমান থাকা অসংলগ্ন উইজেটের সংখ্যা।

উদাহরণস্বরূপ, যখন একটি বিভাগে পাঁচটি উইজেট থাকে এবং uncollapsibleWidgetsCount 2 তে সেট করা থাকে, তখন প্রথম দুটি উইজেট সর্বদা প্রদর্শিত হয় এবং শেষ তিনটি ডিফল্টরূপে সংকুচিত হয়। uncollapsibleWidgetsCount শুধুমাত্র তখনই বিবেচনা করা হয় যখন collapsible true হয়।

object ( CollapseControl )

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

enum ( HorizontalAlignment )

উইজেটগুলি কলামের বাম, ডান, অথবা কেন্দ্রে সারিবদ্ধ কিনা তা নির্দিষ্ট করে।

object ( TextParagraph )

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

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি বোল্ড টেক্সট তৈরি করে:

"textParagraph": {
  "text": "  <b>bold text</b>"
}

object ( Image )

একটি ছবি প্রদর্শন করে।

উদাহরণস্বরূপ, নিম্নলিখিত JSON বিকল্প পাঠ্য সহ একটি চিত্র তৈরি করে:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}

object ( DecoratedText )

একটি সজ্জিত টেক্সট আইটেম প্রদর্শন করে।

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি সজ্জিত টেক্সট উইজেট তৈরি করে যা ইমেল ঠিকানা দেখায়:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}

object ( ButtonList )

বোতামগুলির একটি তালিকা।

উদাহরণস্বরূপ, নিম্নলিখিত JSON দুটি বোতাম তৈরি করে। প্রথমটি হল একটি নীল টেক্সট বোতাম এবং দ্বিতীয়টি হল একটি চিত্র বোতাম যা একটি লিঙ্ক খুলবে:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

object ( TextInput )

ব্যবহারকারীরা টাইপ করতে পারেন এমন একটি টেক্সট বক্স প্রদর্শন করে।

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি ইমেল ঠিকানার জন্য একটি টেক্সট ইনপুট তৈরি করে:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

আরেকটি উদাহরণ হিসেবে, নিম্নলিখিত JSON স্ট্যাটিক সাজেশন সহ একটি প্রোগ্রামিং ভাষার জন্য একটি টেক্সট ইনপুট তৈরি করে:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

object ( SelectionInput )

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

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি ড্রপডাউন মেনু তৈরি করে যা ব্যবহারকারীদের একটি আকার নির্বাচন করতে দেয়:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}

object ( DateTimePicker )

একটি উইজেট প্রদর্শন করে যা ব্যবহারকারীদের তারিখ, সময়, অথবা তারিখ এবং সময় ইনপুট করতে দেয়।

উদাহরণস্বরূপ, নিম্নলিখিত JSON অ্যাপয়েন্টমেন্ট নির্ধারণের জন্য একটি তারিখ সময় চয়নকারী তৈরি করে:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": 796435200000
}

object ( Divider )

উইজেটের মধ্যে একটি অনুভূমিক রেখা বিভাজক প্রদর্শন করে।

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি বিভাজক তৈরি করে:

"divider": {
}

object ( Grid )

আইটেমের সংগ্রহ সহ একটি গ্রিড প্রদর্শন করে।

একটি গ্রিড যেকোনো সংখ্যক কলাম এবং আইটেম সমর্থন করে। সারির সংখ্যা নির্ধারিত হয় আইটেম সংখ্যার উপরের সীমানাকে কলামের সংখ্যা দিয়ে ভাগ করলে। ১০টি আইটেম এবং ২টি কলাম বিশিষ্ট একটি গ্রিডে ৫টি সারি থাকে। ১১টি আইটেম এবং ২টি কলাম বিশিষ্ট একটি গ্রিডে ৬টি সারি থাকে।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনের জন্য উপলব্ধ।

উদাহরণস্বরূপ, নিম্নলিখিত JSON একটি একক আইটেম সহ একটি 2 কলামের গ্রিড তৈরি করে:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

object ( Columns )

সর্বাধিক ২টি কলাম প্রদর্শিত হয়।

২টির বেশি কলাম অন্তর্ভুক্ত করতে, অথবা সারি ব্যবহার করতে, Grid উইজেট ব্যবহার করুন।

উদাহরণস্বরূপ, নিম্নলিখিত JSON 2টি কলাম তৈরি করে যার প্রতিটিতে টেক্সট অনুচ্ছেদ থাকে:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}

object ( Carousel )

একটি ক্যারোজেলে নেস্টেড উইজেটের একটি সংগ্রহ থাকে। উদাহরণস্বরূপ, এটি একটি ক্যারোজেলের JSON উপস্থাপনা যেখানে দুটি টেক্সট অনুচ্ছেদ রয়েছে।

{
  "widgets": [
    {
      "textParagraph": {
        "text": "First text paragraph in the carousel."
      }
    },
    {
      "textParagraph": {
        "text": "Second text paragraph in the carousel."
      }
    }
  ]
}

object ( ChipList )

চিপসের একটি তালিকা।

উদাহরণস্বরূপ, নিম্নলিখিত JSON দুটি চিপ তৈরি করে। প্রথমটি হল একটি টেক্সট চিপ এবং দ্বিতীয়টি হল একটি আইকন চিপ যা একটি লিঙ্ক খোলে:

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

string

উইজেটে প্রদর্শিত টেক্সট।

integer

উইজেটে প্রদর্শিত সর্বোচ্চ সংখ্যক লাইনের লেখা। যদি লেখাটি নির্দিষ্ট সর্বোচ্চ সংখ্যক লাইন অতিক্রম করে, তাহলে অতিরিক্ত বিষয়বস্তু একটি "আরও দেখান" বোতামের পিছনে লুকিয়ে থাকে। যদি লেখাটি নির্দিষ্ট সর্বোচ্চ সংখ্যক লাইনের সমান বা তার চেয়ে ছোট হয়, তাহলে "আরও দেখান" বোতামটি প্রদর্শিত হয় না।

ডিফল্ট মান হল ০, এই ক্ষেত্রে সমস্ত প্রসঙ্গ প্রদর্শিত হয়। নেতিবাচক মান উপেক্ষা করা হয়।

enum ( TextSyntax )

টেক্সটের সিনট্যাক্স। যদি সেট না করা থাকে, তাহলে টেক্সটটি HTML হিসেবে রেন্ডার করা হবে।

Google Chat অ্যাপের জন্য উপলব্ধ এবং Google Workspace অ্যাড-অনের জন্য অনুপলব্ধ।

string

ছবিটি হোস্ট করে এমন HTTPS URL।

উদাহরণস্বরূপ:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png

object ( OnClick )

যখন একজন ব্যবহারকারী ছবিতে ক্লিক করেন, তখন ক্লিকটি এই ক্রিয়াটি ট্রিগার করে।

string

এই ছবির বিকল্প টেক্সট যা অ্যাক্সেসিবিলিটির জন্য ব্যবহৃত হয়েছে।

object ( Action )

যদি নির্দিষ্ট করা থাকে, তাহলে এই onClick দ্বারা একটি ক্রিয়া ট্রিগার করা হয়।

object ( OpenLink )

যদি নির্দিষ্ট করা থাকে, তাহলে এই onClick একটি ওপেন লিঙ্ক অ্যাকশন ট্রিগার করে।

object ( Action )

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

Google Workspace অ্যাড-অনের জন্য উপলব্ধ এবং Google Chat অ্যাপের জন্য অনুপলব্ধ।

object ( Card )

নির্দিষ্ট করা থাকলে ক্লিক করার পরে একটি নতুন কার্ড কার্ড স্ট্যাকে পুশ করা হয়।

Google Workspace অ্যাড-অনের জন্য উপলব্ধ এবং Google Chat অ্যাপের জন্য অনুপলব্ধ।

object ( OverflowMenu )

যদি নির্দিষ্ট করা থাকে, তাহলে এই onClick একটি ওভারফ্লো মেনু খুলবে।

string

একটি কাস্টম ফাংশন যা কন্টেনিং এলিমেন্টে ক্লিক করলে বা অন্যথায় সক্রিয় হলে ব্যবহার করা হয়।

উদাহরণস্বরূপ ব্যবহারের জন্য, ফর্ম ডেটা পড়ুন দেখুন।

object ( ActionParameter )

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

enum ( LoadIndicator )

অ্যাকশনে কল করার সময় অ্যাকশনটি যে লোডিং ইন্ডিকেটরটি প্রদর্শন করে তা নির্দিষ্ট করে।

boolean

অ্যাকশনের পরেও ফর্মের মান টিকে থাকে কিনা তা নির্দেশ করে। ডিফল্ট মান হল false ।

যদি true , তাহলে অ্যাকশনটি ট্রিগার হওয়ার পরেও ফর্মের মানগুলি থেকে যাবে। অ্যাকশনটি প্রক্রিয়া করার সময় ব্যবহারকারী যাতে পরিবর্তন করতে পারেন, তার জন্য LoadIndicator NONE তে সেট করুন। চ্যাট অ্যাপে কার্ড মেসেজের জন্য, আপনাকে অ্যাকশনের ResponseType UPDATE_MESSAGE তে সেট করতে হবে এবং যে কার্ডে অ্যাকশনটি ছিল সেই কার্ডের একই cardId ব্যবহার করতে হবে।

যদি false হয়, তাহলে অ্যাকশনটি ট্রিগার করার সময় ফর্মের মানগুলি সাফ হয়ে যায়। অ্যাকশনটি প্রক্রিয়া করার সময় ব্যবহারকারী যাতে পরিবর্তন না করতে পারে তার জন্য, LoadIndicator SPINNER এ সেট করুন।

enum ( Interaction )

ঐচ্ছিক। ডায়ালগ খোলার সময় প্রয়োজন।

কোনও ব্যবহারকারীর সাথে মিথস্ক্রিয়ার প্রতিক্রিয়ায় কী করতে হবে, যেমন কোনও ব্যবহারকারী কার্ড বার্তার একটি বোতামে ক্লিক করলে।

যদি নির্দিষ্ট না করা থাকে, তাহলে অ্যাপটি স্বাভাবিকভাবে একটি action সম্পাদন করে — যেমন একটি লিঙ্ক খোলা বা একটি ফাংশন চালানো — সাড়া দেয়।

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

Google Chat অ্যাপের জন্য উপলব্ধ এবং Google Workspace অ্যাড-অনের জন্য অনুপলব্ধ।

string

ঐচ্ছিক। এই তালিকায় বৈধ জমা দেওয়ার জন্য এই অ্যাকশনের প্রয়োজনীয় উইজেটের নাম দিয়ে পূরণ করুন।

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

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনের জন্য উপলব্ধ।

boolean

ঐচ্ছিক। যদি এটি সত্য হয়, তাহলে এই ক্রিয়া দ্বারা সমস্ত উইজেট প্রয়োজনীয় বলে বিবেচিত হবে।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনের জন্য উপলব্ধ।

string

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

string

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

string

খোলার জন্য URL।

enum ( OpenAs )

কিভাবে একটি লিঙ্ক খুলবেন।

Google Workspace অ্যাড-অনের জন্য উপলব্ধ এবং Google Chat অ্যাপের জন্য অনুপলব্ধ।

enum ( OnClose )

ক্লায়েন্ট কি কোনও লিঙ্ক খোলার পরে ভুলে যায়, নাকি উইন্ডোটি বন্ধ না হওয়া পর্যন্ত এটি পর্যবেক্ষণ করে?

Google Workspace অ্যাড-অনের জন্য উপলব্ধ এবং Google Chat অ্যাপের জন্য অনুপলব্ধ।

object ( OverflowMenuItem )

প্রয়োজনীয়। মেনু বিকল্পগুলির তালিকা।

object ( Icon )

লেখার সামনে প্রদর্শিত আইকন।

string

প্রয়োজনীয়। ব্যবহারকারীদের কাছে আইটেমটি শনাক্ত বা বর্ণনা করে এমন টেক্সট।

object ( OnClick )

প্রয়োজনীয়। মেনু বিকল্প নির্বাচন করা হলে এই ক্রিয়াটি চালু হয়। এই OnClick একটি OverflowMenu থাকতে পারে না, যেকোনো নির্দিষ্ট OverflowMenu বাদ দেওয়া হয় এবং মেনু আইটেমটি অক্ষম করা হয়।

boolean

মেনু অপশনটি নিষ্ক্রিয় কিনা। ডিফল্ট হিসেবে false থাকে।

string

ঐচ্ছিক। অ্যাক্সেসিবিলিটির জন্য ব্যবহৃত আইকনের বর্ণনা। যদি নির্দিষ্ট না করা থাকে, তাহলে ডিফল্ট মান Button প্রদান করা হয়। সর্বোত্তম অনুশীলন হিসেবে, আইকনটি কী প্রদর্শন করে এবং প্রযোজ্য হলে, এটি কী করে তার জন্য আপনার একটি সহায়ক বিবরণ সেট করা উচিত। উদাহরণস্বরূপ, A user's account portrait , অথবা Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat ।

যদি আইকনটি একটি Button এ সেট করা থাকে, তাহলে ব্যবহারকারী যখন বোতামের উপর ঘোরান তখন altText সহায়ক টেক্সট হিসেবে উপস্থিত হয়। তবে, যদি বোতামটি text ও সেট করে, তাহলে আইকনের altText উপেক্ষা করা হয়।

enum ( ImageType )

ছবিতে ক্রপ স্টাইল প্রয়োগ করা হয়েছে। কিছু ক্ষেত্রে, একটি CIRCLE ক্রপ প্রয়োগ করলে ছবিটি বিল্ট-ইন আইকনের চেয়ে বড় আঁকা হয়।

string

Google Workspace দ্বারা প্রদত্ত বিল্ট-ইন আইকনগুলির মধ্যে একটি প্রদর্শন করুন।

উদাহরণস্বরূপ, একটি বিমানের আইকন প্রদর্শনের জন্য, AIRPLANE উল্লেখ করুন। একটি বাসের জন্য, BUS উল্লেখ করুন।

সমর্থিত আইকনগুলির সম্পূর্ণ তালিকার জন্য, অন্তর্নির্মিত আইকনগুলি দেখুন।

string

HTTPS URL-এ হোস্ট করা একটি কাস্টম আইকন প্রদর্শন করুন।

উদাহরণস্বরূপ:

"iconUrl":
"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"

সমর্থিত ফাইলের ধরণগুলির মধ্যে রয়েছে .png এবং .jpg ।

object ( MaterialIcon )

গুগল ম্যাটেরিয়াল আইকনগুলির মধ্যে একটি প্রদর্শন করুন।

উদাহরণস্বরূপ, একটি চেকবক্স আইকন প্রদর্শন করতে, ব্যবহার করুন

"materialIcon": {
  "name": "check_box"
}

Google Chat অ্যাপের জন্য উপলব্ধ এবং Google Workspace অ্যাড-অনের জন্য অনুপলব্ধ।

string

গুগল ম্যাটেরিয়াল আইকনে সংজ্ঞায়িত আইকনের নাম, উদাহরণস্বরূপ, check_box । যেকোনো অবৈধ নাম পরিত্যাগ করা হয় এবং খালি স্ট্রিং দিয়ে প্রতিস্থাপিত হয় এবং এর ফলে আইকনটি রেন্ডার করতে ব্যর্থ হয়।

boolean

আইকনটি পূর্ণ হিসেবে রেন্ডার করা হচ্ছে কিনা। ডিফল্ট মান মিথ্যা।

বিভিন্ন আইকন সেটিংসের পূর্বরূপ দেখতে, Google Font Icons- এ যান এবং Customize এর অধীনে সেটিংস সামঞ্জস্য করুন।

integer

আইকনের স্ট্রোক ওজন। {100, 200, 300, 400, 500, 600, 700} থেকে বেছে নিন। যদি অনুপস্থিত থাকে, তাহলে ডিফল্ট মান 400 হবে। যদি অন্য কোনও মান নির্দিষ্ট করা থাকে, তাহলে ডিফল্ট মান ব্যবহার করা হবে।

বিভিন্ন আইকন সেটিংসের পূর্বরূপ দেখতে, Google Font Icons- এ যান এবং Customize এর অধীনে সেটিংস সামঞ্জস্য করুন।

integer

ওজন এবং গ্রেড একটি প্রতীকের পুরুত্বকে প্রভাবিত করে। গ্রেডের সমন্বয় ওজনের সমন্বয়ের তুলনায় বেশি সূক্ষ্ম এবং প্রতীকের আকারের উপর সামান্য প্রভাব ফেলে। {-25, 0, 200} থেকে বেছে নিন। যদি অনুপস্থিত থাকে, তাহলে ডিফল্ট মান 0। যদি অন্য কোনও মান নির্দিষ্ট করা থাকে, তাহলে ডিফল্ট মান ব্যবহার করা হয়।

বিভিন্ন আইকন সেটিংসের পূর্বরূপ দেখতে, Google Font Icons- এ যান এবং Customize এর অধীনে সেটিংস সামঞ্জস্য করুন।

object ( Icon )

startIcon এর পক্ষে বন্ধ করা হয়েছে।

object ( Icon )

লেখার সামনে প্রদর্শিত আইকন।

enum ( VerticalAlignment )

ঐচ্ছিক। শুরু আইকনের উল্লম্ব সারিবদ্ধকরণ। যদি সেট না করা থাকে, তাহলে আইকনটি উল্লম্বভাবে কেন্দ্রীভূত হবে।

Google Chat অ্যাপের জন্য উপলব্ধ এবং Google Workspace অ্যাড-অনের জন্য অনুপলব্ধ।

string

text উপরে যে টেক্সটটি প্রদর্শিত হবে। সর্বদা ছোট করে কাটা হবে।

object ( TextParagraph )

TextParagraph topLabel এর সমতুল্য। সর্বদা ছাঁটাই করে। topLabel এর চেয়ে আরও জটিল ফর্ম্যাটিং করার অনুমতি দেয়।

Google Chat অ্যাপের জন্য উপলব্ধ এবং Google Workspace অ্যাড-অনের জন্য অনুপলব্ধ।

string

প্রয়োজনীয়। প্রাথমিক লেখা।

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

object ( TextParagraph )

TextParagraph text সমতুল্য। text চেয়ে আরও জটিল ফর্ম্যাটিং করার অনুমতি দেয়।

Google Chat অ্যাপের জন্য উপলব্ধ এবং Google Workspace অ্যাড-অনের জন্য অনুপলব্ধ।

boolean

মোড়ানো টেক্সট সেটিং। যদি true , তাহলে টেক্সটটি মোড়ানো হবে এবং একাধিক লাইনে প্রদর্শিত হবে। অন্যথায়, টেক্সটটি ছোট করা হবে।

শুধুমাত্র text ক্ষেত্রে প্রযোজ্য, topLabel এবং bottomLabel ক্ষেত্রে নয়।

string

text নিচে যে লেখাটি প্রদর্শিত হবে। সর্বদা মোড়ানো থাকে।

object ( TextParagraph )

TextParagraph bottomLabel এর সমতুল্য। সর্বদা মোড়ানো হয়। bottomLabel চেয়ে আরও জটিল বিন্যাসের জন্য অনুমতি দেয়।

Google Chat অ্যাপের জন্য উপলব্ধ এবং Google Workspace অ্যাড-অনের জন্য অনুপলব্ধ।

object ( OnClick )

ব্যবহারকারীরা যখন topLabel অথবা bottomLabel এ ক্লিক করেন তখন এই ক্রিয়াটি ট্রিগার হয়।

object ( Button )

একটি বোতাম যা ব্যবহারকারী কোনও ক্রিয়া শুরু করতে ক্লিক করতে পারেন।

object ( SwitchControl )

একটি সুইচ উইজেট যা ব্যবহারকারী ক্লিক করে এর অবস্থা পরিবর্তন করতে এবং কোনও ক্রিয়া শুরু করতে পারেন।

object ( Icon )

লেখার পরে একটি আইকন প্রদর্শিত হবে।

অন্তর্নির্মিত এবং কাস্টম আইকন সমর্থন করে।

string

বোতামের ভেতরে প্রদর্শিত লেখা।

object ( Icon )

বোতামের ভেতরে একটি আইকন প্রদর্শিত হবে। যদি icon এবং text উভয়ই সেট করা থাকে, তাহলে টেক্সটের আগে আইকনটি প্রদর্শিত হবে।

object ( Color )

ঐচ্ছিক। বোতামের রঙ। যদি সেট করা থাকে, তাহলে বোতামের type FILLED তে সেট করা হয় এবং পাঠযোগ্যতার জন্য text এবং icon ক্ষেত্রের রঙ একটি বিপরীত রঙে সেট করা হয়। উদাহরণস্বরূপ, যদি বোতামের রঙ নীল তে সেট করা থাকে, তাহলে বোতামের যেকোনো পাঠ্য বা আইকন সাদা তে সেট করা হয়।

বোতামের রঙ সেট করতে, red , green এবং blue ক্ষেত্রের জন্য একটি মান নির্দিষ্ট করুন। মানটি RGB রঙের মানের উপর ভিত্তি করে 0 এবং 1 এর মধ্যে একটি ফ্লোট নম্বর হতে হবে, যেখানে 0 (0/255) রঙের অনুপস্থিতি এবং 1 (255/255) রঙের সর্বাধিক তীব্রতা প্রতিনিধিত্ব করে।

উদাহরণস্বরূপ, নিম্নলিখিতটি সর্বোচ্চ তীব্রতায় রঙটিকে লালে সেট করে:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

বোতামের রঙের জন্য alpha ক্ষেত্রটি অনুপলব্ধ। যদি নির্দিষ্ট করা থাকে, তাহলে এই ক্ষেত্রটি উপেক্ষা করা হবে।

object ( OnClick )

প্রয়োজনীয়। ব্যবহারকারী যখন বোতামে ক্লিক করেন তখন যে ক্রিয়া সম্পাদন করতে হয়, যেমন হাইপারলিঙ্ক খোলা বা কাস্টম ফাংশন চালানো।

boolean

যদি true , তাহলে বোতামটি নিষ্ক্রিয় অবস্থায় প্রদর্শিত হবে এবং ব্যবহারকারীর ক্রিয়াকলাপে সাড়া দেবে না।

string

অ্যাক্সেসিবিলিটির জন্য ব্যবহৃত বিকল্প পাঠ্য।

বর্ণনামূলক টেক্সট সেট করুন যা ব্যবহারকারীদের জানাবে বোতামটি কী করে। উদাহরণস্বরূপ, যদি একটি বোতাম একটি হাইপারলিঙ্ক খোলে, তাহলে আপনি লিখতে পারেন: "একটি নতুন ব্রাউজার ট্যাব খোলে এবং https://developers.google.com/workspace/chat-এ Google Chat ডেভেলপার ডকুমেন্টেশনে নেভিগেট করে" ।

enum ( Type )

ঐচ্ছিক। বোতামের ধরণ। সেট না করা থাকলে, বোতামের ধরণটি ডিফল্টভাবে OUTLINED এ থাকে। যদি color ক্ষেত্রটি সেট করা থাকে, তাহলে বোতামের ধরণটি FILLED তে বাধ্য করা হয় এবং এই ক্ষেত্রের জন্য সেট করা যেকোনো মান উপেক্ষা করা হয়।

number

ব্যবধানে [0, 1] মান হিসেবে রঙের লাল রঙের পরিমাণ।

number

ব্যবধানে [0, 1] মান হিসেবে রঙের সবুজের পরিমাণ।

number

ব্যবধানে [0, 1] মান হিসেবে রঙের নীলের পরিমাণ।

number

এই রঙের ভগ্নাংশ যা পিক্সেলে প্রয়োগ করা উচিত। অর্থাৎ, চূড়ান্ত পিক্সেল রঙটি সমীকরণ দ্বারা সংজ্ঞায়িত করা হয়:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

এর অর্থ হল ১.০ এর মান একটি কঠিন রঙের সাথে মিলে যায়, যেখানে ০.০ এর মান একটি সম্পূর্ণ স্বচ্ছ রঙের সাথে মিলে যায়। এটি একটি সাধারণ ফ্লোট স্কেলারের পরিবর্তে একটি র‍্যাপার বার্তা ব্যবহার করে যাতে একটি ডিফল্ট মান এবং সেট না করা মানের মধ্যে পার্থক্য করা সম্ভব হয়। যদি বাদ দেওয়া হয়, তাহলে এই রঙের বস্তুটি একটি কঠিন রঙ হিসাবে রেন্ডার করা হয় (যেন আলফা মানটিকে স্পষ্টভাবে ১.০ এর মান দেওয়া হয়েছে)।

string

একটি ফর্ম ইনপুট ইভেন্টে সুইচ উইজেট যে নাম দ্বারা চিহ্নিত করা হয়।

ফর্ম ইনপুট নিয়ে কাজ করার বিশদ বিবরণের জন্য, ফর্ম ডেটা গ্রহণ দেখুন।

string

একজন ব্যবহারকারীর দ্বারা প্রবেশ করানো মান, একটি ফর্ম ইনপুট ইভেন্টের অংশ হিসাবে ফিরে এসেছে।

ফর্ম ইনপুট নিয়ে কাজ করার বিশদ বিবরণের জন্য, ফর্ম ডেটা গ্রহণ দেখুন।

boolean

যখন true , তখন সুইচটি নির্বাচিত হয়।

object ( Action )

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

enum ( ControlType )

ইউজার ইন্টারফেসে সুইচটি কীভাবে প্রদর্শিত হবে।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনের জন্য উপলব্ধ।

object ( Button )

বোতামের একটি অ্যারে।

string

একটি ফর্ম ইনপুট ইভেন্টে টেক্সট ইনপুট শনাক্ত করার নাম।

ফর্ম ইনপুট নিয়ে কাজ করার বিশদ বিবরণের জন্য, ফর্ম ডেটা গ্রহণ দেখুন।

string

ইউজার ইন্টারফেসের টেক্সট ইনপুট ফিল্ডের উপরে যে টেক্সটটি প্রদর্শিত হবে।

এমন টেক্সট নির্দিষ্ট করুন যা ব্যবহারকারীকে আপনার অ্যাপের প্রয়োজনীয় তথ্য প্রবেশ করতে সাহায্য করে। উদাহরণস্বরূপ, যদি আপনি কারো নাম জিজ্ঞাসা করেন, কিন্তু বিশেষভাবে তাদের পদবি চান, তাহলে name এর পরিবর্তে surname লিখুন।

hintText নির্দিষ্ট না থাকলে প্রয়োজন। অন্যথায়, ঐচ্ছিক।

string

টেক্সট ইনপুট ফিল্ডের নিচে যে টেক্সটটি প্রদর্শিত হবে তা ব্যবহারকারীদের একটি নির্দিষ্ট মান প্রবেশ করতে প্ররোচিত করে সহায়তা করার জন্য তৈরি। এই টেক্সটটি সর্বদা দৃশ্যমান থাকে।

label নির্দিষ্ট না থাকলে প্রয়োজন। অন্যথায়, ঐচ্ছিক।

string

একজন ব্যবহারকারীর দ্বারা প্রবেশ করানো মান, একটি ফর্ম ইনপুট ইভেন্টের অংশ হিসাবে ফিরে এসেছে।

ফর্ম ইনপুট নিয়ে কাজ করার বিশদ বিবরণের জন্য, ফর্ম ডেটা গ্রহণ দেখুন।

enum ( Type )

ইউজার ইন্টারফেসে একটি টেক্সট ইনপুট ফিল্ড কীভাবে প্রদর্শিত হয়। উদাহরণস্বরূপ, ফিল্ডটি একক নাকি বহু-লাইন।

object ( Action )

টেক্সট ইনপুট ফিল্ডে কোনও পরিবর্তন হলে কী করবেন। উদাহরণস্বরূপ, কোনও ব্যবহারকারী ফিল্ডে টেক্সট যোগ করছেন বা মুছে ফেলছেন।

যেসব পদক্ষেপ নিতে হবে তার মধ্যে রয়েছে একটি কাস্টম ফাংশন চালানো অথবা Google Chat-এ একটি ডায়ালগ খোলা।

object ( Suggestions )

ব্যবহারকারীরা যে মানগুলি লিখতে পারেন তার প্রস্তাবিত মান। ব্যবহারকারীরা টেক্সট ইনপুট ক্ষেত্রের ভিতরে ক্লিক করলে এই মানগুলি প্রদর্শিত হয়। ব্যবহারকারীরা টাইপ করার সাথে সাথে, প্রস্তাবিত মানগুলি ব্যবহারকারীদের টাইপ করা মানগুলির সাথে মেলে গতিশীলভাবে ফিল্টার করে।

উদাহরণস্বরূপ, প্রোগ্রামিং ভাষার জন্য একটি টেক্সট ইনপুট ফিল্ড জাভা, জাভাস্ক্রিপ্ট, পাইথন এবং সি++ এর পরামর্শ দিতে পারে। ব্যবহারকারীরা যখন Jav টাইপ করা শুরু করেন, তখন পরামর্শের তালিকাটি কেবল Java এবং JavaScript দেখানোর জন্য ফিল্টার করে।

প্রস্তাবিত মানগুলি ব্যবহারকারীদের আপনার অ্যাপের অর্থ বুঝতে পারে এমন মানগুলি প্রবেশ করতে সহায়তা করে। জাভাস্ক্রিপ্ট উল্লেখ করার সময়, কিছু ব্যবহারকারী javascript এবং অন্যরা java script লিখতে পারে। JavaScript প্রস্তাবিত হলে ব্যবহারকারীরা আপনার অ্যাপের সাথে কীভাবে ইন্টারঅ্যাক্ট করে তা মানসম্মত করা যেতে পারে।

নির্দিষ্ট করা হলে, TextInput.type সর্বদা SINGLE_LINE থাকে, এমনকি যদি এটি MULTIPLE_LINE তে সেট করা থাকে।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনের জন্য উপলব্ধ।

object ( Action )

ঐচ্ছিক। টেক্সট ইনপুট ফিল্ড যখন ব্যবহারকারীদের সাথে ইন্টারঅ্যাক্ট করার পরামর্শ দেয় তখন কী পদক্ষেপ নিতে হবে তা নির্দিষ্ট করুন।

যদি নির্দিষ্ট না করা থাকে, তাহলে পরামর্শগুলি initialSuggestions দ্বারা সেট করা হয় এবং ক্লায়েন্ট দ্বারা প্রক্রিয়া করা হয়।

যদি নির্দিষ্ট করা থাকে, তাহলে অ্যাপটি এখানে নির্দিষ্ট পদক্ষেপ গ্রহণ করে, যেমন একটি কাস্টম ফাংশন চালানো।

Google Workspace অ্যাড-অনের জন্য উপলব্ধ এবং Google Chat অ্যাপের জন্য অনুপলব্ধ।

object ( Validation )

এই টেক্সট ফিল্ডের জন্য প্রয়োজনীয় ইনপুট ফর্ম্যাট যাচাইকরণ নির্দিষ্ট করুন।

Google Chat অ্যাপ এবং Google Workspace অ্যাড-অনের জন্য উপলব্ধ।

string

যখন ক্ষেত্রটি খালি থাকে তখন টেক্সট ইনপুট ক্ষেত্রে প্রদর্শিত টেক্সট। ব্যবহারকারীদের একটি মান প্রবেশ করতে অনুরোধ করার জন্য এই টেক্সটটি ব্যবহার করুন। উদাহরণস্বরূপ, Enter a number from 0 to 100 ।

Google Chat অ্যাপের জন্য উপলব্ধ এবং Google Workspace অ্যাড-অনের জন্য অনুপলব্ধ।

Action

Navigation

কার্ড পুশ, পপ, অথবা আপডেট করে।

গুগল চ্যাটে অ্যাড-অন ।

Card

Pushes a card onto the card stack.

For dialogs in Google Chat , opens or updates a dialog.

Card

Updates the top card with a new card and preserves filled form fields values. For a non-equivalent field, the value is dropped.

For dialogs in Google Chat , opens or updates a dialog.

object ( SuggestionItem )

A list of suggestions used for autocomplete recommendations in text input fields.

string

The value of a suggested input to a text input field. This is equivalent to what users enter themselves.

integer

Specify the character limit for text input widgets. Note that this is only used for text input and is ignored for other widgets.

Available for Google Chat apps and Google Workspace add-ons.

enum ( InputType )

Specify the type of the input widgets.

Available for Google Chat apps and Google Workspace add-ons.

string

Required. The name that identifies the selection input in a form input event.

For details about working with form inputs, see Receive form data .

string

The text that appears above the selection input field in the user interface.

Specify text that helps the user enter the information your app needs. For example, if users are selecting the urgency of a work ticket from a drop-down menu, the label might be "Urgency" or "Select urgency".

enum ( SelectionType )

The type of items that are displayed to users in a SelectionInput widget. Selection types support different types of interactions. For example, users can select one or more checkboxes, but they can only select one value from a dropdown menu.

object ( SelectionItem )

An array of selectable items. For example, an array of radio buttons or checkboxes. Supports up to 100 items.

object ( Action )

If specified, the form is submitted when the selection changes. If not specified, you must specify a separate button that submits the form.

For details about working with form inputs, see Receive form data .

integer

For multiselect menus, the number of text characters that a user inputs before the menu returns suggested selection items.

If unset, the multiselect menu uses the following default values:

• If the menu uses a static array of SelectionInput items, defaults to 0 characters and immediately populates items from the array.
• If the menu uses a dynamic data source ( multi_select_data_source ), defaults to 3 characters before querying the data source to return suggested items.

integer

For multiselect menus, the maximum number of items that a user can select. Minimum value is 1 item. If unspecified, defaults to 3 items.

object ( Action )

An external data source, such as a relational database.

object ( PlatformDataSource )

A data source from Google Workspace.

string

The text that identifies or describes the item to users.

string

The value associated with this item. The client should use this as a form input value.

For details about working with form inputs, see Receive form data .

boolean

Whether the item is selected by default. If the selection input only accepts one value (such as for radio buttons or a dropdown menu), only set this field for one item.

string

For multiselect menus, a text description or label that's displayed below the item's text field.

string

enum ( CommonDataSource )

A data source shared by all Google Workspace applications, such as users in a Google Workspace organization.

object ( HostAppDataSourceMarkup )

A data source that's unique to a Google Workspace host application, such spaces in Google Chat.

This field supports the Google API Client Libraries but isn't available in the Cloud Client Libraries. To learn more, see Install the client libraries .

object ( ChatClientDataSourceMarkup )

A data source from Google Chat.

object ( SpaceDataSource )

Google Chat spaces that the user is a member of.

boolean

If set to true , the multiselect menu selects the current Google Chat space as an item by default.

string

The name by which the DateTimePicker is identified in a form input event.

For details about working with form inputs, see Receive form data .

string

The text that prompts users to input a date, a time, or a date and time. For example, if users are scheduling an appointment, use a label such as Appointment date or Appointment date and time .

enum ( DateTimePickerType )

Whether the widget supports inputting a date, a time, or the date and time.

string ( int64 format)

The default value displayed in the widget, in milliseconds since Unix epoch time .

Specify the value based on the type of picker ( DateTimePickerType ):

• DATE_AND_TIME : a calendar date and time in UTC. For example, to represent January 1, 2023 at 12:00 PM UTC, use 1672574400000 .
• DATE_ONLY : a calendar date at 00:00:00 UTC. For example, to represent January 1, 2023, use 1672531200000 .
• TIME_ONLY : a time in UTC. For example, to represent 12:00 PM, use 43200000 (or 12 * 60 * 60 * 1000 ).

integer

The number representing the time zone offset from UTC, in minutes. If set, the valueMsEpoch is displayed in the specified time zone. If unset, the value defaults to the user's time zone setting.

object ( Action )

Triggered when the user clicks Save or Clear from the DateTimePicker interface.

string

The text that displays in the grid header.

object ( GridItem )

The items to display in the grid.

object ( BorderStyle )

The border style to apply to each grid item.

integer

The number of columns to display in the grid. A default value is used if this field isn't specified, and that default value is different depending on where the grid is shown (dialog versus companion).

object ( OnClick )

This callback is reused by each individual grid item, but with the item's identifier and index in the items list added to the callback's parameters.

string

A user-specified identifier for this grid item. This identifier is returned in the parent grid's onClick callback parameters.

object ( ImageComponent )

The image that displays in the grid item.

string

The grid item's title.

string

The grid item's subtitle.

enum ( GridItemLayout )

The layout to use for the grid item.

string

The image URL.

string

The accessibility label for the image.

object ( ImageCropStyle )

The crop style to apply to the image.

object ( BorderStyle )

The border style to apply to the image.

enum ( ImageCropType )

The crop type.

number

The aspect ratio to use if the crop type is RECTANGLE_CUSTOM .

For example, here's how to apply a 16:9 aspect ratio:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

enum ( BorderType )

The border type.

object ( Color )

The colors to use when the type is BORDER_TYPE_STROKE .

To set the stroke color, specify a value for the red , green , and blue fields. The value must be a float number between 0 and 1 based on the RGB color value, where 0 (0/255) represents the absence of color and 1 (255/255) represents the maximum intensity of the color.

For example, the following sets the color to red at its maximum intensity:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

The alpha field is unavailable for stroke color. If specified, this field is ignored.

integer

The corner radius for the border.

object ( Column )

An array of columns. You can include up to 2 columns in a card or dialog.

enum ( HorizontalSizeStyle )

Specifies how a column fills the width of the card.

enum ( HorizontalAlignment )

Specifies whether widgets align to the left, right, or center of a column.

enum ( VerticalAlignment )

Specifies whether widgets align to the top, bottom, or center of a column.

object ( Widgets )

An array of widgets included in a column. Widgets appear in the order that they are specified.

object ( TextParagraph )

TextParagraph widget.

object ( Image )

Image widget.

object ( DecoratedText )

DecoratedText widget.

object ( ButtonList )

ButtonList widget.

object ( TextInput )

TextInput widget.

object ( SelectionInput )

SelectionInput widget.

object ( DateTimePicker )

DateTimePicker widget.

object ( ChipList )

ChipList widget.

enum ( Layout )

Specified chip list layout.

object ( Chip )

An array of chips.

object ( Icon )

The icon image. If both icon and text are set, then the icon appears before the text.

string

The text displayed inside the chip.

object ( OnClick )

Optional. The action to perform when a user clicks the chip, such as opening a hyperlink or running a custom function.

boolean

Whether the chip is in an active state and responds to user actions. Defaults to true . Deprecated. Use disabled instead.

boolean

Whether the chip is in an inactive state and ignores user actions. Defaults to false .

string

The alternative text that's used for accessibility.

Set descriptive text that lets users know what the chip does. For example, if a chip opens a hyperlink, write: "Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat" .

object ( CarouselCard )

A list of cards included in the carousel.

object ( NestedWidget )

A list of widgets displayed in the carousel card. The widgets are displayed in the order that they are specified.

object ( NestedWidget )

A list of widgets displayed at the bottom of the carousel card. The widgets are displayed in the order that they are specified.

object ( TextParagraph )

A text paragraph widget.

object ( ButtonList )

A button list widget.

object ( Image )

An image widget.

enum ( HorizontalAlignment )

The horizontal alignment of the expand and collapse button.

object ( Button )

Optional. Define a customizable button to expand the section. Both expandButton and collapseButton field must be set. Only one field set will not take into effect. If this field isn't set, the default button is used.

object ( Button )

Optional. Define a customizable button to collapse the section. Both expandButton and collapseButton field must be set. Only one field set will not take into effect. If this field isn't set, the default button is used.

string

The label that displays as the action menu item.

object ( OnClick )

The onClick action for this action item.

object ( Button )

The primary button of the fixed footer. The button must be a text button with text and color set.

object ( Button )

The secondary button of the fixed footer. The button must be a text button with text and color set. If secondaryButton is set, you must also set primaryButton .