# OptionValueSpec

- [JSON representation](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#SCHEMA_REPRESENTATION)
- [SimpleSelect](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#SimpleSelect)
  - [JSON representation](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#SimpleSelect.SCHEMA_REPRESENTATION)
- [Item](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#Item)
  - [JSON representation](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#Item.SCHEMA_REPRESENTATION)
- [ListSelect](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#ListSelect)
  - [JSON representation](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#ListSelect.SCHEMA_REPRESENTATION)
- [ListItem](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#ListItem)
  - [JSON representation](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#ListItem.SCHEMA_REPRESENTATION)
- [CarouselSelect](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CarouselSelect)
  - [JSON representation](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CarouselSelect.SCHEMA_REPRESENTATION)
- [CarouselItem](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CarouselItem)
  - [JSON representation](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CarouselItem.SCHEMA_REPRESENTATION)
- [CollectionSelect](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CollectionSelect)
  - [JSON representation](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CollectionSelect.SCHEMA_REPRESENTATION)
- [CollectionItem](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CollectionItem)
  - [JSON representation](https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CollectionItem.SCHEMA_REPRESENTATION)

Ask the user to select one of the options.

| JSON representation ||
|---|---|
| ``` { // Union field `select` can be only one of the following: "simpleSelect": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#SimpleSelect`) }, "listSelect": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#ListSelect`) }, "carouselSelect": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CarouselSelect`) }, "collectionSelect": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CollectionSelect`) } // End of list of possible types for union field `select`. } ``` |

| Fields ||
|---|---|---|
| Union field `select`. The type of selector presented to the user `select` can be only one of the following: |||
| `simpleSelect` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#SimpleSelect`)`` A simple select with no associated GUI |
| `listSelect` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#ListSelect`)`` A select with a list card GUI |
| `carouselSelect (deprecated)` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CarouselSelect`)`` > [!WARNING] > This item is deprecated! A select with a card carousel GUI, use collectionSelect instead. |
| `collectionSelect` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CollectionSelect`)`` A select with a card collection GUI |

## SimpleSelect

A simple select with no associated GUI. Please update assistant.logs.actions.SimpleSelect to reflect any changes made.

| JSON representation ||
|---|---|
| ``` { "items": [ { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#Item`) } ] } ``` |

| Fields ||
|---|---|
| `items[]` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#Item`)`` List of items users should select from. |

## Item

Item for selection.

| JSON representation ||
|---|---|
| ``` { "optionInfo": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo`) }, "title": string } ``` |

| Fields ||
|---|---|
| `optionInfo` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo`)`` Item key and synonyms. |
| `title` | `string` title of the item. It will act as synonym if it's provided. Optional |

## ListSelect

A card for presenting a list of options to select from.

| JSON representation ||
|---|---|
| ``` { "title": string, "subtitle": string, "items": [ { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#ListItem`) } ] } ``` |

| Fields ||
|---|---|
| `title` | `string` Overall title of the list. Optional. |
| `subtitle` | `string` Subtitle of the list. Optional. |
| `items[]` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#ListItem`)`` min: 2 max: 30 |

## ListItem

An item in the list.

| JSON representation ||
|---|---|
| ``` { "optionInfo": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo`) }, "title": string, "description": string, "image": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/Image`) } } ``` |

| Fields ||
|---|---|
| `optionInfo` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo`)`` Information about this option. See `https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo` for details. Required. |
| `title` | `string` title of the list item. When tapped, this text will be posted back to the conversation verbatim as if the user had typed it. Each title must be unique among the set of list items. Required. |
| `description` | `string` Main text describing the item. Optional. |
| `image` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/Image`)`` Square image. Optional. |

## CarouselSelect

A card for presenting a carousel of options to select from.

| JSON representation ||
|---|---|
| ``` { "title": string, "subtitle": string, "items": [ { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CarouselItem`) } ], "imageDisplayOptions": enum (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/ImageDisplayOptions`) } ``` |

| Fields ||
|---|---|
| `title` | `string` title of the carousel. Optional. |
| `subtitle` | `string` Subtitle of the carousel. Optional. |
| `items[]` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CarouselItem`)`` min: 2 max: 10 |
| `imageDisplayOptions` | ``enum (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/ImageDisplayOptions`)`` type of image display option. Optional. |

## CarouselItem

An item in the carousel

| JSON representation ||
|---|---|
| ``` { "optionInfo": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo`) }, "title": string, "description": string, "image": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/Image`) } } ``` |

| Fields ||
|---|---|
| `optionInfo` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo`)`` See `https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo` for details. Required. |
| `title` | `string` title of the carousel item. When tapped, this text will be posted back to the conversation verbatim as if the user had typed it. Each title must be unique among the set of carousel items. Required. |
| `description` | `string` Body text of the card. |
| `image` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/Image`)`` Optional. |

## CollectionSelect

A card for presenting a collection of options to select from.

| JSON representation ||
|---|---|
| ``` { "title": string, "subtitle": string, "items": [ { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CollectionItem`) } ], "imageDisplayOptions": enum (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/ImageDisplayOptions`) } ``` |

| Fields ||
|---|---|
| `title` | `string` title of the collection. Optional. |
| `subtitle` | `string` Subtitle of the collection. Optional. |
| `items[]` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionValueSpec#CollectionItem`)`` min: 2 max: 10 |
| `imageDisplayOptions` | ``enum (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/ImageDisplayOptions`)`` type of image display option. Optional. |

## CollectionItem

An item in the collection

| JSON representation ||
|---|---|
| ``` { "optionInfo": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo`) }, "title": string, "description": string, "image": { object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/Image`) } } ``` |

| Fields ||
|---|---|
| `optionInfo` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo`)`` See `https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/OptionInfo` for details. Required. |
| `title` | `string` title of the collection item. When tapped, this text will be posted back to the conversation verbatim as if the user had typed it. Each title must be unique among the set of collection items. Required. |
| `description` | `string` Body text of the card. |
| `image` | ``object (`https://developers.google.com/assistant/df-asdk/reference/webhook/rest/Shared.Types/Image`)`` Optional. |