# EventHandler

- [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#SCHEMA_REPRESENTATION)
- [StaticPrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPrompt.SCHEMA_REPRESENTATION)
- [StaticPromptCandidate](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPromptCandidate)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPromptCandidate.SCHEMA_REPRESENTATION)
- [Selector](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Selector)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Selector.SCHEMA_REPRESENTATION)
- [SurfaceCapabilities](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#SurfaceCapabilities)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#SurfaceCapabilities.SCHEMA_REPRESENTATION)
- [StaticPromptResponse](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPromptResponse)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPromptResponse.SCHEMA_REPRESENTATION)
- [StaticSimplePrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticSimplePrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticSimplePrompt.SCHEMA_REPRESENTATION)
- [Variant](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Variant)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Variant.SCHEMA_REPRESENTATION)
- [StaticContentPrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticContentPrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticContentPrompt.SCHEMA_REPRESENTATION)
- [StaticCardPrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCardPrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCardPrompt.SCHEMA_REPRESENTATION)
- [StaticImagePrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt.SCHEMA_REPRESENTATION)
- [StaticLinkPrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticLinkPrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticLinkPrompt.SCHEMA_REPRESENTATION)
- [OpenUrl](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#OpenUrl)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#OpenUrl.SCHEMA_REPRESENTATION)
- [StaticTablePrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticTablePrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticTablePrompt.SCHEMA_REPRESENTATION)
- [TableColumn](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableColumn)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableColumn.SCHEMA_REPRESENTATION)
- [TableRow](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableRow)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableRow.SCHEMA_REPRESENTATION)
- [TableCell](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableCell)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableCell.SCHEMA_REPRESENTATION)
- [StaticMediaPrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticMediaPrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticMediaPrompt.SCHEMA_REPRESENTATION)
- [MediaObject](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#MediaObject)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#MediaObject.SCHEMA_REPRESENTATION)
- [MediaImage](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#MediaImage)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#MediaImage.SCHEMA_REPRESENTATION)
- [StaticListPrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticListPrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticListPrompt.SCHEMA_REPRESENTATION)
- [ListItem](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#ListItem)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#ListItem.SCHEMA_REPRESENTATION)
- [StaticCollectionPrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCollectionPrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCollectionPrompt.SCHEMA_REPRESENTATION)
- [CollectionItem](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#CollectionItem)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#CollectionItem.SCHEMA_REPRESENTATION)
- [StaticCollectionBrowsePrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCollectionBrowsePrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCollectionBrowsePrompt.SCHEMA_REPRESENTATION)
- [CollectionBrowseItem](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#CollectionBrowseItem)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#CollectionBrowseItem.SCHEMA_REPRESENTATION)
- [Suggestion](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Suggestion)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Suggestion.SCHEMA_REPRESENTATION)
- [StaticCanvasPrompt](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCanvasPrompt)
  - [YAML representation](https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCanvasPrompt.SCHEMA_REPRESENTATION)

Defines a handler to be executed after an event. Examples of events are intent and condition based events in a scene.

| YAML representation ||
|---|---|
| ``` webhookHandler: string # Union field `prompt` can be only one of the following: staticPrompt: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPrompt`) staticPromptName: string # End of list of possible types for union field `prompt`. ``` |

| Fields ||
|---|---|---|
| `webhookHandler` | `string` Name of the webhook handler to call. |
| Union field `prompt`. Prompts can either be inlined or referenced by name. `prompt` can be only one of the following: |||
| `staticPrompt` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPrompt`)`` Inlined static prompt. Can contain references to string resources in bundles. |
| `staticPromptName` | `string` Name of the static prompt to invoke. |

## StaticPrompt

Represents a list of prompt candidates, one of which will be selected as the prompt to be shown in the response to the user. **This message is localizable.**

| YAML representation ||
|---|---|
| ``` candidates: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPromptCandidate`) ``` |

| Fields ||
|---|---|
| `candidates[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPromptCandidate`)`` The list of candidate prompts to be sent to the client. Each prompt has a selector to determine when it can be used. The first selector that matches a request will be sent and the rest will be ignored. |

## StaticPromptCandidate

Represents a static prompt candidate.

| YAML representation ||
|---|---|
| ``` selector: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Selector`) promptResponse: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPromptResponse`) ``` |

| Fields ||
|---|---|
| `selector` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Selector`)`` Optional. The criteria for whether this prompt matches a request. If the selector is empty, this prompt will always be triggered. |
| `promptResponse` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticPromptResponse`)`` The prompt response associated with the selector. |

## Selector

Defines the criteria for whether a prompt matches a request.

| YAML representation ||
|---|---|
| ``` surfaceCapabilities: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#SurfaceCapabilities`) ``` |

| Fields ||
|---|---|
| `surfaceCapabilities` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#SurfaceCapabilities`)`` The set of required surface capabilities. |

## SurfaceCapabilities

Represents the surface the user is using to make a request to the Action.

| YAML representation ||
|---|---|
| ``` capabilities: - enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/Capability`) ``` |

| Fields ||
|---|---|
| `capabilities[]` | ``enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/Capability`)`` Required. The capabilities of the surface making a request to the Action. |

## StaticPromptResponse

Represents structured responses to send to the user, such as text, speech, cards, canvas data, suggestion chips, etc.

| YAML representation ||
|---|---|
| ``` firstSimple: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticSimplePrompt`) content: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticContentPrompt`) lastSimple: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticSimplePrompt`) suggestions: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Suggestion`) link: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticLinkPrompt`) override: boolean canvas: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCanvasPrompt`) ``` |

| Fields ||
|---|---|
| `firstSimple` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticSimplePrompt`)`` Optional. The first voice and text-only response. |
| `content` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticContentPrompt`)`` Optional. A content like a card, list or media to display to the user. |
| `lastSimple` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticSimplePrompt`)`` Optional. The last voice and text-only response. |
| `suggestions[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Suggestion`)`` Optional. Suggestions to be displayed to the user which will always appear at the end of the response. If the `append` field in the containing prompt is `true` the titles defined in this field will be added to titles defined in any previously defined suggestions prompts and duplicate values will be removed. |
| `link` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticLinkPrompt`)`` Optional. An additional suggestion chip that can link out to the associated app or site. The chip will be rendered with the title "Open ". Max 20 chars. |
| `override` | `boolean` Optional. Mode for how this messages should be merged with previously defined messages. `true` will clear all previously defined messages (first and last simple, content, suggestions link and canvas) and add messages defined in this prompt. `false` will add messages defined in this prompt to messages defined in previous responses. Setting this field to `false` will also enable appending to some fields inside Simple prompts, the Suggestions prompt and the Canvas prompt (part of the Content prompt). The Content and Link messages will always be overwritten if defined in the prompt. Default value is `false`. |
| `canvas` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCanvasPrompt`)`` A response to be used for interactive canvas experience. |

## StaticSimplePrompt

Represents a simple prompt to be send to a user.

| YAML representation ||
|---|---|
| ``` variants: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Variant`) ``` |

| Fields ||
|---|---|
| `variants[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#Variant`)`` List of possible variants. |

## Variant

Represents a variant which is part of the simple prompt.

| YAML representation ||
|---|---|
| ``` speech: string text: string ``` |

| Fields ||
|---|---|
| `speech` | `string` Optional. Represents the speech to be spoken to the user. Can be SSML or text to speech. By default, speech will be appended to previous Simple prompt's speech. If the `override` field in the containing prompt is `true` the speech defined in this field will override previous Simple prompt's speech. |
| `text` | `string` Optional. Text to display in the chat bubble. If not given, a display rendering of the speech field above will be used. Limited to 640 chars. By default, text will be appended to previous Simple prompt's text. If the `override` field in the containing prompt is `true` the text defined in this field will override previous Simple prompt's text. |

## StaticContentPrompt

A placeholder for the Content part of a StaticPrompt.

| YAML representation ||
|---|---|
| ``` # Union field `content` can be only one of the following: card: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCardPrompt`) image: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`) table: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticTablePrompt`) media: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticMediaPrompt`) list: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticListPrompt`) collection: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCollectionPrompt`) collectionBrowse: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCollectionBrowsePrompt`) # End of list of possible types for union field `content`. ``` |

| Fields ||
|---|---|---|
| Union field `content`. Only one type of content can be present in a Prompt. `content` can be only one of the following: |||
| `card` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCardPrompt`)`` A basic card. |
| `image` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`)`` An image. |
| `table` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticTablePrompt`)`` Table card. |
| `media` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticMediaPrompt`)`` Response indicating a set of media to be played. |
| `list` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticListPrompt`)`` A card for presenting a list of options to select from. |
| `collection` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCollectionPrompt`)`` A card presenting a list of options to select from. |
| `collectionBrowse` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticCollectionBrowsePrompt`)`` A card presenting a collection of web pages to open. |

## StaticCardPrompt

A basic card for displaying some information, e.g. an image and/or text.

| YAML representation ||
|---|---|
| ``` title: string subtitle: string text: string image: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`) imageFill: enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/ImageFill`) button: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticLinkPrompt`) ``` |

| Fields ||
|---|---|
| `title` | `string` Optional. Overall title of the card. |
| `subtitle` | `string` Optional. Subtitle of the card. |
| `text` | `string` Required. Body text of the card which is needed unless image is present. Supports a limited set of markdown syntax for formatting. |
| `image` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`)`` Optional. A hero image for the card. The height is fixed to 192dp. |
| `imageFill` | ``enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/ImageFill`)`` Optional. How the image background will be filled. |
| `button` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticLinkPrompt`)`` Optional. A clickable button to be shown in the Card. |

## StaticImagePrompt

An image displayed in the card.

| YAML representation ||
|---|---|
| ``` url: string alt: string height: integer width: integer ``` |

| Fields ||
|---|---|
| `url` | `string` Required. The source url of the image. Images can be JPG, PNG and GIF (animated and non-animated). For example,`https://www.agentx.com/logo.png`. |
| `alt` | `string` Required. A text description of the image to be used for accessibility, e.g. screen readers. |
| `height` | `integer` Optional. The height of the image in pixels. |
| `width` | `integer` Optional. The width of the image in pixels. |

## StaticLinkPrompt

Defines a link which will be displayed as a suggestion chip and can be opened by the user.

| YAML representation ||
|---|---|
| ``` name: string open: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#OpenUrl`) ``` |

| Fields ||
|---|---|
| `name` | `string` Name of the link |
| `open` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#OpenUrl`)`` Defines behavior when the user opens the link. |

## OpenUrl

Defines behavior when the user opens the link.

| YAML representation ||
|---|---|
| ``` url: string hint: enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/UrlHint`) ``` |

| Fields ||
|---|---|
| `url` | `string` The url field which could be any of: - http/https urls for opening an App-linked App or a webpage |
| `hint` | ``enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/UrlHint`)`` Indicates a hint for the url type. |

## StaticTablePrompt

A table card for displaying a table of text.

| YAML representation ||
|---|---|
| ``` title: string subtitle: string image: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`) columns: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableColumn`) rows: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableRow`) button: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticLinkPrompt`) ``` |

| Fields ||
|---|---|
| `title` | `string` Optional. Overall title of the table. Must be set if subtitle is set. |
| `subtitle` | `string` Optional. Subtitle for the table. |
| `image` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`)`` Optional. Image associated with the table. |
| `columns[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableColumn`)`` Optional. Headers and alignment of columns. |
| `rows[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableRow`)`` Optional. Row data of the table. The first 3 rows are guaranteed to be shown but others might be cut on certain surfaces. Please test with the simulator to see which rows will be shown for a given surface. On surfaces that support the `WEB_BROWSER` capability, you can point the user to a web page with more data. |
| `button` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticLinkPrompt`)`` Optional. Button. |

## TableColumn

Describes a column in the table.

| YAML representation ||
|---|---|
| ``` header: string align: enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/HorizontalAlignment`) ``` |

| Fields ||
|---|---|
| `header` | `string` Header text for the column. |
| `align` | ``enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/HorizontalAlignment`)`` Horizontal alignment of content w.r.t column. If unspecified, content will be aligned to the leading edge. |

## TableRow

Describes a row in the table.

| YAML representation ||
|---|---|
| ``` cells: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableCell`) divider: boolean ``` |

| Fields ||
|---|---|
| `cells[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#TableCell`)`` Cells in this row. The first 3 cells are guaranteed to be shown but others might be cut on certain surfaces. Please test with the simulator to see which cells will be shown for a given surface. |
| `divider` | `boolean` Indicates whether there should be a divider after each row. |

## TableCell

Describes a cell in a row.

| YAML representation ||
|---|---|
| ``` text: string ``` |

| Fields ||
|---|---|
| `text` | `string` Text content of the cell. |

## StaticMediaPrompt

Contains information about the media, such as name, description, url, etc. Next id: 11

| YAML representation ||
|---|---|
| ``` mediaType: enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/MediaType`) startOffset: string optionalMediaControls: - enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/OptionalMediaControls`) mediaObjects: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#MediaObject`) repeatMode: enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/RepeatMode`) ``` |

| Fields ||
|---|---|
| `mediaType` | ``enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/MediaType`)`` Media type of this response. |
| `startOffset` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration` format)`` Start offset of the first media object. A duration in seconds with up to nine fractional digits, terminated by '`s`'. Example: `"3.5s"`. |
| `optionalMediaControls[]` | ``enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/OptionalMediaControls`)`` Optional media control types this media response session can support. If set, request will be made to 3p when a certain media event happens. If not set, 3p must still handle two default control type, FINISHED and FAILED. |
| `mediaObjects[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#MediaObject`)`` List of media objects. |
| `repeatMode` | ``enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/RepeatMode`)`` Repeat mode for the list of Media Objects. |

## MediaObject

Represents a single media object.

| YAML representation ||
|---|---|
| ``` name: string description: string url: string image: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#MediaImage`) ``` |

| Fields ||
|---|---|
| `name` | `string` Name of this media object. |
| `description` | `string` Description of this media object. |
| `url` | `string` The url pointing to the media content. |
| `image` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#MediaImage`)`` Image to show with the media card. |

## MediaImage

Image to be shown inside a MediaPrompt.

| YAML representation ||
|---|---|
| ``` # Union field `image` can be only one of the following: large: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`) icon: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`) # End of list of possible types for union field `image`. ``` |

| Fields ||
|---|---|---|
| Union field `image`. Only one type of MediaImage is allowed. `image` can be only one of the following: |||
| `large` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`)`` A large image, such as the cover of the album, etc. |
| `icon` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`)`` A small image icon displayed on the right from the title. It's resized to 36x36 dp. |

## StaticListPrompt

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

| YAML representation ||
|---|---|
| ``` title: string subtitle: string items: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#ListItem`) ``` |

| Fields ||
|---|---|
| `title` | `string` Optional. Title of the list. |
| `subtitle` | `string` Optional. Subtitle of the list. |
| `items[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#ListItem`)`` Required. List items. |

## ListItem

An item in the list.

| YAML representation ||
|---|---|
| ``` key: string title: string description: string image: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`) ``` |

| Fields ||
|---|---|
| `key` | `string` Required. The NLU key that matches the entry key name in the associated type. When item tapped, this key will be posted back as a select option parameter. |
| `title` | `string` Required. Title of the 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 items. |
| `description` | `string` Optional. Body text of the item. |
| `image` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`)`` Optional. Item image. |

## StaticCollectionPrompt

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

| YAML representation ||
|---|---|
| ``` title: string subtitle: string items: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#CollectionItem`) imageFill: enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/ImageFill`) ``` |

| Fields ||
|---|---|
| `title` | `string` Optional. Title of the collection. |
| `subtitle` | `string` Optional. Subtitle of the collection. |
| `items[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#CollectionItem`)`` Required. Collection items. |
| `imageFill` | ``enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/ImageFill`)`` Optional. Type of image display option. |

## CollectionItem

An item in the collection.

| YAML representation ||
|---|---|
| ``` key: string title: string description: string image: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`) ``` |

| Fields ||
|---|---|
| `key` | `string` Required. The NLU key that matches the entry key name in the associated Type. When item tapped, this key will be posted back as a select option parameter. |
| `title` | `string` Required. Title of the 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 items. |
| `description` | `string` Optional. Body text of the item. |
| `image` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`)`` Optional. Item image. |

## StaticCollectionBrowsePrompt

Presents a set of web documents as a collection of large-tile items. Items may be selected to launch their associated web document in a web viewer.

| YAML representation ||
|---|---|
| ``` items: - object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#CollectionBrowseItem`) imageFill: enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/ImageFill`) ``` |

| Fields ||
|---|---|
| `items[]` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#CollectionBrowseItem`)`` Items in the browse collection. The list size should be in the range \[2, 10\]. |
| `imageFill` | ``enum (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/ImageFill`)`` Image display option for images in the collection. |

## CollectionBrowseItem

Item in the collection.

| YAML representation ||
|---|---|
| ``` title: string description: string footer: string image: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`) openUriAction: object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#OpenUrl`) ``` |

| Fields ||
|---|---|
| `title` | `string` Required. Title of the collection item. |
| `description` | `string` Description of the collection item. |
| `footer` | `string` Footer text for the collection item, displayed below the description. Single line of text, truncated with an ellipsis. |
| `image` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#StaticImagePrompt`)`` Image for the collection item. |
| `openUriAction` | ``object (`https://developers.google.com/assistant/actionssdk/reference/rest/Shared.Types/EventHandler#OpenUrl`)`` Required. URI to open if the item selected. |

## Suggestion

Represents a suggestion chip, a UI element shown to the user for convenience.

| YAML representation ||
|---|---|
| ``` title: string ``` |

| Fields ||
|---|---|
| `title` | `string` Required. The text shown in the suggestion chip. 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 suggestion chips. Max 25 chars |

## StaticCanvasPrompt

Represents a Interactive Canvas response to be sent to the user. This can be used in conjunction with the `firstSimple` field in the containing prompt to speak to the user in addition to displaying a interactive canvas response.

| YAML representation ||
|---|---|
| ``` url: string data: - value suppressMic: boolean sendStateDataToCanvasApp: boolean enableFullScreen: boolean continueTtsDuringTouch: boolean ``` |

| Fields ||
|---|---|
| `url` | `string` Required. URL of the web view to load. |
| `data[]` | ``value (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Value` format)`` Optional. JSON data to be passed through to the immersive experience web page as an event. If the `override` field in the containing prompt is `false` data values defined in this Canvas prompt will be added after data values defined in previous Canvas prompts. |
| `suppressMic` | `boolean` Optional. A true value means that the mic won't be opened for capturing input after this immersive response is presented to the user. |
| `sendStateDataToCanvasApp` | `boolean` Optional. If `true`, conversation related metadata is included and send back to the canvas application. |
| `enableFullScreen` | `boolean` Optional. If `true` the canvas application occupies the full screen and won't have a header at the top. A toast message will also be displayed on the loading screen that includes the Action's display name, the developer's name, and instructions for exiting the Action. Default value: `false`. |
| `continueTtsDuringTouch` | `boolean` Optional. If true, screen taps will not stop TTS for the entire canvas session. Default value: false. |