0.34.0 (latest) 0.33.0 0.32.0 0.31.0 0.30.0 0.29.0 0.28.0 0.27.0 0.26.0 0.25.0 0.24.0 0.23.0 0.22.0 0.21.0 0.20.0 0.19.0 0.18.0 0.17.0 0.16.0 0.15.0 0.14.0 0.13.0 0.12.0 0.11.1 0.10.0 0.9.1 0.8.0 0.7.0 0.6.0 0.5.1 0.4.0 0.3.1 0.2.0 0.1.2 Reference documentation and code samples for the Google Chat V1 API class Google::Apps::Card::V1::Widget.

Each card is made up of widgets.


<br />

A widget is a composite object that can represent one of text, images,
buttons, and other object types.

## Inherits

- Object

## Extended By

- Google::Protobuf::MessageExts::ClassMethods

## Includes

- Google::Protobuf::MessageExts

## Methods

### #button_list

    def button_list() -> ::Google::Apps::Card::V1::ButtonList

**Returns**

- ([::Google::Apps::Card::V1::ButtonList](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-ButtonList)) --- A list of buttons.


  For example, the following JSON creates two buttons. The first
  is a blue text button and the second is an image button that opens a
  link:
  `
  "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"
  }
  }
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`, `decorated_text`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #button_list=

    def button_list=(value) -> ::Google::Apps::Card::V1::ButtonList

**Parameter**

- **value** ([::Google::Apps::Card::V1::ButtonList](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-ButtonList)) --- A list of buttons.


  For example, the following JSON creates two buttons. The first
  is a blue text button and the second is an image button that opens a
  link:
  `
  "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"
  }
  }
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`, `decorated_text`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::ButtonList](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-ButtonList)) --- A list of buttons.


  For example, the following JSON creates two buttons. The first
  is a blue text button and the second is an image button that opens a
  link:
  `
  "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"
  }
  }
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `button_list`, `text_paragraph`, `image`, `decorated_text`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #carousel

    def carousel() -> ::Google::Apps::Card::V1::Carousel

**Returns**

- ([::Google::Apps::Card::V1::Carousel](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Carousel)) --- A carousel contains a collection of nested widgets. For example, this is a JSON representation of a carousel that contains two text paragraphs.


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

  Note: The following fields are mutually exclusive: `carousel`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #carousel=

    def carousel=(value) -> ::Google::Apps::Card::V1::Carousel

**Parameter**

- **value** ([::Google::Apps::Card::V1::Carousel](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Carousel)) --- A carousel contains a collection of nested widgets. For example, this is a JSON representation of a carousel that contains two text paragraphs.


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

  Note: The following fields are mutually exclusive: `carousel`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::Carousel](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Carousel)) --- A carousel contains a collection of nested widgets. For example, this is a JSON representation of a carousel that contains two text paragraphs.


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

  Note: The following fields are mutually exclusive: `carousel`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #chip_list

    def chip_list() -> ::Google::Apps::Card::V1::ChipList

**Returns**

- ([::Google::Apps::Card::V1::ChipList](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-ChipList)) --- A list of chips.


  For example, the following JSON creates two chips. The first
  is a text chip and the second is an icon chip that opens a
  link:
  `
  "chipList": {
  "chips": [
  {
  "text": "Edit",
  "disabled": true,
  },
  {
  "icon": {
  "knownIcon": "INVITE",
  "altText": "check calendar"
  },
  "onClick": {
  "openLink": {
  "url": "https://example.com/calendar"
  }
  }
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `chip_list`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #chip_list=

    def chip_list=(value) -> ::Google::Apps::Card::V1::ChipList

**Parameter**

- **value** ([::Google::Apps::Card::V1::ChipList](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-ChipList)) --- A list of chips.


  For example, the following JSON creates two chips. The first
  is a text chip and the second is an icon chip that opens a
  link:
  `
  "chipList": {
  "chips": [
  {
  "text": "Edit",
  "disabled": true,
  },
  {
  "icon": {
  "knownIcon": "INVITE",
  "altText": "check calendar"
  },
  "onClick": {
  "openLink": {
  "url": "https://example.com/calendar"
  }
  }
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `chip_list`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::ChipList](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-ChipList)) --- A list of chips.


  For example, the following JSON creates two chips. The first
  is a text chip and the second is an icon chip that opens a
  link:
  `
  "chipList": {
  "chips": [
  {
  "text": "Edit",
  "disabled": true,
  },
  {
  "icon": {
  "knownIcon": "INVITE",
  "altText": "check calendar"
  },
  "onClick": {
  "openLink": {
  "url": "https://example.com/calendar"
  }
  }
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `chip_list`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #columns

    def columns() -> ::Google::Apps::Card::V1::Columns

**Returns**

- ([::Google::Apps::Card::V1::Columns](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Columns)) --- Displays up to 2 columns.


  To include more than 2 columns, or to use rows, use the `Grid` widget.

  For example, the following JSON creates 2 columns that each contain
  text paragraphs:

  `
  "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"
  }
  }
  ]
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `columns`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #columns=

    def columns=(value) -> ::Google::Apps::Card::V1::Columns

**Parameter**

- **value** ([::Google::Apps::Card::V1::Columns](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Columns)) --- Displays up to 2 columns.


  To include more than 2 columns, or to use rows, use the `Grid` widget.

  For example, the following JSON creates 2 columns that each contain
  text paragraphs:

  `
  "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"
  }
  }
  ]
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `columns`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::Columns](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Columns)) --- Displays up to 2 columns.


  To include more than 2 columns, or to use rows, use the `Grid` widget.

  For example, the following JSON creates 2 columns that each contain
  text paragraphs:

  `
  "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"
  }
  }
  ]
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `columns`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #date_time_picker

    def date_time_picker() -> ::Google::Apps::Card::V1::DateTimePicker

**Returns**

- ([::Google::Apps::Card::V1::DateTimePicker](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-DateTimePicker)) --- Displays a widget that lets users input a date, time, or date and time.


  For example, the following JSON creates a date time picker to schedule an
  appointment:

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

  Note: The following fields are mutually exclusive: `date_time_picker`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #date_time_picker=

    def date_time_picker=(value) -> ::Google::Apps::Card::V1::DateTimePicker

**Parameter**

- **value** ([::Google::Apps::Card::V1::DateTimePicker](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-DateTimePicker)) --- Displays a widget that lets users input a date, time, or date and time.


  For example, the following JSON creates a date time picker to schedule an
  appointment:

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

  Note: The following fields are mutually exclusive: `date_time_picker`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::DateTimePicker](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-DateTimePicker)) --- Displays a widget that lets users input a date, time, or date and time.


  For example, the following JSON creates a date time picker to schedule an
  appointment:

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

  Note: The following fields are mutually exclusive: `date_time_picker`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #decorated_text

    def decorated_text() -> ::Google::Apps::Card::V1::DecoratedText

**Returns**

- ([::Google::Apps::Card::V1::DecoratedText](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-DecoratedText)) --- Displays a decorated text item.


  For example, the following JSON creates a decorated text widget showing
  email address:

  `
  "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"
  }
  }
  `

  Note: The following fields are mutually exclusive: `decorated_text`, `text_paragraph`, `image`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #decorated_text=

    def decorated_text=(value) -> ::Google::Apps::Card::V1::DecoratedText

**Parameter**

- **value** ([::Google::Apps::Card::V1::DecoratedText](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-DecoratedText)) --- Displays a decorated text item.


  For example, the following JSON creates a decorated text widget showing
  email address:

  `
  "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"
  }
  }
  `

  Note: The following fields are mutually exclusive: `decorated_text`, `text_paragraph`, `image`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::DecoratedText](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-DecoratedText)) --- Displays a decorated text item.


  For example, the following JSON creates a decorated text widget showing
  email address:

  `
  "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"
  }
  }
  `

  Note: The following fields are mutually exclusive: `decorated_text`, `text_paragraph`, `image`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #divider

    def divider() -> ::Google::Apps::Card::V1::Divider

**Returns**

- ([::Google::Apps::Card::V1::Divider](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Divider)) --- Displays a horizontal line divider between widgets.


  For example, the following JSON creates a divider:
  `
  "divider": {
  }
  `

  Note: The following fields are mutually exclusive: `divider`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #divider=

    def divider=(value) -> ::Google::Apps::Card::V1::Divider

**Parameter**

- **value** ([::Google::Apps::Card::V1::Divider](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Divider)) --- Displays a horizontal line divider between widgets.


  For example, the following JSON creates a divider:
  `
  "divider": {
  }
  `

  Note: The following fields are mutually exclusive: `divider`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::Divider](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Divider)) --- Displays a horizontal line divider between widgets.


  For example, the following JSON creates a divider:
  `
  "divider": {
  }
  `

  Note: The following fields are mutually exclusive: `divider`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #grid

    def grid() -> ::Google::Apps::Card::V1::Grid

**Returns**

- ([::Google::Apps::Card::V1::Grid](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Grid)) --- Displays a grid with a collection of items.


  A grid supports any number of columns and items. The number of rows is
  determined by the upper bounds of the number items divided by the number
  of columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11
  items and 2 columns has 6 rows.

  [Google Workspace add-ons and
  Chat apps](https://developers.google.com/workspace/extend):

  For example, the following JSON creates a 2 column grid with a single
  item:

  `
  "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"
  }
  }
  }
  `

  Note: The following fields are mutually exclusive: `grid`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #grid=

    def grid=(value) -> ::Google::Apps::Card::V1::Grid

**Parameter**

- **value** ([::Google::Apps::Card::V1::Grid](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Grid)) --- Displays a grid with a collection of items.


  A grid supports any number of columns and items. The number of rows is
  determined by the upper bounds of the number items divided by the number
  of columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11
  items and 2 columns has 6 rows.

  [Google Workspace add-ons and
  Chat apps](https://developers.google.com/workspace/extend):

  For example, the following JSON creates a 2 column grid with a single
  item:

  `
  "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"
  }
  }
  }
  `

  Note: The following fields are mutually exclusive: `grid`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::Grid](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Grid)) --- Displays a grid with a collection of items.


  A grid supports any number of columns and items. The number of rows is
  determined by the upper bounds of the number items divided by the number
  of columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11
  items and 2 columns has 6 rows.

  [Google Workspace add-ons and
  Chat apps](https://developers.google.com/workspace/extend):

  For example, the following JSON creates a 2 column grid with a single
  item:

  `
  "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"
  }
  }
  }
  `

  Note: The following fields are mutually exclusive: `grid`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #horizontal_alignment

    def horizontal_alignment() -> ::Google::Apps::Card::V1::Widget::HorizontalAlignment

**Returns**

- ([::Google::Apps::Card::V1::Widget::HorizontalAlignment](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Widget-HorizontalAlignment)) --- Specifies whether widgets align to the left, right, or center of a column.

### #horizontal_alignment=

    def horizontal_alignment=(value) -> ::Google::Apps::Card::V1::Widget::HorizontalAlignment

**Parameter**

- **value** ([::Google::Apps::Card::V1::Widget::HorizontalAlignment](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Widget-HorizontalAlignment)) --- Specifies whether widgets align to the left, right, or center of a column.
**Returns**

- ([::Google::Apps::Card::V1::Widget::HorizontalAlignment](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Widget-HorizontalAlignment)) --- Specifies whether widgets align to the left, right, or center of a column.

### #image

    def image() -> ::Google::Apps::Card::V1::Image

**Returns**

- ([::Google::Apps::Card::V1::Image](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Image)) --- Displays an image.


  For example, the following JSON creates an image with alternative text:
  `
  "image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
  }
  `

  Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #image=

    def image=(value) -> ::Google::Apps::Card::V1::Image

**Parameter**

- **value** ([::Google::Apps::Card::V1::Image](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Image)) --- Displays an image.


  For example, the following JSON creates an image with alternative text:
  `
  "image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
  }
  `

  Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::Image](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-Image)) --- Displays an image.


  For example, the following JSON creates an image with alternative text:
  `
  "image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
  }
  `

  Note: The following fields are mutually exclusive: `image`, `text_paragraph`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #selection_input

    def selection_input() -> ::Google::Apps::Card::V1::SelectionInput

**Returns**

- ([::Google::Apps::Card::V1::SelectionInput](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-SelectionInput)) --- Displays a selection control that lets users select items. Selection controls can be checkboxes, radio buttons, switches, or dropdown menus.


  For example, the following JSON creates a dropdown menu that lets users
  choose a size:

  `
  "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
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `selection_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #selection_input=

    def selection_input=(value) -> ::Google::Apps::Card::V1::SelectionInput

**Parameter**

- **value** ([::Google::Apps::Card::V1::SelectionInput](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-SelectionInput)) --- Displays a selection control that lets users select items. Selection controls can be checkboxes, radio buttons, switches, or dropdown menus.


  For example, the following JSON creates a dropdown menu that lets users
  choose a size:

  `
  "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
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `selection_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::SelectionInput](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-SelectionInput)) --- Displays a selection control that lets users select items. Selection controls can be checkboxes, radio buttons, switches, or dropdown menus.


  For example, the following JSON creates a dropdown menu that lets users
  choose a size:

  `
  "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
  }
  ]
  }
  `

  Note: The following fields are mutually exclusive: `selection_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #text_input

    def text_input() -> ::Google::Apps::Card::V1::TextInput

**Returns**

- ([::Google::Apps::Card::V1::TextInput](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-TextInput)) --- Displays a text box that users can type into.


  For example, the following JSON creates a text input for an email
  address:

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

  As another example, the following JSON creates a text input for a
  programming language with static suggestions:
  `
  "textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
  "items": [
  {
  "text": "C++"
  },
  {
  "text": "Java"
  },
  {
  "text": "JavaScript"
  },
  {
  "text": "Python"
  }
  ]
  }
  }
  `

  Note: The following fields are mutually exclusive: `text_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #text_input=

    def text_input=(value) -> ::Google::Apps::Card::V1::TextInput

**Parameter**

- **value** ([::Google::Apps::Card::V1::TextInput](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-TextInput)) --- Displays a text box that users can type into.


  For example, the following JSON creates a text input for an email
  address:

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

  As another example, the following JSON creates a text input for a
  programming language with static suggestions:
  `
  "textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
  "items": [
  {
  "text": "C++"
  },
  {
  "text": "Java"
  },
  {
  "text": "JavaScript"
  },
  {
  "text": "Python"
  }
  ]
  }
  }
  `

  Note: The following fields are mutually exclusive: `text_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::TextInput](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-TextInput)) --- Displays a text box that users can type into.


  For example, the following JSON creates a text input for an email
  address:

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

  As another example, the following JSON creates a text input for a
  programming language with static suggestions:
  `
  "textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
  "items": [
  {
  "text": "C++"
  },
  {
  "text": "Java"
  },
  {
  "text": "JavaScript"
  },
  {
  "text": "Python"
  }
  ]
  }
  }
  `

  Note: The following fields are mutually exclusive: `text_input`, `text_paragraph`, `image`, `decorated_text`, `button_list`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #text_paragraph

    def text_paragraph() -> ::Google::Apps::Card::V1::TextParagraph

**Returns**

- ([::Google::Apps::Card::V1::TextParagraph](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-TextParagraph)) --- Displays a text paragraph. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat
  apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting
  text in Google Workspace
  add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).


  For example, the following JSON creates a bolded text:
  `
  "textParagraph": {
  "text": " <b>bold text</b>"
  }
  `

  Note: The following fields are mutually exclusive: `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.

### #text_paragraph=

    def text_paragraph=(value) -> ::Google::Apps::Card::V1::TextParagraph

**Parameter**

- **value** ([::Google::Apps::Card::V1::TextParagraph](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-TextParagraph)) --- Displays a text paragraph. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat
  apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting
  text in Google Workspace
  add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).


  For example, the following JSON creates a bolded text:
  `
  "textParagraph": {
  "text": " <b>bold text</b>"
  }
  `

  Note: The following fields are mutually exclusive: `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.
**Returns**

- ([::Google::Apps::Card::V1::TextParagraph](https://docs.cloud.google.com/ruby/docs/reference/google-apps-chat-v1/latest/Google-Apps-Card-V1-TextParagraph)) --- Displays a text paragraph. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat
  apps](https://developers.google.com/workspace/chat/format-messages#card-formatting) and [Formatting
  text in Google Workspace
  add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).


  For example, the following JSON creates a bolded text:
  `
  "textParagraph": {
  "text": " <b>bold text</b>"
  }
  `

  Note: The following fields are mutually exclusive: `text_paragraph`, `image`, `decorated_text`, `button_list`, `text_input`, `selection_input`, `date_time_picker`, `divider`, `grid`, `columns`, `carousel`, `chip_list`. If a field in that set is populated, all other fields in the set will automatically be cleared.