Cards v2

object ( CardHeader )

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

object ( Section )

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

enum ( DividerStyle )

হেডার, সেকশন ও ফুটারের মধ্যবর্তী বিভাজক শৈলী।

object ( CardAction )

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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ, কিন্তু গুগল চ্যাট অ্যাপগুলির জন্য অনুপলব্ধ।

উদাহরণস্বরূপ, নিম্নলিখিত 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

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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ, কিন্তু গুগল চ্যাট অ্যাপগুলির জন্য অনুপলব্ধ।

object ( CardFixedFooter )

এই কার্ডের নীচে স্থির ফুটারটি দেখানো হয়েছে।

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

গুগল চ্যাট অ্যাপ এবং গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ।

enum ( DisplayStyle )

গুগল ওয়ার্কস্পেস অ্যাড-অন-এ, এটি peekCardHeader এর ডিসপ্লে প্রোপার্টি সেট করে।

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ, কিন্তু গুগল চ্যাট অ্যাপগুলির জন্য অনুপলব্ধ।

object ( CardHeader )

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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ, কিন্তু গুগল চ্যাট অ্যাপগুলির জন্য অনুপলব্ধ।

object ( ExpressionData )

কার্ডটির জন্য এক্সপ্রেশন ডেটা।

Google Workspace Studio-এর কার্যকারিতা বর্ধনকারী Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ। Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

string

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

string

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

enum ( ImageType )

ছবিটি ক্রপ করতে ব্যবহৃত আকৃতি।

গুগল চ্যাট অ্যাপ এবং গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ।

string

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

string

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

string

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

object ( Widget )

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

boolean

এই অংশটি ভাঁজযোগ্য কিনা তা নির্দেশ করে।

সংকুচিত করা যায় এমন বিভাগগুলো কিছু বা সমস্ত উইজেট লুকিয়ে রাখে, কিন্তু ব্যবহারকারীরা 'আরও দেখান' (Show more) এ ক্লিক করে বিভাগটি প্রসারিত করার মাধ্যমে লুকানো উইজেটগুলো আবার দেখতে পারেন। ব্যবহারকারীরা 'কম দেখান' (Show less) এ ক্লিক করে উইজেটগুলো পুনরায় লুকাতে পারেন।

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

integer

যেসব উইজেট কোনো সেকশন সংকুচিত করার পরেও দৃশ্যমান থাকে, তাদের সংখ্যা।

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

string

যে সেকশনটি পরিবর্তন করা হবে, সেটিকে শনাক্ত করার জন্য নির্ধারিত একটি অনন্য আইডি। আইডিটির অক্ষর সংখ্যা ৬৪-এর মধ্যে সীমাবদ্ধ এবং এটি [a-zA-Z0-9-]+ ফরম্যাটে হতে হবে।

Google Workspace Studio-এর কার্যকারিতা বর্ধনকারী Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ। Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

object ( CollapseControl )

ঐচ্ছিক। সেকশনটির এক্সপ্যান্ড এবং কলাপস বাটন নির্ধারণ করুন। এই বাটনটি শুধুমাত্র তখনই দেখানো হবে যখন সেকশনটি কলাপসিবল হবে। এই ফিল্ডটি সেট করা না থাকলে, ডিফল্ট বাটনটি ব্যবহৃত হবে।

enum ( HorizontalAlignment )

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

string

যে উইজেটটি পরিবর্তন করা হবে, সেটিকে শনাক্ত করার জন্য উইজেটটিকে একটি অনন্য আইডি দেওয়া হয়। আইডিটির অক্ষর সংখ্যা ৬৪-এর মধ্যে সীমাবদ্ধ এবং [a-zA-Z0-9-]+ এবং এই ফরম্যাটে হতে হবে।

Google Workspace Studio-এর কার্যকারিতা বর্ধনকারী Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ। Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

enum ( Visibility )

উইজেটটি দৃশ্যমান হবে নাকি অদৃশ্য থাকবে তা নির্দিষ্ট করে। এর ডিফল্ট মান হলো VISIBLE )।

Google Workspace Studio-এর কার্যকারিতা বর্ধনকারী Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ। Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

object ( EventAction )

উইজেটটিতে যে ইভেন্ট অ্যাকশনগুলো সম্পাদন করা যেতে পারে, তা নির্দিষ্ট করে।

Google Workspace Studio-এর কার্যকারিতা বর্ধনকারী Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ। Google Chat অ্যাপগুলির জন্য অনুপলব্ধ।

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 )

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

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

গুগল চ্যাট অ্যাপ এবং গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ।

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

"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-টি ২টি কলাম তৈরি করে, যেগুলোর প্রতিটিতে টেক্সট প্যারাগ্রাফ থাকে:

"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 হিসেবে রেন্ডার করা হয়।

গুগল চ্যাট অ্যাপের জন্য উপলব্ধ, কিন্তু গুগল ওয়ার্কস্পেস অ্যাড-অনের জন্য অনুপলব্ধ।

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 থেকে ভিন্ন, কারণ লিঙ্কটি পাওয়ার জন্য এটিকে সার্ভারের সাথে যোগাযোগ করতে হয়। সুতরাং, ওপেন লিঙ্ক অ্যাকশনের প্রতিক্রিয়া ফিরে আসার আগে ওয়েব ক্লায়েন্টকে কিছু প্রস্তুতিমূলক কাজ করতে হয়।

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ, কিন্তু গুগল চ্যাট অ্যাপগুলির জন্য অনুপলব্ধ।

object ( Card )

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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ, কিন্তু গুগল চ্যাট অ্যাপগুলির জন্য অনুপলব্ধ।

object ( OverflowMenu )

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

string

একটি কাস্টম ফাংশন যা ধারণকারী এলিমেন্টটি ক্লিক করা হলে বা অন্য কোনোভাবে সক্রিয় হলে চালু হয়।

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

object ( ActionParameter )

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

enum ( LoadIndicator )

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

boolean

কাজটি সম্পন্ন হওয়ার পর ফর্মের মানগুলো স্থায়ী থাকবে কিনা তা নির্দেশ করে। এর ডিফল্ট মান হলো false ।

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

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

enum ( Interaction )

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

ব্যবহারকারীর সাথে কোনো ইন্টারঅ্যাকশনের জবাবে কী করতে হবে, যেমন ব্যবহারকারী কার্ড মেসেজে কোনো বাটনে ক্লিক করলে।

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

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

গুগল চ্যাট অ্যাপের জন্য উপলব্ধ, কিন্তু গুগল ওয়ার্কস্পেস অ্যাড-অনের জন্য অনুপলব্ধ।

string

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

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

গুগল চ্যাট অ্যাপ এবং গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ।

boolean

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

গুগল চ্যাট অ্যাপ এবং গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ।

string

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

string

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

string

খোলার জন্য ইউআরএল। HTTP ইউআরএলগুলোকে HTTPS-এ রূপান্তর করা হয়।

enum ( OpenAs )

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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ, কিন্তু গুগল চ্যাট অ্যাপগুলির জন্য অনুপলব্ধ।

enum ( OnClose )

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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ, কিন্তু গুগল চ্যাট অ্যাপগুলির জন্য অনুপলব্ধ।

object ( OverflowMenuItem )

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

object ( Icon )

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

string

আবশ্যক। যে লেখাটি ব্যবহারকারীদের কাছে পণ্যটিকে শনাক্ত বা বর্ণনা করে।

object ( OnClick )

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

boolean

মেনু বিকল্পটি নিষ্ক্রিয় কিনা। ডিফল্টরূপে এটি নিষ্ক্রিয় থাকে।

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

গুগল ওয়ার্কস্পেস দ্বারা প্রদত্ত অন্তর্নির্মিত আইকনগুলোর মধ্যে একটি প্রদর্শন করুন।

উদাহরণস্বরূপ, একটি বিমানের আইকন প্রদর্শন করতে 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"
}

গুগল চ্যাট অ্যাপের জন্য উপলব্ধ, কিন্তু গুগল ওয়ার্কস্পেস অ্যাড-অনের জন্য অনুপলব্ধ।

string

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

boolean

আইকনটি ভরাট অবস্থায় প্রদর্শিত হবে কিনা। এর ডিফল্ট মান হলো ফলস।

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

integer

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

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

integer

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

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

object ( Icon )

startIcon এর প্রচলনের কারণে এটি অপ্রচলিত হয়ে গেছে।

object ( Icon )

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

enum ( VerticalAlignment )

ঐচ্ছিক। স্টার্ট আইকনের উল্লম্ব বিন্যাস। সেট না করা হলে, আইকনটি উল্লম্বভাবে কেন্দ্রে থাকবে।

গুগল চ্যাট অ্যাপের জন্য উপলব্ধ, কিন্তু গুগল ওয়ার্কস্পেস অ্যাড-অনের জন্য অনুপলব্ধ।

string

text উপরে যে লেখাটি দেখা যায়, তা সর্বদা সংক্ষিপ্ত হয়ে যায়।

object ( TextParagraph )

topLabel এর TextParagraph সমতুল্য। সর্বদা সংক্ষিপ্ত করে। topLabel চেয়ে আরও জটিল ফরম্যাটিংয়ের সুযোগ দেয়।

গুগল চ্যাট অ্যাপের জন্য উপলব্ধ, কিন্তু গুগল ওয়ার্কস্পেস অ্যাড-অনের জন্য অনুপলব্ধ।

string

আবশ্যক। মূল পাঠ্য।

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

object ( TextParagraph )

TextParagraph হলো text এর সমতুল্য। এটি text এর চেয়ে আরও জটিল ফরম্যাটিং-এর সুযোগ দেয়।

গুগল চ্যাট অ্যাপের জন্য উপলব্ধ, কিন্তু গুগল ওয়ার্কস্পেস অ্যাড-অনের জন্য অনুপলব্ধ।

boolean

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

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

string

যে লেখাটি text নিচে প্রদর্শিত হয়, তা সর্বদা টেক্সটকে ঘিরে রাখে।

object ( TextParagraph )

bottomLabel এর TextParagraph সমতুল্য। সর্বদা র‍্যাপ করে। bottomLabel চেয়ে আরও জটিল ফরম্যাটিংয়ের সুযোগ দেয়।

গুগল চ্যাট অ্যাপের জন্য উপলব্ধ, কিন্তু গুগল ওয়ার্কস্পেস অ্যাড-অনের জন্য অনুপলব্ধ।

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 (২৫৫/২৫৫) রঙের সর্বোচ্চ তীব্রতা বোঝায়।

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

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

বাটনের রঙের জন্য alpha ফিল্ডটি উপলব্ধ নয়। এটি নির্দিষ্ট করা হলে, ফিল্ডটি উপেক্ষা করা হয়।

object ( OnClick )

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

boolean

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

string

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

বর্ণনামূলক টেক্সট সেট করুন যা ব্যবহারকারীদের জানিয়ে দেবে বাটনটি কী কাজ করে। উদাহরণস্বরূপ, যদি কোনো বাটন একটি হাইপারলিঙ্ক খোলে, তাহলে আপনি লিখতে পারেন: "একটি নতুন ব্রাউজার ট্যাব খোলে এবং https://developers.google.com/workspace/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 )

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

গুগল চ্যাট অ্যাপ এবং গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ।

object ( Button )

বোতামের একটি সারি।

string

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

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

string

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

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

hintText নির্দিষ্ট করা না থাকলে এটি আবশ্যক। অন্যথায়, এটি ঐচ্ছিক।

string

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

label অনির্দিষ্ট থাকলে আবশ্যক। অন্যথায়, ঐচ্ছিক।

string

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

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

enum ( Type )

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

object ( Action )

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

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

object ( Suggestions )

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

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

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

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

গুগল চ্যাট অ্যাপ এবং গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ।

object ( Action )

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

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

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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ, কিন্তু গুগল চ্যাট অ্যাপগুলির জন্য অনুপলব্ধ।

object ( Validation )

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

গুগল চ্যাট অ্যাপ এবং গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য উপলব্ধ।

string

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

গুগল চ্যাট অ্যাপের জন্য উপলব্ধ, কিন্তু গুগল ওয়ার্কস্পেস অ্যাড-অনের জন্য অনুপলব্ধ।

object ( HostAppDataSourceMarkup )

A data source that's unique to a Google Workspace host application, such as Gmail emails, Google Calendar events, or Google Chat messages.

Available for Google Workspace add-ons that extend Google Workspace Studio. Unavailable for Google Chat apps.

Action

Navigation

Pushes, pops, or updates a card.

Add-ons in Google Chat .

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.

object ( ChatClientDataSourceMarkup )

A data source from Google Chat.

object ( WorkflowDataSourceMarkup )

A data source from Google Workflow.

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.

boolean

Whether to include variables from the previous step in the data source.

enum ( Type )

The type of data source.

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.

object ( DataSourceConfig )

Optional. The data source configs for the selection control. This field provides more fine-grained control over the data source.

If specified, the multiSelectMaxSelectedItems field, multiSelectMinQueryLength field, externalDataSource field and platformDataSource field are ignored.

Available for Google Workspace add-ons that extend Google Workspace Studio.

Available for the Dropdown widget in Google Chat apps. For the Dropdown widget in Google Chat apps, only one DataSourceConfig is supported. If multiple DataSourceConfig s are set, only the first one is used.

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.

string

Optional. Text that appears below the selection input field meant to assist users by prompting them to enter a certain value. This text is always visible.

Available for Google Workspace add-ons that extend Google Workspace Studio. Unavailable for Google Chat apps.

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 ( Action )

The data is from a remote data provider.

object ( PlatformDataSource )

The data is from a Google Workspace application.

integer

The minimum number of characters the user must enter before this data provider is triggered (ie, before it starts returning results).

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.

object ( HostAppDataSourceMarkup )

A data source that's unique to a Google Workspace host application, such as Gmail emails, Google Calendar events, or Google Chat messages.

Available for Google Workspace add-ons that extend Google Workspace Studio. Unavailable for Google Chat apps.

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.

string

The unique identifier of the ActionRule.

object ( Trigger )

The list of triggers that will be triggered after the EventAction is executed.

object ( CommonWidgetAction )

Common widget action.

string

The unique identifier of the ActionRule.

object ( UpdateVisibilityAction )

The action to update the visibility of a widget.

enum ( Visibility )

The new visibility.

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 .

string

The unique identifier of the ExpressionData.

string

The uncompiled expression.

object ( Condition )

The list of conditions that are determined by the expression evaluation result.

object ( EventAction )

The list of actions that the ExpressionData can be used.

string

The unique identifier of the ActionRule.

object ( ExpressionDataCondition )

The condition that is determined by the expression data.

enum ( ConditionType )

The type of the condition.