{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Google Workspace Add-ons Endpoint Interface Schemas",
  "description": "JSON Schema definitions for Google Workspace Add-ons and Chat apps Endpoint Interface payloads (EventObject and HandleEventResponse).",
  "definitions": {
    "GoogleAppsAddonsV1EventObject": {
      "description": "A Google add-on interaction event that contains data about a user's\ninteraction with an add-on within a host app.\n\nThe event object is passed as JSON to an add-on's [callback\nfunction](https://developers.google.com/workspace/add-ons/concepts/actions#callback_functions)\nor\n[trigger](https://developers.google.com/workspace/add-ons/concepts/workspace-triggers)\n(for AppsScript), or [`https`\nendpoint](https://developers.google.com/workspace/add-ons/guides/alternate-runtimes)\n(for HTTP), when a user interacts with an add-on within a host app. The event\nobject stores a host app event object defined by each host app, as well as a\ncommon event object containing some common fields related to the event.\n\nFor more information see [Event\nobjects](https://developers.google.com/workspace/add-ons/concepts/event-objects).",
      "type": "object",
      "properties": {
        "commonEventObject": {
          "description": "An object containing information common to all event objects, regardless of\nthe host application.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1EventObjectCommonEventObject"
            }
          ]
        },
        "authorizationEventObject": {
          "description": "Only set for requests to HTTP endpoints",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1EventObjectAuthorizationEventObject"
            }
          ]
        },
        "calendar": {
          "description": "**Only present if the calling host is Google Calendar.** An object\ncontaining calendar and event information.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1CalendarCalendarEventObject"
            }
          ]
        },
        "drive": {
          "description": "**Only present if the calling host is Google Drive.** An object\ncontaining Drive information.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1DriveDriveEventObject"
            }
          ]
        },
        "gmail": {
          "description": "**Only present if the calling host is Gmail.** An object containing Gmail\ninformation.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1GmailGmailEventObject"
            }
          ]
        },
        "sheets": {
          "description": "**Only present if the calling host is Google Sheets.** An object\ncontaining Sheets information.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1SheetsSheetsEventObject"
            }
          ]
        },
        "slides": {
          "description": "**Only present if the calling host is Google Slides.** An object\ncontaining Slides information.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1SlidesSlidesEventObject"
            }
          ]
        },
        "docs": {
          "description": "**Only present if the calling host is Google Docs.** An object containing\nDocs information.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1DocsDocsEventObject"
            }
          ]
        },
        "chat": {
          "description": "**Only present if the calling host is Google Chat.** An object containing\nChat information.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatChatEventObject"
            }
          ]
        },
        "workflow": {
          "description": "**Only present if the calling host is Google Workspace Studio.** An\nobject containing workflow information.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObject"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1EventObjectCommonEventObject": {
      "description": "The common event object is the portion of the overall event object that\ncarries general, host-independent information to the add-on from the user's\nclient. This information includes details such as the user's locale, host\napp, and platform.\n\nIn addition to homepage and contextual triggers, add-ons construct and pass\nevent objects to [action callback\nfunctions](https://developers.google.com/workspace/add-ons/concepts/actions#callback_functions)\nwhen the user interacts with widgets. Your add-on's callback function can\nquery the common event object to determine the contents of open widgets in\nthe user's client. For example, your add-on can locate the text a user has\nentered into a\n[TextInput](https://developers.google.com/apps-script/reference/card-service/text-input)\nwidget in the `eventObject.commentEventObject.formInputs` object.\n\nFor Chat apps, the name of the function that the user invoked when\ninteracting with a widget.",
      "type": "object",
      "properties": {
        "userLocale": {
          "description": "**Disabled by default.** The user's language and country/region\nidentifier in the format of [ISO\n639](https://wikipedia.org/wiki/ISO_639_macrolanguage) language code-[ISO\n3166](https://wikipedia.org/wiki/ISO_3166) country/region code. For\nexample, `en-US`.\n\nTo turn on this field, you must set `addOns.common.useLocaleFromApp` to\n`true` in your add-on's manifest. Your add-on's scope list must also\ninclude `https://www.googleapis.com/auth/script.locale`. See [Accessing\nuser locale and\ntimezone](https://developers.google.com/workspace/add-ons/how-tos/access-user-locale)\nfor more details.",
          "type": "string"
        },
        "hostApp": {
          "description": "Indicates the host app the add-on is active in when the event object is\ngenerated. Possible values include the following:\n\n* `GMAIL`\n* `CALENDAR`\n* `DRIVE`\n* `DOCS`\n* `SHEETS`\n* `SLIDES`\n* `CHAT`",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1HostApp"
            }
          ]
        },
        "platform": {
          "description": "The platform enum which indicates the platform where the event originates\n(`WEB`, `IOS`, or `ANDROID`). Not supported by Chat apps.",
          "type": "string",
          "x-google-enum-descriptions": [
            "",
            "",
            "",
            ""
          ],
          "enum": [
            "UNKNOWN_PLATFORM",
            "WEB",
            "IOS",
            "ANDROID"
          ]
        },
        "timeZone": {
          "description": "**Disabled by default.** The timezone ID and offset from Coordinated\nUniversal Time (UTC). To turn on this field, you must set\n`addOns.common.useLocaleFromApp` to `true` in your add-on's manifest.\nYour add-on's scope list must also include\n`https://www.googleapis.com/auth/script.locale`. See [Accessing user\nlocale and\ntimezone](https://developers.google.com/workspace/add-ons/how-tos/access-user-locale)\nfor more details.\n\nOnly supported for the event types\n[`CARD_CLICKED`](https://developers.google.com/chat/api/reference/rest/v1/EventType#ENUM_VALUES.CARD_CLICKED)\nand\n[`SUBMIT_DIALOG`](https://developers.google.com/chat/api/reference/rest/v1/DialogEventType#ENUM_VALUES.SUBMIT_DIALOG).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1EventObjectCommonEventObjectTimeZone"
            }
          ]
        },
        "formInputs": {
          "description": "A map containing the current values of the widgets in the displayed card.\nThe map keys are the string `name` values assigned to each input widget\n(such as `TextInput.name`, `SelectionInput.name`, `DateTimePicker.name`,\nor `DecoratedText.SwitchControl.name`).\n\nThe structure of the map value object is dependent on the widget type:\n\n**Note**: The following examples are formatted for Apps Script's V8\nruntime. If you're using Rhino runtime, you must add `[\"\"]` after the\nvalue. For example, instead of\n`e.commonEventObject.formInputs.employeeName.stringInputs.value[0]`,\nformat the event object as\n`e.commonEventObject.formInputs.employeeName[\"\"].stringInputs.value[0]`.\nTo learn more about runtimes in Apps Script, see the [V8 Runtime\nOverview](https://developers.google.com/apps-script/guides/v8-runtime).\n\n* Single-valued widgets (for example, a `TextInput` widget, or a\n`SelectionInput` widget of type `DROPDOWN` or `RADIO_BUTTON`): a\n`StringInputs` object containing a single-element list (or an empty list\nif no selection is made).\n\n**Example**: for a text input widget with `employeeName` as its `name`,\naccess the text input value with:\n`e.commonEventObject.formInputs.employeeName.stringInputs.value[0]`.\n\n* Multi-valued widgets (for example, a `SelectionInput` widget of type\n`CHECK_BOX`, `SWITCH`, or `MULTI_SELECT`): a `StringInputs` object\ncontaining the list of selected item `value` strings.\n\n**Example**: for a multi-value widget with `participants` as its `name`,\naccess the value array with:\n`e.commonEventObject.formInputs.participants.stringInputs.value`.\n\n* **A `DecoratedText.SwitchControl` widget**: a `StringInputs` object.\nWhen `selected` is `true`, `stringInputs.value` contains the switch's\n`value` field (or `\"\"` if `value` was not specified; if multiple switches\nshare the same `name`, each selected switch's `value` is included in the\nlist). When `selected` is `false`, the switch's `value` is omitted from\n`stringInputs.value`.\n\n* **A date-time picker (`DateTimePickerType.DATE_AND_TIME`)**: a\n[`DateTimeInput\nobject`](https://developers.google.com/workspace/add-ons/concepts/event-objects#date-time-input).\n\n**Example**: For a picker with a `name` of `myDTPicker`, access the\n[`DateTimeInput`](https://developers.google.com/workspace/add-ons/concepts/event-objects#date-time-input)\nobject using `e.commonEventObject.formInputs.myDTPicker.dateTimeInput`.\n\n* **A date-only picker (`DateTimePickerType.DATE_ONLY`)**: a [`DateInput\nobject`](https://developers.google.com/workspace/add-ons/concepts/event-objects#date-input).\n\n**Example**: For a picker with a `name` of `myDatePicker`, access the\n[`DateInput`](https://developers.google.com/workspace/add-ons/concepts/event-objects#date-input)\nobject using `e.commonEventObject.formInputs.myDatePicker.dateInput`.\n\n* **A time-only picker (`DateTimePickerType.TIME_ONLY`)**: a [`TimeInput\nobject`](https://developers.google.com/workspace/add-ons/concepts/event-objects#time-input).\n\n**Example**: For a picker with a `name` of `myTimePicker`, access the\n[`TimeInput`](https://developers.google.com/workspace/add-ons/concepts/event-objects#time-input)\nobject using `e.commonEventObject.formInputs.myTimePicker.timeInput`.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/GoogleAppsAddonsV1EventObjectCommonEventObjectInputs"
          }
        },
        "parameters": {
          "description": "Any additional parameters you supply to an action using\n[`actionParameters`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#google.apps.card.v1.Action.ActionParameter)\nor\n[`Action.setParameters()`](https://developers.google.com/apps-script/reference/card-service/action#setparametersparameters).\n\n**Developer Preview:** For [add-ons that extend Google\nChat](https://developers.google.com/workspace/add-ons/chat), to suggest\nitems based on what the users type in multiselect menus, use the value of\nthe `\"autocomplete_widget_query\"` key\n(`event.commonEventObject.parameters[\"autocomplete_widget_query\"]`). You\ncan use this value to query a database and suggest selectable items to\nusers as they type. For details, see [Collect and process information\nfrom Google Chat\nusers](https://developers.google.com/workspace/add-ons/chat/collect-information).",
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        "invokedFunction": {
          "description": "Name of the function to invoke.\n\nThis field doesn't populate for Google Workspace Add-ons that extend\nGoogle Chat. Instead, to receive function data like identifiers,\nadd-ons that extend Chat should use the `parameters` field. See\n[Build interactive interfaces for Chat\napps](https://developers.google.com/workspace/add-ons/chat/build).",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1EventObjectCommonEventObjectTimeZone": {
      "description": "The timezone ID and offset from Coordinated Universal Time (UTC).\nOnly supported for the event types\n[`CARD_CLICKED`](https://developers.google.com/chat/api/reference/rest/v1/EventType#ENUM_VALUES.CARD_CLICKED)\nand\n[`SUBMIT_DIALOG`](https://developers.google.com/chat/api/reference/rest/v1/DialogEventType#ENUM_VALUES.SUBMIT_DIALOG).",
      "type": "object",
      "properties": {
        "id": {
          "description": "The [IANA TZ](https://www.iana.org/time-zones) time zone database code,\nsuch as \"America/Toronto\".",
          "type": "string"
        },
        "offset": {
          "description": "The user timezone offset, in milliseconds, from\nCoordinated Universal Time (UTC).",
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleAppsAddonsV1EventObjectCommonEventObjectInputs": {
      "description": "Types of data that users can [input on cards or\ndialogs](https://developers.google.com/chat/ui/read-form-data). The input\ntype depends on the type of values that the widget accepts.",
      "type": "object",
      "properties": {
        "stringInputs": {
          "description": "A list of strings that represent the values that the user inputs in a\nwidget.\n\nIf the widget only accepts one value, such as a\n[`TextInput`](https://developers.google.com/chat/api/reference/rest/v1/cards#TextInput)\nwidget, the list contains one string object. If the\nwidget accepts multiple values, such as a\n[`SelectionInput`](https://developers.google.com/chat/api/reference/rest/v1/cards#selectioninput)\nwidget of checkboxes, the list contains a string object for each\nvalue that the user inputs or selects.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1EventObjectCommonEventObjectInputsStringInputs"
            }
          ]
        },
        "dateTimeInput": {
          "description": "Date and time input values from a\n[`DateTimePicker`](https://developers.google.com/chat/api/reference/rest/v1/cards#DateTimePicker)\nwidget that accepts both a date and time.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1EventObjectCommonEventObjectInputsDateTimeInput"
            }
          ]
        },
        "dateInput": {
          "description": "Date input values from a\n[`DateTimePicker`](https://developers.google.com/chat/api/reference/rest/v1/cards#DateTimePicker)\nwidget that only accepts date values.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1EventObjectCommonEventObjectInputsDateInput"
            }
          ]
        },
        "timeInput": {
          "description": "Time input values from a\n[`DateTimePicker`](https://developers.google.com/chat/api/reference/rest/v1/cards#DateTimePicker)\nwidget that only accepts time values.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1EventObjectCommonEventObjectInputsTimeInput"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1EventObjectCommonEventObjectInputsStringInputs": {
      "description": "Input parameter for regular widgets.\nFor single-valued widgets, it is a single value list. For\nmulti-valued widgets, such as checkbox, all the values are presented.",
      "type": "object",
      "properties": {
        "value": {
          "description": "An list of strings entered by the user.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "GoogleAppsAddonsV1EventObjectCommonEventObjectInputsDateTimeInput": {
      "description": "Date and time input values.",
      "type": "object",
      "properties": {
        "msSinceEpoch": {
          "description": "Time since epoch time, in milliseconds.",
          "type": "string",
          "format": "int64"
        },
        "hasDate": {
          "description": "Whether the `datetime` input includes a calendar date.",
          "type": "boolean"
        },
        "hasTime": {
          "description": "Whether the `datetime` input includes a timestamp.",
          "type": "boolean"
        }
      }
    },
    "GoogleAppsAddonsV1EventObjectCommonEventObjectInputsDateInput": {
      "description": "Date input values.",
      "type": "object",
      "properties": {
        "msSinceEpoch": {
          "description": "Time since epoch time, in milliseconds.",
          "type": "string",
          "format": "int64"
        }
      }
    },
    "GoogleAppsAddonsV1EventObjectCommonEventObjectInputsTimeInput": {
      "description": "Time input values.",
      "type": "object",
      "properties": {
        "hours": {
          "description": "The hour on a 24-hour clock.",
          "type": "integer",
          "format": "int32"
        },
        "minutes": {
          "description": "The number of minutes past the hour. Valid values are 0 to 59.",
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleAppsAddonsV1EventObjectAuthorizationEventObject": {
      "description": "Encapsulates authorization information for the add-on request",
      "type": "object",
      "properties": {
        "userOAuthToken": {
          "description": "The end user OAuth access token, authorized with the requested scopes.\n(After oAuth consent unbundling, this will be authorized with end-user\nauthorized scopes)",
          "type": "string"
        },
        "userIdToken": {
          "description": "An end-user ID token, if appropriate ID scopes are requested",
          "type": "string"
        },
        "systemIdToken": {
          "description": "An ID token for the G Suite Add-ons service account for this deployment",
          "type": "string"
        },
        "authorizedScopes": {
          "description": "List of OAuth scopes authorized by the user.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "GoogleAppsAddonsV1CalendarCalendarEventObject": {
      "description": "The Calendar event object is the portion of the overall event object that\ncarries information about a user's calendar and calendar events. It's only\npresent in an event object if the host application is Google Calendar.\n\nThe following table lists the fields present in the `calendar`\nfield of an event object. Fields marked as **User-generated data** are\npresent in the event object if and only if the data is present in the\nCalendar event and the add-on sets its `addOns.calendar.currentEventAccess`\n[manifest](https://developers.google.com/apps-script/manifest/calendar-addons)\nfield to `READ` or `READ_WRITE`.",
      "type": "object",
      "properties": {
        "id": {
          "description": "The event ID.",
          "type": "string"
        },
        "recurringEventId": {
          "description": "The ID of a recurring event.",
          "type": "string"
        },
        "calendarId": {
          "description": "The calendar ID.",
          "type": "string"
        },
        "organizer": {
          "description": "An object representing the organizer of the event.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1CalendarCalendarEventObjectOrganizer"
            }
          ]
        },
        "attendees": {
          "description": "**User-generated data.** A list of the attendees of the calendar event.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsCalendarHostAppDetailsCalendarEventAttendee"
          }
        },
        "conferenceData": {
          "description": "**User-generated data.** An object representing any conference data\nassociated with this event, such as Google Meet conference details.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceData"
            }
          ]
        },
        "capabilities": {
          "description": "**User-generated data.** An object describing the capabilities of the\nadd-on to view or update event information.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1CalendarCalendarEventObjectCapabilities"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1CalendarCalendarEventObjectOrganizer": {
      "type": "object",
      "properties": {
        "email": {
          "description": "The event organizer's email address.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsCalendarHostAppDetailsCalendarEventAttendee": {
      "description": "Attendee objects carry information about individual attendees to Google\nCalendar events. This information is present in the event object if and\nonly if the data is present in the Calendar event and the add-on sets its\n`addOns.calendar.currentEventAccess`\n[manifest](https://developers.google.com/apps-script/manifest/calendar-addons)\nfield to `READ` or `READ_WRITE`.",
      "type": "object",
      "properties": {
        "email": {
          "description": "The attendee email address.",
          "type": "string"
        },
        "displayName": {
          "description": "The attendee displayed name.",
          "type": "string"
        },
        "organizer": {
          "description": "**true** if the attendee is an organizer for this event.",
          "type": "boolean"
        },
        "self": {
          "description": "**true** if this attendee represents the calendar in which this event\nappears; **false** otherwise.",
          "type": "boolean"
        },
        "resource": {
          "description": "**true** if the attendee represents a resource, such as room or piece\nof equipment; **false** otherwise.",
          "type": "boolean"
        },
        "optional": {
          "description": "**true** if the attendance for this attendee is marked as optional;\n**false** otherwise.",
          "type": "boolean"
        },
        "responseStatus": {
          "description": "The attendee's response status. Possible values include the following:\n\n* **accepted**: The attendee has accepted the event invitation.\n* **declined**: The attendee has declined the event invitation.\n* **needsAction**: The attendee has not responded to the event\ninvitation.\n* **tentative**: The attendee has tentatively accepted the event\ninvitation.",
          "type": "string"
        },
        "comment": {
          "description": "The attendee's response comment, if any.",
          "type": "string"
        },
        "additionalGuests": {
          "description": "The number of additional guests the attendee had indicated they are\nbringing. Defaults to zero.",
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceData": {
      "description": "Conference data objects carry information about conferences that are\nattached to Google Calendar events. These can be Google conference\nsolutions, such as Google Meet, or third-party conferences. This\ninformation is present in the event object if and only if the data is\npresent in the Calendar event and the add-on sets its\n`addOns.calendar.currentEventAccess`\n[manifest](https://developers.google.com/apps-script/manifest/calendar-addons)\nfield to `READ` or `READ_WRITE`.",
      "type": "object",
      "properties": {
        "conferenceId": {
          "description": "The ID of the conference. This ID is meant to allow applications to keep\ntrack of conferences; you shouldn't display this ID to users.",
          "type": "string"
        },
        "conferenceSolution": {
          "description": "An object representing the conference solution, such as Hangouts or\nGoogle Meet.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataConferenceSolution"
            }
          ]
        },
        "entryPoints": {
          "description": "The list of conference entry points, such as URLs or phone numbers.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataEntryPoint"
          }
        },
        "notes": {
          "description": "Additional notes (such as instructions from the domain administrator or\nlegal notices) about the conference to display to the user. Can contain\nHTML. The maximum length is 2048 characters.",
          "type": "string"
        },
        "parameters": {
          "description": "An object containing a map of defined parameter data for use by the\nadd-on.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataParameters"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataConferenceSolution": {
      "type": "object",
      "properties": {
        "iconUri": {
          "description": "The URI for the user-visible icon representing this conference\nsolution.",
          "type": "string"
        },
        "key": {
          "description": "The key which uniquely identifies the conference solution for this\nevent.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataConferenceSolutionKey"
            }
          ]
        },
        "name": {
          "description": "The user-visible name of this conference solution (not localized).",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataConferenceSolutionKey": {
      "type": "object",
      "properties": {
        "type": {
          "description": "The conference solution type. Possible values include the following:\n\n* **eventHangout** for Hangouts for consumers\n([http://hangouts.google.com](http://hangouts.google.com)).\n* **eventNamedHangout** for classic Hangouts for Google Workspace\nusers ([http://hangouts.google.com](http://hangouts.google.com)).\n* **hangoutsMeet** for Google Meet\n([http://meet.google.com](http://meet.google.com)).\n* **addOn** for 3P conference solutions.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataEntryPoint": {
      "description": "Entry point objects carry information about the established means of\naccessing a given conference, such as by phone or video. This information\nis present in the event object if and only if the data is present in the\nCalendar event and the add-on sets its\n`addOns.calendar.currentEventAccess`\n[manifest](https://developers.google.com/apps-script/manifest/calendar-addons)\nfield to `READ` or `READ_WRITE`.",
      "type": "object",
      "properties": {
        "accessCode": {
          "description": "The access code used to access the conference. The maximum length is\n128 characters. Conference providers typically only use a subset of\n**{accessCode, meetingCode, passcode, password, pin}** to provide\naccess to conferences. Match and only ever display the fields the\nconference provider uses.",
          "type": "string"
        },
        "entryPointType": {
          "description": "The type of entry point. Possible values are the following:\n\n* **more**: Additional conference joining instructions, such as\nalternate phone numbers. A conference can only have one **more** entry\npoint; if present at least one other type of entry point is also\nrequired.\n* **phone**: Join the conference via a phone number. A conference can\nhave zero or more **phone** entry points. Google Calendar only displays\nthe first two phone entry points, after formatting and sorting\nalphabetically.\n* **sip**: Join the conference over SIP. A conference can have at most\none **sip** entry point.\n* **video**: Join the conference over HTTP. A conference can have at\nmost one **video** entry point.",
          "type": "string"
        },
        "label": {
          "description": "The user-visible label for the entry point URI (not localized).",
          "type": "string"
        },
        "meetingCode": {
          "description": "The meeting code used to access the conference. The maximum length is\n128 characters. Conference providers typically only use a subset of\n**{accessCode, meetingCode, passcode, password, pin}** to provide\naccess to conferences. Match and only ever display the fields the\nconference provider uses.",
          "type": "string"
        },
        "passcode": {
          "description": "The passcode used to access the conference. The maximum length is 128\ncharacters. Conference providers typically only use a subset of\n**{accessCode, meetingCode, passcode, password, pin}** to provide\naccess to conferences. Match and only ever display the fields the\nconference provider uses.",
          "type": "string"
        },
        "password": {
          "description": "The password used to access the conference. The maximum length is 128\ncharacters. Conference providers typically only use a subset of\n**{accessCode, meetingCode, passcode, password, pin}** to provide\naccess to conferences. Match and only ever display the fields the\nconference provider uses.",
          "type": "string"
        },
        "pin": {
          "description": "The PIN used to access the conference. The maximum length is 128\ncharacters. Conference providers typically only use a subset of\n**{accessCode, meetingCode, passcode, password, pin}** to provide\naccess to conferences. Match and only ever display the fields the\nconference provider uses.",
          "type": "string"
        },
        "uri": {
          "description": "The URI of the entry point. The maximum length is 1300 characters. The\nformatting depends on the entry point type:\n\n* **more**: A **http:** or **https:** schema is required.\n* **phone**: A **tel:** schema is required. The URI should include the\nentire dial sequence (for example, \"tel:+12345678900,,,12345678;1234\").\n* **sip**: A **sip:** or **sips:** schema is required. For example\n\"sip:12345678@myprovider.com\".\n* **video**: A **http:** or **https:** schema is required.",
          "type": "string"
        },
        "regionCode": {
          "description": "Region code of the phone number. Needed by users if the URI doesn't\ninclude a country code. Values are based on the public [CLDR list of\nregion codes](http://cldr.unicode.org/translation/country-names).",
          "type": "string"
        },
        "entryPointFeatures": {
          "description": "Features of the entry point. Currently these features only apply to\nphone entry points:\n\n* **toll**: The entry point is a toll phone call.\n* **toll_free**: The entry point is a toll-free phone call.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataParameters": {
      "type": "object",
      "properties": {
        "addOnParameters": {
          "description": "A map of parameter string keys and values. These keys and values are\ndefined by the add-on developer to attach information to a specific\nconference for the add-on's use.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataParametersAddOnParameters"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1CalendarCalendarEventObjectConferenceDataParametersAddOnParameters": {
      "type": "object",
      "properties": {
        "parameters": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        }
      }
    },
    "GoogleAppsAddonsV1CalendarCalendarEventObjectCapabilities": {
      "type": "object",
      "properties": {
        "canSeeAttendees": {
          "description": "**User-generated data.** **true** if the add-on can read the event\nattendee list; **false** otherwise.",
          "type": "boolean"
        },
        "canAddAttendees": {
          "description": "**User-generated data.** **true** if the add-on can add new attendees to\nthe event attendee list; **false** otherwise.",
          "type": "boolean"
        },
        "canSeeConferenceData": {
          "description": "**User-generated data.** **true** if the add-on can read the event\nconference data; **false** otherwise.",
          "type": "boolean"
        },
        "canSetConferenceData": {
          "description": "**User-generated data.** **true** if the add-on can update the event\nconference data; **false** otherwise.",
          "type": "boolean"
        },
        "canAddAttachments": {
          "description": "**User-generated data.** **true** if the add-on can add new attachments\nto the event; **false** otherwise.",
          "type": "boolean"
        }
      }
    },
    "GoogleAppsAddonsV1DriveDriveEventObject": {
      "description": "The Drive event object is the portion of the overall event object that\ncarries information about a user's Google Drive and its contents. It's only\npresent in an event object if the host application is Google Drive.",
      "type": "object",
      "properties": {
        "selectedItems": {
          "description": "A list of items (files or folders) selected in Drive.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1DriveDriveEventObjectDriveItemMetadata"
          }
        },
        "activeCursorItem": {
          "description": "The Drive item that is currently active.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1DriveDriveEventObjectDriveItemMetadata"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1DriveDriveEventObjectDriveItemMetadata": {
      "description": "Drive item objects carry information about specific Drive items, such as\nfiles or folders.",
      "type": "object",
      "properties": {
        "id": {
          "description": "The ID of the selected item.",
          "type": "string"
        },
        "iconUrl": {
          "description": "The URL of the icon that represents the selected item.",
          "type": "string"
        },
        "mimeType": {
          "description": "The MIME type of the selected item.",
          "type": "string"
        },
        "title": {
          "description": "The title of the selected item.",
          "type": "string"
        },
        "addonHasFileScopePermission": {
          "description": "If **true**, the add-on has requested and received\nhttps://www.googleapis.com/auth/drive.file scope authorization for\nthis item. Otherwise, this field is **false**.\n\nIf the add-on uses a more permissive scope such as\nhttps://www.googleapis.com/auth/drive or\nhttps://www.googleapis.com/auth/drive.readonly, this field isn't\nrelevant. Always use the least permissive scopes possible when designing\nadd-ons to protect user information.",
          "type": "boolean"
        }
      }
    },
    "GoogleAppsAddonsV1GmailGmailEventObject": {
      "description": "The Gmail event object is the portion of the overall event object that\ncarries information about a user's Gmail messages. It's only present in an\nevent object if the host application is Gmail.",
      "type": "object",
      "properties": {
        "messageId": {
          "description": "The ID of the currently open Gmail message.",
          "type": "string"
        },
        "threadId": {
          "description": "The currently open Gmail thread ID.",
          "type": "string"
        },
        "accessToken": {
          "description": "The Gmail-specific access token. You can use this token with the\n[`GmailApp.setCurrentMessageAccessToken(accessToken)`](https://developers.google.com/apps-script/reference/gmail/gmail-app#setcurrentmessageaccesstokenaccesstoken)\nmethod to grant your add-on temporary access to a user's currently open\nGmail message or let your add-on compose new drafts.",
          "type": "string"
        },
        "toRecipients": {
          "description": "**Disabled by default.** The list of \"To:\" recipient email addresses\ncurrently included in a draft the add-on is composing. To turn on this\nfield, you must set the `addOns.gmail.composeTrigger.draftAccess` field in\nyour manifest to `METADATA`.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "ccRecipients": {
          "description": "**Disabled by default.** The list of \"CC:\" recipient email addresses\ncurrently included in a draft the add-on is composing. To turn on this\nfield, you must set the `addOns.gmail.composeTrigger.draftAccess` field in\nyour manifest to `METADATA`.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "bccRecipients": {
          "description": "**Disabled by default.** The list of \"BCC:\" recipient email addresses\ncurrently included in a draft the add-on is composing. To turn on this\nfield, you must set the `addOns.gmail.composeTrigger.draftAccess` field in\nyour manifest to `METADATA`.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "GoogleAppsAddonsV1SheetsSheetsEventObject": {
      "description": "The Sheets event object is the portion of the overall event object that\ncarries information about a user's document and its contents. It's only\npresent in an event object if the add-on extends Google Sheets.",
      "type": "object",
      "properties": {
        "id": {
          "description": "**Only present if the `https://www.googleapis.com/auth/drive.file` scope\nhas been authorized by the user.** The ID of the spreadsheet open in the\nSheets UI.",
          "type": "string"
        },
        "title": {
          "description": "**Only present if the `https://www.googleapis.com/auth/drive.file` scope\nhas been authorized by the user.** The title of the spreadsheet open in the\nSheets UI.",
          "type": "string"
        },
        "addonHasFileScopePermission": {
          "description": "If `true`, the add-on has requested and received\n`https://www.googleapis.com/auth/drive.file` scope authorization for the\nspreadsheet open in the Sheets UI; otherwise this field is `false`.",
          "type": "boolean"
        },
        "matchedUrl": {
          "description": "**Only present if the following conditions are met:**\n\n* `https://www.googleapis.com/auth/workspace.linkpreview` has been\nauthorized by the user.\n* The URL matches the host pattern specified in the `LinkPreviewTriggers`\ntrigger.\n\nThe URL of the link that generates a preview in Google Sheets. To use this\nfield, you must configure the `LinkPreviewTriggers` in your add-on\u2019s\nmanifest. See [Preview links with smart\nchips](https://developers.google.com/workspace/add-ons/editors/gsao/preview-links)\nfor more details.\n\nExample payload for when a user previews the link\n`https://www.example.com/12345`:\n\n```\n\"sheets\" : {\n  \"matchedUrl\" : {\n    \"url\" : \"https://www.example.com/12345\"\n  }\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1MatchedUrl"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1MatchedUrl": {
      "description": "Event object returned with link preview requests.",
      "type": "object",
      "properties": {
        "url": {
          "description": "The URL that was matched.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1SlidesSlidesEventObject": {
      "description": "The Slides event object is the portion of the overall event object that\ncarries information about a user's document and its contents. It's only\npresent in an event object if the add-on extends Google Slides.",
      "type": "object",
      "properties": {
        "id": {
          "description": "**Only present if the `https://www.googleapis.com/auth/drive.file` scope\nhas been authorized by the user.** The ID of the presentation open in the\nSlides UI.",
          "type": "string"
        },
        "title": {
          "description": "**Only present if the `https://www.googleapis.com/auth/drive.file` scope\nhas been authorized by the user.** The title of the presentation open in\nthe Slides UI.",
          "type": "string"
        },
        "addonHasFileScopePermission": {
          "description": "If `true`, the add-on has requested and received\n`https://www.googleapis.com/auth/drive.file` scope authorization for the\npresentation open in the Slides UI; otherwise this field is `false`.",
          "type": "boolean"
        },
        "matchedUrl": {
          "description": "**Only present if the following conditions are met:**\n\n* `https://www.googleapis.com/auth/workspace.linkpreview` has been\nauthorized by the user.\n* The URL matches the host pattern specified in the `LinkPreviewTriggers`\ntrigger.\n\nThe URL of the link that generates a preview in Google Slides. To use this\nfield, you must configure the `LinkPreviewTriggers` in your add-on\u2019s\nmanifest. See [Preview links with smart\nchips](https://developers.google.com/workspace/add-ons/editors/gsao/preview-links)\nfor more details.\n\nExample payload for when a user previews the link\n`https://www.example.com/12345`:\n\n```\n\"slides\" : {\n  \"matchedUrl\" : {\n    \"url\" : \"https://www.example.com/12345\"\n  }\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1MatchedUrl"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1DocsDocsEventObject": {
      "description": "The Docs event object is the portion of the overall event object that carries\ninformation about a user's document and its contents. It's only present in an\nevent object if the add-on extends Google Docs.",
      "type": "object",
      "properties": {
        "id": {
          "description": "**Only present if the `https://www.googleapis.com/auth/drive.file` scope\nhas been authorized by the user.** The ID of the document open in the Docs\nUI.",
          "type": "string"
        },
        "title": {
          "description": "**Only present if the `https://www.googleapis.com/auth/drive.file` scope\nhas been authorized by the user.** The title of the document open in the\nDocs UI.",
          "type": "string"
        },
        "addonHasFileScopePermission": {
          "description": "If `true`, the add-on has requested and received\n`https://www.googleapis.com/auth/drive.file` scope authorization for the\ndocument open in the Docs UI; otherwise this field is `false`.",
          "type": "boolean"
        },
        "matchedUrl": {
          "description": "**Only present if the following conditions are met:**\n\n* `https://www.googleapis.com/auth/workspace.linkpreview` has been\nauthorized by the user.\n* The URL matches the host pattern specified in the `LinkPreviewTriggers`\ntrigger.\n\nThe URL of the link that generates a preview in Google Docs. To use this\nfield, you must configure the `LinkPreviewTriggers` in your add-on\u2019s\nmanifest. See [Preview links with smart\nchips](https://developers.google.com/workspace/add-ons/editors/gsao/preview-links)\nfor more details.\n\nExample payload for when a user previews the link\n`https://www.example.com/12345`:\n\n```\n\"docs\" : {\n  \"matchedUrl\" : {\n    \"url\" : \"https://www.example.com/12345\"\n  }\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1MatchedUrl"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1ChatChatEventObject": {
      "description": "A Google Chat app event object payload sent from Google server to add-ons. Payloads can be used to\nidentify the type of event.",
      "type": "object",
      "properties": {
        "type": {
          "description": "The type of the event, only populated for App Home events in Chat apps that\nare not add-ons.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value for the enum. DO NOT USE.",
            "A user opens a direct message from a Chat app that uses app home. Only\nthe `type`, `user`, and `space` fields are included for events of this\ntype. For more information, see [Build a homepage for a Google Chat\napp](https://developers.google.com/workspace/chat/send-app-home-card-message).",
            "A user submits information in an app home card. Only the `type`, `user`,\nand `space` fields are included for events of this type. For more\ninformation, see [Build a homepage for a Google Chat\napp]((https://developers.google.com/workspace/chat/send-app-home-card-message)."
          ],
          "enum": [
            "EVENT_TYPE_UNSPECIFIED",
            "APP_HOME",
            "SUBMIT_FORM"
          ]
        },
        "user": {
          "description": "The\n[user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User#FIELDS.name)\nwho interacts with the Chat app.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1User"
            }
          ]
        },
        "space": {
          "description": "The space in which the event occurred, only populated for App Home events\nin Chat apps that are not add-ons.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Space"
            }
          ]
        },
        "eventTime": {
          "description": "The timestamp indicating when the event object occurs.",
          "type": "string",
          "format": "date-time"
        },
        "messagePayload": {
          "description": "A user sends the Chat app a message, or @mentions the Chat app in a\nspace. App command invocations (such as slash commands and quick\ncommands) are delivered in `app_command_payload` instead.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatChatEventObjectMessagePayload"
            }
          ]
        },
        "addedToSpacePayload": {
          "description": "A user adds the Chat app to a Chat space, or a Google Workspace\nadministrator installs the Chat app in direct message spaces for users\nin their organization.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatChatEventObjectAddedToSpacePayload"
            }
          ]
        },
        "removedFromSpacePayload": {
          "description": "A user removes the Chat app from a space.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatChatEventObjectRemovedFromSpacePayload"
            }
          ]
        },
        "buttonClickedPayload": {
          "description": "Represents payload data when a user interacts with an interactive element\nof a card or dialog that triggers an `Action` callback. Despite the name,\nthis payload is populated for all card and dialog `Action` callbacks\u2014not\nonly button clicks, but also `on_change_action` triggers, `on_click`\nactions, `CardAction` clicks, and dialog submission or cancellation\n(`SUBMIT_DIALOG` and `CANCEL_DIALOG`).\n\nIf a user interacts with a dialog, the ButtonClickedPayload's\n`isDialogEvent` field is set to `true` and includes a\n[`DialogEventType`](https://developers.google.com/workspace/add-ons/chat/build#buttonclickedpayload).\n\nThe complete payload also includes `commonEventObject.formInputs` and\n`commonEventObject.parameters`.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatChatEventObjectButtonClickedPayload"
            }
          ]
        },
        "widgetUpdatedPayload": {
          "description": "A user updates a widget in an in-stream card or in a dialog.\n\nThe complete payload also includes\n`CommonEventObject.parameters['autocomplete_widget_query']`.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatChatEventObjectWidgetUpdatedPayload"
            }
          ]
        },
        "appCommandPayload": {
          "description": "A user invokes an [app\ncommand](https://developers.google.com/workspace/add-ons/chat/commands).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatChatEventObjectAppCommandPayload"
            }
          ]
        },
        "systemCommandPayload": {
          "description": "A user invokes a system command.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatChatEventObjectSystemCommandPayload"
            }
          ]
        }
      }
    },
    "GoogleChatV1User": {
      "description": "If your Chat app [authenticates as a\nuser](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),\nthe output for a `User` resource (such as in the Messages and Memberships\nAPIs) only populates the `name` and `type` fields for both internal and\nexternal users, unless they are members of the space or have prior affinity\nwith the calling user.",
      "type": "object",
      "properties": {
        "name": {
          "description": "Resource name for a Google Chat user.\n\nFormat: `users/{user}`. `users/app` can be used as an alias for the calling\napp bot user.\n\nFor human users, `{user}` is the same\nuser identifier as:\n\n- the `id` for the\n[Person](https://developers.google.com/people/api/rest/v1/people) in the\nPeople API. For example, `users/123456789` in Chat API represents the same\nperson as the `123456789` Person profile ID in People API.\n\n- the `id` for a\n[user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users)\nin the Admin SDK Directory API.\n\n- the user's email address can be used as an alias for `{user}` in API\nrequests. For example, if the People API Person profile ID for\n`user@example.com` is `123456789`, you can use `users/user@example.com` as\nan alias to reference `users/123456789`. Only the canonical resource name\n(for example `users/123456789`) will be returned from the API.",
          "type": "string"
        },
        "displayName": {
          "description": "Output only. The user's display name.\n\nPopulated for both app authentication and user authentication.\nThis field is always populated for requests made with [app\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).\nWhen calling the Messages and Memberships APIs with [user\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),\nthis field is populated for both internal and external users for the\n`sender` of a message, users within `annotations` (such as user\nmentions), and within `Membership` resources, provided the user is a\nmember of the space or has prior affinity with the calling user.",
          "readOnly": true,
          "type": "string"
        },
        "avatarUrl": {
          "description": "Output only. The user's avatar image URL.\n\nWhen calling the Messages and Memberships APIs with [user\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),\nthis field is populated for both internal and external users for the\n`sender` of a message, users within `annotations` (such as user\nmentions), and within `Membership` resources, provided the user is a\nmember of the space or has prior affinity with the calling user.",
          "readOnly": true,
          "type": "string"
        },
        "email": {
          "description": "Output only. The user's email address.\n\nWhen calling the Messages and Memberships APIs with [user\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),\nthis field is populated for both internal and external users for the\n`sender` of a message, users within `annotations` (such as user\nmentions), and within `Membership` resources, provided the user is a\nmember of the space or has prior affinity with the calling user.",
          "readOnly": true,
          "type": "string"
        },
        "domainId": {
          "description": "Unique identifier of the user's Google Workspace domain.",
          "type": "string"
        },
        "type": {
          "description": "User type.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value for the enum. DO NOT USE.",
            "Human user.",
            "Chat app user."
          ],
          "enum": [
            "TYPE_UNSPECIFIED",
            "HUMAN",
            "BOT"
          ]
        },
        "isAnonymous": {
          "description": "Output only. When `true`, the user is deleted or their profile is not\nvisible, such as when a user is mentioned in a space without being a member\nand without prior affinity with the calling user.",
          "readOnly": true,
          "type": "boolean"
        }
      }
    },
    "GoogleChatV1Space": {
      "description": "A space in Google Chat. Spaces are conversations between two or more users\nor 1:1 messages between a user and a Chat app.",
      "type": "object",
      "properties": {
        "name": {
          "description": "Identifier. Resource name of the space.\n\nFormat: `spaces/{space}`\n\nWhere `{space}` represents the system-assigned ID for the space. You can\nobtain the space ID by calling the\n[`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list)\nmethod or from the space URL. For example, if the space URL\nis `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID\nis `AAAAAAAAA`.",
          "x-google-identifier": true,
          "type": "string"
        },
        "type": {
          "description": "Output only. Deprecated: Use `space_type` instead.\nThe type of a space.",
          "readOnly": true,
          "deprecated": true,
          "type": "string",
          "x-google-enum-descriptions": [
            "Reserved.",
            "Conversations between two or more humans.",
            "1:1 Direct Message between a human and a Chat app, where all messages are\nflat. Note that this doesn't include direct messages between two humans."
          ],
          "enum": [
            "TYPE_UNSPECIFIED",
            "ROOM",
            "DM"
          ]
        },
        "spaceType": {
          "description": "Optional. The type of space. Required when creating a space or updating the space\ntype of a space. Output only for other usage.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Reserved.",
            "A place where people send messages, share files, and collaborate.\nA `SPACE` can include Chat apps.",
            "Group conversations between 3 or more people.\nA `GROUP_CHAT` can include Chat apps.",
            "1:1 messages between two humans or a human and a Chat app."
          ],
          "enum": [
            "SPACE_TYPE_UNSPECIFIED",
            "SPACE",
            "GROUP_CHAT",
            "DIRECT_MESSAGE"
          ]
        },
        "singleUserBotDm": {
          "description": "Optional. Whether the space is a DM between a Chat app and a single\nhuman.",
          "type": "boolean"
        },
        "threaded": {
          "description": "Output only. Deprecated: Use `spaceThreadingState` instead.\nWhether messages are threaded in this space.",
          "readOnly": true,
          "deprecated": true,
          "type": "boolean"
        },
        "displayName": {
          "description": "Optional. The space's display name. Required when [creating a\nspace](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create)\nwith a `spaceType` of `SPACE`. If you receive the error message\n`ALREADY_EXISTS` when creating a space or updating the `displayName`, try a\ndifferent `displayName`. An existing space within the Google Workspace\norganization might already use this display name.\n\nFor direct messages, this field might be empty.\n\nSupports up to 128 characters.",
          "type": "string"
        },
        "externalUserAllowed": {
          "description": "Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when\ncreating a space in a Google Workspace organization. Omit this field\nwhen creating spaces in the following conditions:\n\n  * The authenticated user uses a consumer account (unmanaged user\n    account). By default, a space created by a consumer account permits any\n    Google Chat user.\n\nFor existing spaces, this field is output only.",
          "x-google-immutable": true,
          "type": "boolean"
        },
        "spaceThreadingState": {
          "description": "Output only. The threading state in the Chat space.",
          "readOnly": true,
          "type": "string",
          "x-google-enum-descriptions": [
            "Reserved.",
            "Spaces that support message threads. When users respond to a message,\nthey can reply in-thread, which keeps their response in the context of\nthe original message.",
            "Named spaces where the conversation is organized by topic. Topics and\ntheir replies are grouped together.",
            "Spaces that don't support message threading. This space threading state\nis only used for special cases including:\n\n* Continuous meeting chat where threading is intentionally turned off.\n* Legacy group conversations that were created prior to 2022."
          ],
          "enum": [
            "SPACE_THREADING_STATE_UNSPECIFIED",
            "THREADED_MESSAGES",
            "GROUPED_MESSAGES",
            "UNTHREADED_MESSAGES"
          ]
        },
        "spaceDetails": {
          "description": "Optional. Details about the space including description and rules.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpaceSpaceDetails"
            }
          ]
        },
        "spaceHistoryState": {
          "description": "Optional. The message history state for messages and threads in this space.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1HistoryState"
            }
          ]
        },
        "importMode": {
          "description": "Optional. Whether this space is created in `Import Mode` as part of a data\nmigration into Google Workspace. While spaces are being imported, they\naren't visible to users until the import is complete.\n\nCreating a space in `Import Mode`requires [user\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
          "type": "boolean"
        },
        "createTime": {
          "description": "Optional. Immutable. For spaces created in Chat, the time the space was created. This field is\noutput only, except when used in import mode spaces.\n\nFor import mode spaces, set this field to the historical timestamp at which\nthe space was created in the source in order to preserve the original\ncreation time.\n\nOnly populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.",
          "x-google-immutable": true,
          "type": "string",
          "format": "date-time"
        },
        "lastActiveTime": {
          "description": "Output only. Timestamp of the last message in the space.",
          "readOnly": true,
          "type": "string",
          "format": "date-time"
        },
        "adminInstalled": {
          "description": "Output only. For direct message (DM) spaces with a Chat app, whether the space was\ncreated by a Google Workspace administrator. Administrators can install\nand set up a direct message with a Chat app on behalf of users in their\norganization.\n\nTo support admin install, your Chat app must feature direct messaging.",
          "readOnly": true,
          "type": "boolean"
        },
        "membershipCount": {
          "description": "Output only. The count of joined memberships grouped by member type.\nPopulated when the `space_type` is `SPACE`, `DIRECT_MESSAGE` or\n`GROUP_CHAT`.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpaceMembershipCount"
            }
          ]
        },
        "accessSettings": {
          "description": "Optional. Specifies the [access\nsetting](https://support.google.com/chat/answer/11971020) of the space.\nOnly populated when the `space_type` is `SPACE`.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpaceAccessSettings"
            }
          ]
        },
        "customer": {
          "description": "Optional. Immutable. The customer id of the domain of the space.\nRequired only when creating a space with [app\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)\nand `SpaceType` is `SPACE`, otherwise should not be set.\n\nIn the format `customers/{customer}`, where `customer` is the `id` from the\n[Admin SDK customer\nresource](https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers).\nPrivate apps can also use the `customers/my_customer` alias to create\nthe space in the same Google Workspace organization as the app.\n\nThis field isn't populated for direct messages (DMs) or when the space is\ncreated by non-Google Workspace users.",
          "x-google-immutable": true,
          "type": "string"
        },
        "spaceUri": {
          "description": "Output only. The URI for a user to access the space.",
          "readOnly": true,
          "type": "string"
        },
        "predefinedPermissionSettings": {
          "description": "Optional. Input only. Predefined space permission settings, input only when creating a space.\nIf the field is not set, a collaboration space is created. After you\ncreate the space, settings are populated in the `PermissionSettings`\nfield.\n\nSetting predefined permission settings supports:\n\n- [App\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)\nwith [administrator\napproval](https://support.google.com/a?p=chat-app-auth) with the\n`chat.app.spaces` or `chat.app.spaces.create` scopes.\n\n- [User\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)",
          "writeOnly": true,
          "type": "string",
          "x-google-enum-descriptions": [
            "Unspecified. Don't use.",
            "Setting to make the space a collaboration space where all members can\npost messages.",
            "Setting to make the space an announcement space where only space managers\ncan post messages."
          ],
          "enum": [
            "PREDEFINED_PERMISSION_SETTINGS_UNSPECIFIED",
            "COLLABORATION_SPACE",
            "ANNOUNCEMENT_SPACE"
          ]
        },
        "permissionSettings": {
          "description": "Optional. Space permission settings for existing spaces. Input for updating exact\nspace permission settings, where existing permission settings are\nreplaced. Output lists current permission settings.\n\nReading and updating permission settings supports:\n\n- [App\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)\nwith [administrator\napproval](https://support.google.com/a?p=chat-app-auth) with the\n`chat.app.spaces` scope. Only populated and settable when the Chat app\ncreated the space.\n\n- [User\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSettings"
            }
          ]
        },
        "importModeExpireTime": {
          "description": "Output only. The time when the space will be automatically deleted by the\nsystem if it remains in import mode.\n\nEach space created in import mode must exit this mode before this expire\ntime using `spaces.completeImport`.\n\nThis field is only populated for spaces that were created with import mode.",
          "readOnly": true,
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "GoogleChatV1SpaceSpaceDetails": {
      "description": "Details about the space including description and rules.",
      "type": "object",
      "properties": {
        "description": {
          "description": "Optional. A description of the space. For example, describe the space's\ndiscussion topic, functional purpose, or participants.\n\nSupports up to 4,096 characters.",
          "type": "string"
        },
        "guidelines": {
          "description": "Optional. The space's rules, expectations, and etiquette.\n\nSupports up to 5,000 characters.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1SpaceMembershipCount": {
      "description": "Represents the count of memberships of a space, grouped into categories.",
      "type": "object",
      "properties": {
        "joinedDirectHumanUserCount": {
          "description": "Output only. Count of human users that have directly joined the space, not counting\nusers joined by having membership in a joined group.",
          "readOnly": true,
          "type": "integer",
          "format": "int32"
        },
        "joinedGroupCount": {
          "description": "Output only. Count of all groups that have directly joined the space.",
          "readOnly": true,
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleChatV1SpaceAccessSettings": {
      "description": "Represents the [access\nsetting](https://support.google.com/chat/answer/11971020) of the space.",
      "type": "object",
      "properties": {
        "accessState": {
          "description": "Output only. Indicates the access state of the space.",
          "readOnly": true,
          "type": "string",
          "x-google-enum-descriptions": [
            "Access state is unknown or not supported in this API.",
            "Only users or Google Groups that have been individually added or\ninvited by other users or Google Workspace administrators can discover\nand access the space.",
            "A space manager has granted a target audience access to\nthe space. Users or Google Groups that have been individually added or\ninvited to the space can also discover and access the space. To learn\nmore, see [Make a space discoverable to specific\nusers](https://developers.google.com/workspace/chat/space-target-audience).\n\nCreating discoverable spaces requires [user\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)."
          ],
          "enum": [
            "ACCESS_STATE_UNSPECIFIED",
            "PRIVATE",
            "DISCOVERABLE"
          ]
        },
        "audience": {
          "description": "Optional. The resource name of the [target\naudience](https://support.google.com/a/answer/9934697) who can discover\nthe space, join the space, and preview the messages in the space. If\nunset, only users or Google Groups who have been individually invited or\nadded to the space can access it. For details, see [Make a space\ndiscoverable to a target\naudience](https://developers.google.com/workspace/chat/space-target-audience).\n\nFormat: `audiences/{audience}`\n\nTo use the default target audience for the Google Workspace organization,\nset to `audiences/default`.\n\nReading the target audience supports:\n\n- [User\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)\n\n- [App\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)\nwith [administrator\napproval](https://support.google.com/a?p=chat-app-auth)\nwith the `chat.app.spaces` scope.\n\nThis field is not populated when using the `chat.bot` scope with [app\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).\n\nSetting the target audience requires [user\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
          "type": "string"
        },
        "accessPermissionSettings": {
          "description": "Optional. Access permission settings for the space.\n\nTo set the target audience when creating a space, specify the\n`accessSettings.audience` field in your request.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpaceAccessPermissionSettings"
            }
          ]
        }
      }
    },
    "GoogleChatV1SpaceAccessPermissionSettings": {
      "description": "Access permission settings for a space.",
      "type": "object",
      "properties": {
        "discoverSpaceSetting": {
          "description": "Optional. Access permission setting for discovering the space.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpaceAccessPermissionSetting"
            }
          ]
        },
        "joinSpaceSetting": {
          "description": "Optional. Access permission setting for joining the space.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpaceAccessPermissionSetting"
            }
          ]
        },
        "viewSpaceMembershipSetting": {
          "description": "Optional. Access permission setting for viewing space membership.\nMust be specified together with\n`PermissionSettings.view_space_membership` in the update mask and request\nbody when updating who can view space membership. When granting view\naccess to a target audience, you must also grant\n`PermissionSettings.view_space_membership` to all members in the same\nrequest. To remove an existing target audience (for example, to restrict\nview access to space managers or assistant managers only), specify an\nempty `AccessPermissionSetting` (with no `principals`).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpaceAccessPermissionSetting"
            }
          ]
        }
      }
    },
    "GoogleChatV1SpaceAccessPermissionSetting": {
      "description": "An access permission setting.",
      "type": "object",
      "properties": {
        "principals": {
          "description": "Optional. Unordered list. Allowed principals for this permission.",
          "x-google-unordered-list": true,
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1SpacePrincipal"
          }
        }
      }
    },
    "GoogleChatV1SpacePrincipal": {
      "description": "A principal representing an entity granted access.",
      "type": "object",
      "properties": {
        "audience": {
          "description": "An audience.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Audience"
            }
          ]
        }
      }
    },
    "GoogleChatV1Audience": {
      "description": "A target audience in Google Chat. A target audience represents a group of\nusers within a Google Workspace organization, defined by an administrator.\nTarget audiences are used to configure access and visibility settings for\nresources, such as making a space discoverable to a specific group of users.\n\nFor more details, see [Target\naudiences](https://support.google.com/a/answer/9934697) and [Make a space\ndiscoverable to a target\naudience](https://developers.google.com/workspace/chat/space-target-audience).",
      "type": "object",
      "properties": {
        "name": {
          "description": "The resource name of the [target\naudience](https://support.google.com/a/answer/9934697) who can discover\nor join the space. For details, see [Make a space\ndiscoverable to a target\naudience](https://developers.google.com/workspace/chat/space-target-audience).\nFormat: `audiences/{audience}`\n\nTo use the default target audience for the Google Workspace organization,\nset to `audiences/default`.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1SpacePermissionSettings": {
      "description": "[Permission settings](https://support.google.com/chat/answer/13340792)\nthat you can specify when updating an existing named space.\n\nTo set permission settings when creating a space, specify the\n`PredefinedPermissionSettings` field in your request.",
      "type": "object",
      "properties": {
        "manageMembersAndGroups": {
          "description": "Optional. Setting for managing members and groups in a space.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSetting"
            }
          ]
        },
        "modifySpaceDetails": {
          "description": "Optional. Setting for updating space name, avatar, description and guidelines.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSetting"
            }
          ]
        },
        "toggleHistory": {
          "description": "Optional. Setting for toggling space history on and off.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSetting"
            }
          ]
        },
        "useAtMentionAll": {
          "description": "Optional. Setting for using @all in a space.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSetting"
            }
          ]
        },
        "manageApps": {
          "description": "Optional. Setting for managing apps in a space.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSetting"
            }
          ]
        },
        "manageWebhooks": {
          "description": "Optional. Setting for managing webhooks in a space.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSetting"
            }
          ]
        },
        "postMessages": {
          "description": "Output only. Setting for posting messages in a space.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSetting"
            }
          ]
        },
        "replyMessages": {
          "description": "Optional. Setting for replying to messages in a space.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSetting"
            }
          ]
        },
        "viewSpaceMembership": {
          "description": "Optional. Setting for viewing space membership.\nMust be specified together with\n`AccessPermissionSettings.view_space_membership_setting` in the update\nmask and request body when updating who can view space membership.\nWhen restricting view access to specific roles (for example, space\nmanagers or assistant managers only), specify the desired role\npermissions here and provide an empty\n`AccessPermissionSettings.view_space_membership_setting` in the same\nrequest. If a target audience is configured in\n`AccessPermissionSettings.view_space_membership_setting`, this setting\nmust be granted to all members.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SpacePermissionSetting"
            }
          ]
        }
      }
    },
    "GoogleChatV1SpacePermissionSetting": {
      "description": "Represents a space permission setting.",
      "type": "object",
      "properties": {
        "managersAllowed": {
          "description": "Optional. Whether space owners\n(`ROLE_MANAGER`)\nhave this permission.",
          "type": "boolean"
        },
        "assistantManagersAllowed": {
          "description": "Optional. Whether space managers\n`ROLE_ASSISTANT_MANAGER`)\nhave this permission.",
          "type": "boolean"
        },
        "membersAllowed": {
          "description": "Optional. Whether basic space members\n(`ROLE_MEMBER`)\nhave this permission.",
          "type": "boolean"
        }
      }
    },
    "GoogleAppsAddonsV1ChatChatEventObjectMessagePayload": {
      "description": "A user sends the Chat app a message, or @mentions the Chat app in a\nspace. App command invocations (such as slash commands and quick commands)\nuse `AppCommandPayload` instead.",
      "type": "object",
      "properties": {
        "space": {
          "description": "Required. The [Chat\nspace](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)\nin which the event object occurs.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Space"
            }
          ]
        },
        "message": {
          "description": "The message that triggers the event object.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Message"
            }
          ]
        },
        "configCompleteRedirectUri": {
          "description": "Optional. The URL the Chat app should redirect the user to after they\ncomplete an authorization or configuration flow outside of Google Chat.\nFor more information, see [Connect a Chat app with other services &\ntools](https://developers.google.com/workspace/add-ons/guides/connect-third-party-service).",
          "type": "string"
        }
      },
      "required": [
        "space"
      ]
    },
    "GoogleChatV1Message": {
      "description": "A message in a Google Chat space.",
      "type": "object",
      "properties": {
        "name": {
          "description": "Identifier. Resource name of the message.\n\nFormat: `spaces/{space}/messages/{message}`\n\n\nWhere `{space}` is the ID of the space where the message is posted and\n`{message}` is a system-assigned ID for the message. For example,\n`spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`.\n\nIf you set a custom ID when you create a message, you can use this ID to\nspecify the message in a request by replacing `{message}` with the value\nfrom the `clientAssignedMessageId` field. For example,\n`spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name\na\nmessage](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
          "x-google-identifier": true,
          "type": "string"
        },
        "sender": {
          "description": "Output only. The user who created the message.\nIf your Chat app [authenticates as a\nuser](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),\nthe output only populates the\n[user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User)\n`name` and `type` fields for both internal and external users, unless they\nare members of the space or have a prior affinity, like a direct message\n(DM) conversation, with the calling user.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1User"
            }
          ]
        },
        "createTime": {
          "description": "Optional. Immutable. For spaces created in Chat, the time at which the message was created. This\nfield is output only, except when used in import mode spaces.\n\nFor import mode spaces, set this field to the historical timestamp at which\nthe message was created in the source in order to preserve the original\ncreation time.",
          "x-google-immutable": true,
          "type": "string",
          "format": "date-time"
        },
        "lastUpdateTime": {
          "description": "Output only. The time at which the message was last edited by a user. If\nthe message has never been edited, this field is empty.",
          "readOnly": true,
          "type": "string",
          "format": "date-time"
        },
        "deleteTime": {
          "description": "Output only. The time at which the message was deleted in\nGoogle Chat. If the message is never deleted, this field is empty.",
          "readOnly": true,
          "type": "string",
          "format": "date-time"
        },
        "text": {
          "description": "Optional. Plain-text body of the message. The first link to an image, video, or web\npage generates a\n[preview chip](https://developers.google.com/workspace/chat/preview-links).\nYou can also [@mention a Google Chat\nuser](https://developers.google.com/workspace/chat/format-messages#messages-@mention),\nor everyone in the space.\n\nTo learn about creating text messages, see [Send a\nmessage](https://developers.google.com/workspace/chat/create-messages).",
          "type": "string"
        },
        "formattedText": {
          "description": "Output only. Contains the message `text` with markups added to communicate\nformatting. This field might not capture all formatting visible in the UI,\nbut includes the following:\n\n* [Markup\nsyntax](https://developers.google.com/workspace/chat/format-messages)\nfor bold, italic, strikethrough, monospace, monospace block, bulleted\nlist, and block quote.\n\n* [User\nmentions](https://developers.google.com/workspace/chat/format-messages#messages-@mention)\nusing the format ``.\n\n* Custom hyperlinks using the format `<{url}|{rendered_text}>` where the\nfirst string is the URL and the second is the rendered text\u2014for example,\n``.\n\n* Custom emoji using the format `:{emoji_name}:`\u2014for example, `:smile:`.\nThis doesn't apply to Unicode emoji, such as `U+1F600` for a grinning\nface emoji.\n\n* Bullet list items using asterisks (`*`)\u2014for example, `* item`.\n\nFor more information, see [View text formatting sent in a\nmessage](https://developers.google.com/workspace/chat/format-messages#view_text_formatting_sent_in_a_message)",
          "readOnly": true,
          "type": "string"
        },
        "cards": {
          "description": "Deprecated: Use `cards_v2` instead.\n\nRich, formatted, and interactive cards that you can use to display UI\nelements such as: formatted texts, buttons, and clickable images. Cards are\nnormally displayed below the plain-text body of the message. `cards` and\n`cards_v2` can have a maximum size of 32 KB.",
          "deprecated": true,
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1ContextualAddOnMarkupCard"
          }
        },
        "cardsV2": {
          "description": "Optional. An array of\n[cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards).\n\nChat apps can create cards with [app\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).\nAs part of the [Developer Preview\nProgram](https://developers.google.com/workspace/preview), if your Chat app\n[authenticates as a\nuser](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),\nit can create card messages. If your Chat app is not part of Developer\nPreview Program, it can't create cards with user authentication.\n\nTo learn how to create a message that contains cards, see [Send a\nmessage](https://developers.google.com/workspace/chat/create-messages).\n\n[Card builder](https://addons.gsuite.google.com/uikit/builder)",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1CardWithId"
          }
        },
        "annotations": {
          "description": "Output only. Annotations can be associated with the plain-text body of the\nmessage or with chips that link to Google Workspace resources like Google\nDocs or Sheets with `start_index` and `length` of 0.",
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1Annotation"
          }
        },
        "thread": {
          "description": "The thread the message belongs to. For example usage, see\n[Start or reply to a message\nthread](https://developers.google.com/workspace/chat/create-messages#create-message-thread).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Thread"
            }
          ]
        },
        "space": {
          "description": "Output only. If your Chat app [authenticates as a\nuser](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),\nthe output only populates the\n[space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)\n`name`.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Space"
            }
          ]
        },
        "fallbackText": {
          "description": "Optional. A plain-text description of the message's cards, used when the actual cards\ncan't be displayed\u2014for example, mobile notifications.",
          "type": "string"
        },
        "actionResponse": {
          "description": "Input only. Parameters that a Chat app can use to configure how its\nresponse is posted.",
          "writeOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1ActionResponse"
            }
          ]
        },
        "argumentText": {
          "description": "Output only. Plain-text body of the message with all Chat app mentions stripped out.",
          "readOnly": true,
          "type": "string"
        },
        "slashCommand": {
          "description": "Output only. Slash command information, if applicable.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SlashCommand"
            }
          ]
        },
        "attachment": {
          "description": "Optional. User-uploaded attachment.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1Attachment"
          }
        },
        "matchedUrl": {
          "description": "Output only. A URL in the Chat message `text` field that matches a link\npreview pattern. For more information, see [Preview\nlinks](https://developers.google.com/workspace/chat/preview-links).",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1MatchedUrl"
            }
          ]
        },
        "threadReply": {
          "description": "Output only. When `true`, the message is a response in a reply thread. When\n`false`, the message is visible in the space's top-level conversation as\neither the first message of a thread or a message with no threaded replies.\n\nIf the space doesn't support reply in threads, this field is always\n`false`.",
          "readOnly": true,
          "type": "boolean"
        },
        "silent": {
          "description": "Output only. Whether this is a silent message. Silent messages are messages\nwhere Chat suppresses push notifications for recipients.",
          "readOnly": true,
          "type": "boolean"
        },
        "clientAssignedMessageId": {
          "description": "Optional. A custom ID for the message. You can use field to identify a message, or to\nget, delete, or update a message. To set a custom ID, specify the\n[`messageId`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id)\nfield when you create the message. For details, see [Name a\nmessage](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).",
          "type": "string"
        },
        "emojiReactionSummaries": {
          "description": "Output only. The list of emoji reaction summaries on the message.",
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1EmojiReactionSummary"
          }
        },
        "privateMessageViewer": {
          "description": "Optional. Immutable. Input for creating a message, otherwise output only. The user that can view\nthe message. When set, the message is private and only visible to the\nspecified user and the Chat app. To include this field in your request, you\nmust call the Chat API using [app\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)\nand omit the following:\n\n* [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments)\n\nFor details, see [Send a message\nprivately](https://developers.google.com/workspace/chat/create-messages#private).",
          "x-google-immutable": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1User"
            }
          ]
        },
        "deletionMetadata": {
          "description": "Output only. Information about a deleted message. A message is deleted when\n`delete_time` is set.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1DeletionMetadata"
            }
          ]
        },
        "quotedMessageMetadata": {
          "description": "Optional. Information about a message that another message quotes.\n\nWhen you create a message, you can quote messages within the same\nthread, or quote a root message to create a new root message.\nHowever, you can't quote a message reply from a different thread.\n\nWhen you update a message, you can't add or replace the\n`quotedMessageMetadata` field, but you can remove it.\n\nFor example usage, see [Quote another\nmessage](https://developers.google.com/workspace/chat/create-messages#quote-a-message).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1QuotedMessageMetadata"
            }
          ]
        },
        "attachedGifs": {
          "description": "Output only. GIF images that are attached to the message.",
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1AttachedGif"
          }
        },
        "accessoryWidgets": {
          "description": "Optional. One or more interactive widgets that appear at the bottom of a message.\nYou can add accessory widgets to messages that contain text, cards, or both\ntext and cards. Not supported for messages that contain dialogs. For\ndetails, see [Add interactive widgets at the bottom of a\nmessage](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets).\n\nCreating a message with accessory widgets requires [app\nauthentication]\n(https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1AccessoryWidget"
          }
        },
        "elements": {
          "description": "Optional. Additional message components, including inline `citations` (where each\ncitation is associated with a specific portion of the message text) and\n`cited_sources` (which are general references used to generate the\nresponse and are not directly linked to specific segments of the text).\n\nOn input, provide `elements` when creating or updating a message. On\noutput, both `citations` and `cited_sources` are populated when reading a\nmessage that contains them. Callers can read structured citation metadata\nfrom `elements`, while `formatted_text` also includes inline citation tags\nor source links depending on `markup_syntax`.\n\nThese differ from `annotations`, which are output-only and offer\nsupplementary information tied to message fragments or the entire message\ntext.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Elements"
            }
          ]
        },
        "markupSyntax": {
          "description": "Optional. Specifies how the server interprets the message `text` field content when\ncreating a message or updating the `text` field of a message.\n\nWhen calling `UpdateMessage`, set `markup_syntax` and `text` on the\n`Message` resource and include `text` (not `markup_syntax`) in\n`update_mask`.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1MarkupSyntax"
            }
          ]
        }
      }
    },
    "GoogleChatV1ContextualAddOnMarkupCard": {
      "description": "A card is a UI element that can contain UI widgets such as text and\nimages.",
      "type": "object",
      "properties": {
        "header": {
          "description": "The header of the card. A header usually contains a title and an image.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1ContextualAddOnMarkupCardCardHeader"
            }
          ]
        },
        "sections": {
          "description": "Sections are separated by a line divider.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1ContextualAddOnMarkupCardSection"
          }
        },
        "cardActions": {
          "description": "The actions of this card.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1ContextualAddOnMarkupCardCardAction"
          }
        },
        "name": {
          "description": "Name of the card.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1ContextualAddOnMarkupCardCardHeader": {
      "type": "object",
      "properties": {
        "title": {
          "description": "The title must be specified. The header has a fixed height: if both a\ntitle and subtitle is specified, each takes up one line. If only the\ntitle is specified, it takes up both lines.",
          "type": "string"
        },
        "subtitle": {
          "description": "The subtitle of the card header.",
          "type": "string"
        },
        "imageStyle": {
          "description": "The image's type (for example, square border or circular border).",
          "type": "string",
          "x-google-enum-descriptions": [
            "",
            "Square border.",
            "Circular border."
          ],
          "enum": [
            "IMAGE_STYLE_UNSPECIFIED",
            "IMAGE",
            "AVATAR"
          ]
        },
        "imageUrl": {
          "description": "The URL of the image in the card header.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1ContextualAddOnMarkupCardSection": {
      "description": "A section contains a collection of widgets that are rendered\n(vertically) in the order that they are specified. Across all platforms,\ncards have a narrow fixed width, so\nthere's currently no need for layout properties (for example, float).",
      "type": "object",
      "properties": {
        "header": {
          "description": "The header of the section. Formatted text is\nsupported. For more information\nabout formatting text, see\n[Formatting text in Google Chat\napps](https://developers.google.com/workspace/chat/format-messages#card-formatting)\nand\n[Formatting\ntext in Google Workspace\nAdd-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
          "type": "string"
        },
        "widgets": {
          "description": "A section must contain at least one widget.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1WidgetMarkup"
          }
        }
      }
    },
    "GoogleChatV1WidgetMarkup": {
      "description": "A widget is a UI element that presents text and images.",
      "type": "object",
      "properties": {
        "textParagraph": {
          "description": "Display a text paragraph in this widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupTextParagraph"
            }
          ]
        },
        "image": {
          "description": "Display an image in this widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupImage"
            }
          ]
        },
        "keyValue": {
          "description": "Display a key value item in this widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupKeyValue"
            }
          ]
        },
        "buttons": {
          "description": "A list of buttons. Buttons is also `oneof data` and only one of these\nfields should be set.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1WidgetMarkupButton"
          }
        }
      }
    },
    "GoogleChatV1WidgetMarkupTextParagraph": {
      "description": "A paragraph of text. Formatted text supported. For more information\nabout formatting text, see\n[Formatting text in Google Chat\napps](https://developers.google.com/workspace/chat/format-messages#card-formatting)\nand\n[Formatting\ntext in Google Workspace\nAdd-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        }
      }
    },
    "GoogleChatV1WidgetMarkupImage": {
      "description": "An image that's specified by a URL and can have an `onclick` action.",
      "type": "object",
      "properties": {
        "imageUrl": {
          "description": "The URL of the image.",
          "type": "string"
        },
        "onClick": {
          "description": "The `onclick` action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupOnClick"
            }
          ]
        },
        "aspectRatio": {
          "description": "The aspect ratio of this image (width and height). This field lets you\nreserve the right height for the image while waiting for it to load.\nIt's not meant to override the built-in aspect ratio of the image.\nIf unset, the server fills it by prefetching the image.",
          "type": "number",
          "format": "double"
        }
      }
    },
    "GoogleChatV1WidgetMarkupOnClick": {
      "description": "An `onclick` action (for example, open a link).",
      "type": "object",
      "properties": {
        "action": {
          "description": "A form action is triggered by this `onclick` action if specified.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupFormAction"
            }
          ]
        },
        "openLink": {
          "description": "This `onclick` action triggers an open link action if specified.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupOpenLink"
            }
          ]
        }
      }
    },
    "GoogleChatV1WidgetMarkupFormAction": {
      "description": "A form action describes the behavior when the form is submitted.\nFor example, you can invoke Apps Script to handle the form.",
      "type": "object",
      "properties": {
        "actionMethodName": {
          "description": "The method name is used to identify which part of the form triggered the\nform submission. This information is echoed back to the Chat app as part\nof the card click event. You can use the same method name for several\nelements that trigger a common behavior.",
          "type": "string"
        },
        "parameters": {
          "description": "List of action parameters.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1WidgetMarkupFormActionActionParameter"
          }
        }
      }
    },
    "GoogleChatV1WidgetMarkupFormActionActionParameter": {
      "description": "List of string parameters to supply when the action method is invoked.\nFor example, consider three snooze buttons: snooze now, snooze one day,\nsnooze next week. You might use `action method = snooze()`, passing the\nsnooze type and snooze time in the list of string parameters.",
      "type": "object",
      "properties": {
        "key": {
          "description": "The name of the parameter for the action script.",
          "type": "string"
        },
        "value": {
          "description": "The value of the parameter.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1WidgetMarkupOpenLink": {
      "description": "A link that opens a new window.",
      "type": "object",
      "properties": {
        "url": {
          "description": "The URL to open.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1WidgetMarkupKeyValue": {
      "description": "A UI element contains a key (label) and a value (content). This\nelement can also contain some actions such as `onclick` button.",
      "type": "object",
      "properties": {
        "icon": {
          "description": "An enum value that's replaced by the Chat API with the\ncorresponding icon image.",
          "type": "string",
          "x-google-enum-descriptions": [
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            ""
          ],
          "enum": [
            "ICON_UNSPECIFIED",
            "AIRPLANE",
            "BOOKMARK",
            "BUS",
            "CAR",
            "CLOCK",
            "CONFIRMATION_NUMBER_ICON",
            "DOLLAR",
            "DESCRIPTION",
            "EMAIL",
            "EVENT_PERFORMER",
            "EVENT_SEAT",
            "FLIGHT_ARRIVAL",
            "FLIGHT_DEPARTURE",
            "HOTEL",
            "HOTEL_ROOM_TYPE",
            "INVITE",
            "MAP_PIN",
            "MEMBERSHIP",
            "MULTIPLE_PEOPLE",
            "OFFER",
            "PERSON",
            "PHONE",
            "RESTAURANT_ICON",
            "SHOPPING_CART",
            "STAR",
            "STORE",
            "TICKET",
            "TRAIN",
            "VIDEO_CAMERA",
            "VIDEO_PLAY"
          ]
        },
        "iconUrl": {
          "description": "The icon specified by a URL.",
          "type": "string"
        },
        "topLabel": {
          "description": "The text of the top label. Formatted text supported. For more information\nabout formatting text, see\n[Formatting text in Google Chat\napps](https://developers.google.com/workspace/chat/format-messages#card-formatting)\nand\n[Formatting\ntext in Google Workspace\nAdd-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
          "type": "string"
        },
        "content": {
          "description": "The text of the content. Formatted text supported and always required.\nFor more information\nabout formatting text, see\n[Formatting text in Google Chat\napps](https://developers.google.com/workspace/chat/format-messages#card-formatting)\nand\n[Formatting\ntext in Google Workspace\nAdd-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
          "type": "string"
        },
        "contentMultiline": {
          "description": "If the content should be multiline.",
          "type": "boolean"
        },
        "bottomLabel": {
          "description": "The text of the bottom label. Formatted text supported. For more\ninformation about formatting text, see [Formatting text in Google Chat\napps](https://developers.google.com/workspace/chat/format-messages#card-formatting)\nand\n[Formatting\ntext in Google Workspace\nAdd-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
          "type": "string"
        },
        "onClick": {
          "description": "The `onclick` action. Only the top label, bottom label, and content\nregion are clickable.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupOnClick"
            }
          ]
        },
        "button": {
          "description": "A button that can be clicked to trigger an action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupButton"
            }
          ]
        }
      }
    },
    "GoogleChatV1WidgetMarkupButton": {
      "description": "A button. Can be a text button or an image button.",
      "type": "object",
      "properties": {
        "textButton": {
          "description": "A button with text and `onclick` action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupTextButton"
            }
          ]
        },
        "imageButton": {
          "description": "A button with image and `onclick` action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupImageButton"
            }
          ]
        }
      }
    },
    "GoogleChatV1WidgetMarkupTextButton": {
      "description": "A button with text and `onclick` action.",
      "type": "object",
      "properties": {
        "text": {
          "description": "The text of the button.",
          "type": "string"
        },
        "onClick": {
          "description": "The `onclick` action of the button.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupOnClick"
            }
          ]
        }
      }
    },
    "GoogleChatV1WidgetMarkupImageButton": {
      "description": "An image button with an `onclick` action.",
      "type": "object",
      "properties": {
        "icon": {
          "description": "The icon specified by an `enum` that indices to an icon provided by\nChat API.",
          "type": "string",
          "x-google-enum-descriptions": [
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            "",
            ""
          ],
          "enum": [
            "ICON_UNSPECIFIED",
            "AIRPLANE",
            "BOOKMARK",
            "BUS",
            "CAR",
            "CLOCK",
            "CONFIRMATION_NUMBER_ICON",
            "DOLLAR",
            "DESCRIPTION",
            "EMAIL",
            "EVENT_PERFORMER",
            "EVENT_SEAT",
            "FLIGHT_ARRIVAL",
            "FLIGHT_DEPARTURE",
            "HOTEL",
            "HOTEL_ROOM_TYPE",
            "INVITE",
            "MAP_PIN",
            "MEMBERSHIP",
            "MULTIPLE_PEOPLE",
            "OFFER",
            "PERSON",
            "PHONE",
            "RESTAURANT_ICON",
            "SHOPPING_CART",
            "STAR",
            "STORE",
            "TICKET",
            "TRAIN",
            "VIDEO_CAMERA",
            "VIDEO_PLAY"
          ]
        },
        "iconUrl": {
          "description": "The icon specified by a URL.",
          "type": "string"
        },
        "onClick": {
          "description": "The `onclick` action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupOnClick"
            }
          ]
        },
        "name": {
          "description": "The name of this `image_button` that's used for accessibility.\nDefault value is provided if this name isn't specified.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1ContextualAddOnMarkupCardCardAction": {
      "description": "A card action is\nthe action associated with the card. For an invoice card, a\ntypical action would be: delete invoice, email invoice or open the\ninvoice in browser.\n\nNot supported by Google Chat apps.",
      "type": "object",
      "properties": {
        "actionLabel": {
          "description": "The label used to be displayed in the action menu item.",
          "type": "string"
        },
        "onClick": {
          "description": "The onclick action for this action item.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1WidgetMarkupOnClick"
            }
          ]
        }
      }
    },
    "GoogleChatV1CardWithId": {
      "description": "A\n[card](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards)\nin a Google Chat message.\n\nChat apps can create cards with [app\nauthentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).\nAs part of the [Developer Preview\nProgram](https://developers.google.com/workspace/preview), if your Chat app\n[authenticates as a\nuser](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),\nit can create card messages. If your Chat app is not part of Developer\nPreview Program, it can't create cards with user authentication.\n\nTo learn how to create a message that contains cards, see [Send a\nmessage](https://developers.google.com/workspace/chat/create-messages).\n\n[Card builder](https://addons.gsuite.google.com/uikit/builder)",
      "type": "object",
      "properties": {
        "cardId": {
          "description": "Required if the message contains multiple cards. A unique identifier for\na card in a message.",
          "type": "string"
        },
        "card": {
          "description": "A card. Maximum size is 32 KB.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Card"
            }
          ]
        },
        "ownerUser": {
          "description": "Output only. The app that owns the card.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1User"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1Card": {
      "description": "A card interface displayed in a Google Chat message or Google Workspace\nadd-on.\n\nCards support a defined layout, interactive UI elements like buttons, and\nrich media like images. Use cards to present detailed information,\ngather information from users, and guide users to take a next step.\n\n[Card builder](https://addons.gsuite.google.com/uikit/builder)\n\nTo learn how\nto build cards, see the following documentation:\n\n* For Google Chat apps, see [Design the components of a card or\n  dialog](https://developers.google.com/workspace/chat/design-components-card-dialog).\n* For Google Workspace add-ons, see [Card-based\ninterfaces](https://developers.google.com/apps-script/add-ons/concepts/cards).\n\nNote: You can add up to 100 widgets per card. If a section's widgets push the\ntotal count above 100, that entire section and all following sections are\nignored. This limit applies to both card messages and dialogs in Google Chat\napps, and to cards in Google Workspace add-ons.\n\n**Example: Card message for a Google Chat app**\n\n![Example contact\ncard](https://developers.google.com/workspace/chat/images/card_api_reference.png)\n\nTo create the sample card message in Google Chat, use the following JSON:\n\n```\n{\n  \"cardsV2\": [\n    {\n      \"cardId\": \"unique-card-id\",\n      \"card\": {\n        \"header\": {\n           \"title\": \"Sasha\",\n           \"subtitle\": \"Software Engineer\",\n           \"imageUrl\":\n           \"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png\",\n           \"imageType\": \"CIRCLE\",\n           \"imageAltText\": \"Avatar for Sasha\"\n         },\n         \"sections\": [\n           {\n             \"header\": \"Contact Info\",\n             \"collapsible\": true,\n             \"uncollapsibleWidgetsCount\": 1,\n             \"widgets\": [\n               {\n                 \"decoratedText\": {\n                   \"startIcon\": {\n                     \"knownIcon\": \"EMAIL\"\n                   },\n                   \"text\": \"sasha@example.com\"\n                 }\n               },\n               {\n                 \"decoratedText\": {\n                   \"startIcon\": {\n                     \"knownIcon\": \"PERSON\"\n                   },\n                   \"text\": \"Online\"\n                 }\n               },\n               {\n                 \"decoratedText\": {\n                   \"startIcon\": {\n                     \"knownIcon\": \"PHONE\"\n                   },\n                   \"text\": \"+1 (555) 555-1234\"\n                 }\n               },\n               {\n                 \"buttonList\": {\n                   \"buttons\": [\n                     {\n                       \"text\": \"Share\",\n                       \"onClick\": {\n                        \"openLink\": {\n                           \"url\": \"https://example.com/share\"\n                         }\n                       }\n                     },\n                     {\n                       \"text\": \"Edit\",\n                       \"onClick\": {\n                         \"action\": {\n                           \"function\": \"goToView\",\n                           \"parameters\": [\n                             {\n                               \"key\": \"viewType\",\n                               \"value\": \"EDIT\"\n                             }\n                           ]\n                         }\n                       }\n                     }\n                   ]\n                 }\n               }\n             ]\n           }\n         ]\n       }\n    }\n  ]\n}\n```",
      "type": "object",
      "properties": {
        "header": {
          "description": "The header of the card. A header usually contains a leading image and a\ntitle. Headers always appear at the top of a card.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1CardCardHeader"
            }
          ]
        },
        "sections": {
          "description": "Contains a collection of widgets. Each section has its own, optional\nheader. Sections are visually separated by a line divider. For an example\nin Google Chat apps, see [Define a section of a\ncard](https://developers.google.com/workspace/chat/design-components-card-dialog#define_a_section_of_a_card).",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1CardSection"
          }
        },
        "sectionDividerStyle": {
          "description": "The divider style between the header, sections and footer.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "Default option. Render a solid divider.",
            "If set, no divider is rendered. This style completely removes the divider\nfrom the layout. The result is equivalent to not adding a divider at all."
          ],
          "enum": [
            "DIVIDER_STYLE_UNSPECIFIED",
            "SOLID_DIVIDER",
            "NO_DIVIDER"
          ]
        },
        "cardActions": {
          "description": "The card's actions. Actions are added to the card's toolbar menu.\nSupports up to 10 `CardAction` items.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):\n\nFor example, the following JSON constructs a card action menu with\n`Settings` and `Send Feedback` options:\n\n```\n\"card_actions\": [\n  {\n    \"actionLabel\": \"Settings\",\n    \"onClick\": {\n      \"action\": {\n        \"functionName\": \"goToView\",\n        \"parameters\": [\n          {\n            \"key\": \"viewType\",\n            \"value\": \"SETTING\"\n         }\n        ],\n        \"loadIndicator\": \"LoadIndicator.SPINNER\"\n      }\n    }\n  },\n  {\n    \"actionLabel\": \"Send Feedback\",\n    \"onClick\": {\n      \"openLink\": {\n        \"url\": \"https://example.com/feedback\"\n      }\n    }\n  }\n]\n```",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1CardCardAction"
          }
        },
        "name": {
          "description": "Name of the card. Used as a card identifier in card navigation.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):",
          "type": "string"
        },
        "fixedFooter": {
          "description": "The fixed footer shown at the bottom of this card.\n\nSetting `fixedFooter` without specifying a `primaryButton` or a\n`secondaryButton` causes an error. For Chat apps, you can use fixed footers\nin\n[dialogs](https://developers.google.com/workspace/chat/dialogs), but not\n[card\nmessages](https://developers.google.com/workspace/chat/create-messages#create).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1CardCardFixedFooter"
            }
          ]
        },
        "displayStyle": {
          "description": "In Google Workspace add-ons, sets the display properties of the\n`peekCardHeader`.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "The header of the card appears at the bottom of the\nsidebar, partially covering the current top card of the stack. Clicking\nthe header pops the card into the card stack. If the card has no header,\na generated header is used instead.",
            "Default value. The card is shown by replacing the view of the top card in\nthe card stack."
          ],
          "enum": [
            "DISPLAY_STYLE_UNSPECIFIED",
            "PEEK",
            "REPLACE"
          ]
        },
        "peekCardHeader": {
          "description": "When displaying contextual content, the peek card header acts as a\nplaceholder so that the user can navigate forward between the homepage\ncards and the contextual cards.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1CardCardHeader"
            }
          ]
        },
        "expressionData": {
          "description": "The expression data for the card.\n\nAvailable for Google Workspace add-ons that extend Google Workspace Studio.\nUnavailable for Google Chat apps.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1ExpressionData"
          }
        }
      }
    },
    "GoogleAppsCardV1CardCardHeader": {
      "description": "Represents a card header. For an example in Google Chat apps, see [Add a\nheader](https://developers.google.com/workspace/chat/design-components-card-dialog#add_a_header).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "title": {
          "description": "Required. The title of the card header.\nThe header has a fixed height: if both a\ntitle and subtitle are specified, each takes up one line. If only the\ntitle is specified, it takes up both lines.",
          "type": "string"
        },
        "subtitle": {
          "description": "The subtitle of the card header. If specified, appears on its own line\nbelow the `title`.",
          "type": "string"
        },
        "imageType": {
          "description": "The shape used to crop the image.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. Applies a square mask to the image. For example, a 4x3\nimage becomes 3x3.",
            "Applies a circular mask to the image. For example, a 4x3 image becomes a\ncircle with a diameter of 3."
          ],
          "enum": [
            "SQUARE",
            "CIRCLE"
          ]
        },
        "imageUrl": {
          "description": "The HTTPS URL of the image in the card header.",
          "type": "string"
        },
        "imageAltText": {
          "description": "The alternative text of this image that's used for accessibility.",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1CardSection": {
      "description": "A section contains a collection of widgets that are rendered\nvertically in the order that they're specified.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "header": {
          "description": "Text that appears at the top of a section.\nSupports simple HTML formatted text. For more information\nabout formatting text, see\n[Formatting text in Google Chat\napps](https://developers.google.com/workspace/chat/format-messages#card-formatting)\nand\n[Formatting\ntext in Google Workspace\nadd-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
          "type": "string"
        },
        "widgets": {
          "description": "All the widgets in the section.\nMust contain at least one widget. A card supports up to 100 widgets\nacross all sections.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1Widget"
          }
        },
        "collapsible": {
          "description": "Indicates whether this section is collapsible.\n\nCollapsible sections hide some or all widgets, but users can expand the\nsection to reveal the hidden widgets by clicking **Show more**. Users\ncan hide the widgets again by clicking **Show less**.\n\nTo determine which widgets are hidden, specify\n`uncollapsibleWidgetsCount`.",
          "type": "boolean"
        },
        "uncollapsibleWidgetsCount": {
          "description": "The number of uncollapsible widgets which remain visible even when a\nsection is collapsed.\n\nFor example, when a section\ncontains five widgets and the `uncollapsibleWidgetsCount` is set to `2`,\nthe first two widgets are always shown and the last three are collapsed\nby default. The `uncollapsibleWidgetsCount` is taken into account only\nwhen `collapsible` is `true`.",
          "type": "integer",
          "format": "int32"
        },
        "id": {
          "description": "A unique ID assigned to the section that's used to identify the section\nto be mutated. The ID has a character limit of 64 characters and should\nbe in the format of `[a-zA-Z0-9-]+`.\n\nAvailable for Google Workspace add-ons that extend Google Workspace\nStudio. Unavailable for Google Chat apps.",
          "type": "string"
        },
        "collapseControl": {
          "description": "Optional. Define the expand and collapse button of the section.\nThis button will be shown only if the section is collapsible.\nIf this field isn't set, the default button is used.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1CollapseControl"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1Widget": {
      "description": "Each card is made up of widgets.\n\nA widget is a composite object that can represent one of text, images,\nbuttons, and other object types.",
      "type": "object",
      "properties": {
        "textParagraph": {
          "description": "Displays a text paragraph. Supports simple HTML formatted text. For more\ninformation about formatting text, see\n[Formatting text in Google Chat\napps](https://developers.google.com/workspace/chat/format-messages#card-formatting)\nand\n[Formatting\ntext in Google Workspace\nadd-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).\n\nFor example, the following JSON creates a bolded text:\n```\n\"textParagraph\": {\n  \"text\": \"  *bold text*\"\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1TextParagraph"
            }
          ]
        },
        "image": {
          "description": "Displays an image.\n\nFor example, the following JSON creates an image with alternative text:\n```\n\"image\": {\n  \"imageUrl\":\n  \"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png\",\n  \"altText\": \"Chat app avatar\"\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Image"
            }
          ]
        },
        "decoratedText": {
          "description": "Displays a decorated text item.\n\nFor example, the following JSON creates a decorated text widget showing\nemail address:\n\n```\n\"decoratedText\": {\n  \"icon\": {\n    \"knownIcon\": \"EMAIL\"\n  },\n  \"topLabel\": \"Email Address\",\n  \"text\": \"sasha@example.com\",\n  \"bottomLabel\": \"This is a new Email address!\",\n  \"switchControl\": {\n    \"name\": \"has_send_welcome_email_to_sasha\",\n    \"selected\": false,\n    \"controlType\": \"CHECKBOX\"\n  }\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1DecoratedText"
            }
          ]
        },
        "buttonList": {
          "description": "A list of buttons.\n\nFor example, the following JSON creates two buttons. The first\nis a blue text button and the second is an image button that opens a\nlink:\n```\n\"buttonList\": {\n  \"buttons\": [\n    {\n      \"text\": \"Edit\",\n      \"color\": {\n        \"red\": 0,\n        \"green\": 0,\n        \"blue\": 1,\n      },\n      \"disabled\": true,\n    },\n    {\n      \"icon\": {\n        \"knownIcon\": \"INVITE\",\n        \"altText\": \"check calendar\"\n      },\n      \"onClick\": {\n        \"openLink\": {\n          \"url\": \"https://example.com/calendar\"\n        }\n      }\n    }\n  ]\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ButtonList"
            }
          ]
        },
        "textInput": {
          "description": "Displays a text box that users can type into.\n\nFor example, the following JSON creates a text input for an email\naddress:\n\n```\n\"textInput\": {\n  \"name\": \"mailing_address\",\n  \"label\": \"Mailing Address\"\n}\n```\n\nAs another example, the following JSON creates a text input for a\nprogramming language with static suggestions:\n```\n\"textInput\": {\n  \"name\": \"preferred_programing_language\",\n  \"label\": \"Preferred Language\",\n  \"initialSuggestions\": {\n    \"items\": [\n      {\n        \"text\": \"C++\"\n      },\n      {\n        \"text\": \"Java\"\n      },\n      {\n        \"text\": \"JavaScript\"\n      },\n      {\n        \"text\": \"Python\"\n      }\n    ]\n  }\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1TextInput"
            }
          ]
        },
        "selectionInput": {
          "description": "Displays a selection control that lets users select items. Selection\ncontrols can be checkboxes, radio buttons, switches, or dropdown menus.\n\nFor example, the following JSON creates a dropdown menu that lets users\nchoose a size:\n\n```\n\"selectionInput\": {\n  \"name\": \"size\",\n  \"label\": \"Size\"\n  \"type\": \"DROPDOWN\",\n  \"items\": [\n    {\n      \"text\": \"S\",\n      \"value\": \"small\",\n      \"selected\": false\n    },\n    {\n      \"text\": \"M\",\n      \"value\": \"medium\",\n      \"selected\": true\n    },\n    {\n      \"text\": \"L\",\n      \"value\": \"large\",\n      \"selected\": false\n    },\n    {\n      \"text\": \"XL\",\n      \"value\": \"extra_large\",\n      \"selected\": false\n    }\n  ]\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1SelectionInput"
            }
          ]
        },
        "dateTimePicker": {
          "description": "Displays a widget that lets users input a date, time, or date and time.\n\nFor example, the following JSON creates a date time picker to schedule an\nappointment:\n\n\n```\n\"dateTimePicker\": {\n  \"name\": \"appointment_time\",\n  \"label\": \"Book your appointment at:\",\n  \"type\": \"DATE_AND_TIME\",\n  \"valueMsEpoch\": 796435200000\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1DateTimePicker"
            }
          ]
        },
        "divider": {
          "description": "Displays a horizontal line divider between widgets.\n\nFor example, the following JSON creates a divider:\n```\n\"divider\": {\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Divider"
            }
          ]
        },
        "grid": {
          "description": "Displays a grid with a collection of items.\n\nA grid supports any number of columns and items. The number of rows is\ndetermined by the upper bounds of the number items divided by the number\nof columns. A grid with 10 items and 2 columns has 5 rows. A grid with 11\nitems and 2 columns has 6 rows.\n\n[Google Workspace add-ons and\nChat apps](https://developers.google.com/workspace/extend):\n\nFor example, the following JSON creates a 2 column grid with a single\nitem:\n\n```\n\"grid\": {\n  \"title\": \"A fine collection of items\",\n  \"columnCount\": 2,\n  \"borderStyle\": {\n    \"type\": \"STROKE\",\n    \"cornerRadius\": 4\n  },\n  \"items\": [\n    {\n      \"image\": {\n        \"imageUri\": \"https://www.example.com/image.png\",\n        \"cropStyle\": {\n          \"type\": \"SQUARE\"\n        },\n        \"borderStyle\": {\n          \"type\": \"STROKE\"\n        }\n      },\n      \"title\": \"An item\",\n      \"textAlignment\": \"CENTER\"\n    }\n  ],\n  \"onClick\": {\n    \"openLink\": {\n      \"url\": \"https://www.example.com\"\n    }\n  }\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Grid"
            }
          ]
        },
        "columns": {
          "description": "Displays up to 2 columns.\n\nTo include more than 2 columns, or to use rows, use the `Grid` widget.\n\nFor example, the following JSON creates 2 columns that each contain\ntext paragraphs:\n\n```\n\"columns\": {\n  \"columnItems\": [\n    {\n      \"horizontalSizeStyle\": \"FILL_AVAILABLE_SPACE\",\n      \"horizontalAlignment\": \"CENTER\",\n      \"verticalAlignment\": \"CENTER\",\n      \"widgets\": [\n        {\n          \"textParagraph\": {\n            \"text\": \"First column text paragraph\"\n          }\n        }\n      ]\n    },\n    {\n      \"horizontalSizeStyle\": \"FILL_AVAILABLE_SPACE\",\n      \"horizontalAlignment\": \"CENTER\",\n      \"verticalAlignment\": \"CENTER\",\n      \"widgets\": [\n        {\n          \"textParagraph\": {\n            \"text\": \"Second column text paragraph\"\n          }\n        }\n      ]\n    }\n  ]\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Columns"
            }
          ]
        },
        "carousel": {
          "description": "Contains a collection of `CarouselCard` items, each of which\ncontains nested widgets.\nFor example, this is a JSON representation of a carousel that contains\ntwo carousel cards, each with a text paragraph:\n\n```\n{\n  \"carouselCards\": [\n    {\n      \"widgets\": [\n        {\n          \"textParagraph\": {\n            \"text\": \"First text paragraph in the carousel.\"\n          }\n        }\n      ]\n    },\n    {\n      \"widgets\": [\n        {\n          \"textParagraph\": {\n            \"text\": \"Second text paragraph in the carousel.\"\n          }\n        }\n      ]\n    }\n  ]\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Carousel"
            }
          ]
        },
        "chipList": {
          "description": "A list of chips.\n\nFor example, the following JSON creates two chips. The first\nis a text chip and the second is an icon chip that opens a\nlink:\n```\n\"chipList\": {\n  \"chips\": [\n    {\n      \"label\": \"Edit\",\n      \"disabled\": true\n    },\n    {\n      \"icon\": {\n        \"knownIcon\": \"INVITE\",\n        \"altText\": \"check calendar\"\n      },\n      \"onClick\": {\n        \"openLink\": {\n          \"url\": \"https://example.com/calendar\"\n        }\n      }\n    }\n  ]\n}\n```",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ChipList"
            }
          ]
        },
        "horizontalAlignment": {
          "description": "Specifies whether widgets align to the left, right, or center of a column.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "Default value. Aligns widgets to the start position of the column. For\nleft-to-right layouts, aligns to the left. For right-to-left layouts,\naligns to the right.",
            "Aligns widgets to the center of the column.",
            "Aligns widgets to the end position of the column. For left-to-right\nlayouts, aligns widgets to the right. For right-to-left layouts, aligns\nwidgets to the left."
          ],
          "enum": [
            "HORIZONTAL_ALIGNMENT_UNSPECIFIED",
            "START",
            "CENTER",
            "END"
          ]
        },
        "id": {
          "description": "A unique ID assigned to the widget that's used to identify the widget to be\nmutated. The ID has a character limit of 64 characters and should be in the\nformat of `[a-zA-Z0-9-]+`.\n\nAvailable for Google Workspace add-ons that extend Google Workspace Studio.\nUnavailable for Google Chat apps.",
          "type": "string"
        },
        "visibility": {
          "description": "Specifies whether the widget is visible or hidden. The default value is\n`VISIBLE`.\n\nAvailable for Google Workspace add-ons that extend Google Workspace Studio.\nUnavailable for Google Chat apps.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unspecified visibility. Do not use.",
            "The UI element is visible.",
            "The UI element is hidden."
          ],
          "enum": [
            "VISIBILITY_UNSPECIFIED",
            "VISIBLE",
            "HIDDEN"
          ]
        },
        "eventActions": {
          "description": "Specifies the event actions that can be performed on the widget.\n\nAvailable for Google Workspace add-ons that extend Google Workspace Studio.\nUnavailable for Google Chat apps.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1EventAction"
          }
        }
      }
    },
    "GoogleAppsCardV1TextParagraph": {
      "description": "A paragraph of text that supports formatting. For an example in\nGoogle Chat apps, see [Add a paragraph of formatted\ntext](https://developers.google.com/workspace/chat/add-text-image-card-dialog#add_a_paragraph_of_formatted_text).\nFor more information\nabout formatting text, see\n[Formatting text in Google Chat\napps](https://developers.google.com/workspace/chat/format-messages#card-formatting)\nand\n[Formatting\ntext in Google Workspace\nadd-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).\n\n[Google Workspace add-ons and\nChat apps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "text": {
          "description": "The text that's shown in the widget.",
          "type": "string"
        },
        "maxLines": {
          "description": "The maximum number of lines of text that are displayed in the widget. If\nthe text exceeds the specified maximum number of lines, the excess\ncontent is concealed behind a **show more** button. If the text is equal or\nshorter than the specified maximum number of lines, a **show more** button\nisn't displayed.\n\nThe default value is 0, in which case\nall context is displayed. Negative values are ignored.",
          "type": "integer",
          "format": "int32"
        },
        "textSyntax": {
          "description": "The syntax of the text. If not set, the text is rendered as HTML.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
          "type": "string",
          "x-google-enum-descriptions": [
            "The text is rendered as HTML if unspecified.",
            "The text is rendered as HTML. This is the default value.",
            "The text is rendered as Markdown."
          ],
          "enum": [
            "TEXT_SYNTAX_UNSPECIFIED",
            "HTML",
            "MARKDOWN"
          ]
        }
      }
    },
    "GoogleAppsCardV1Image": {
      "description": "An image that is specified by a URL and can have an `onClick` action. For an\nexample, see [Add an\nimage](https://developers.google.com/workspace/chat/add-text-image-card-dialog#add_an_image).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "imageUrl": {
          "description": "The HTTPS URL that hosts the image.\n\nFor example:\n\n```\nhttps://developers.google.com/workspace/chat/images/quickstart-app-avatar.png\n```",
          "type": "string"
        },
        "onClick": {
          "description": "When a user clicks the image, the click triggers this action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OnClick"
            }
          ]
        },
        "altText": {
          "description": "The alternative text of this image that's used for accessibility.",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1OnClick": {
      "description": "Represents how to respond when users click an interactive element on\na card, such as a button.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "action": {
          "description": "If specified, an action is triggered by this `onClick`.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Action"
            }
          ]
        },
        "openLink": {
          "description": "If specified, this `onClick` triggers an open link action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OpenLink"
            }
          ]
        },
        "openDynamicLinkAction": {
          "description": "An add-on triggers this action when the action needs to open a\nlink. This differs from the `open_link` above in that this needs to talk\nto server to get the link. Thus some preparation work is required for\nweb client to do before the open link action response comes back.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Action"
            }
          ]
        },
        "card": {
          "description": "A new card is pushed to the card stack after clicking if specified.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Card"
            }
          ]
        },
        "overflowMenu": {
          "description": "If specified, this `onClick` opens an overflow menu.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OverflowMenu"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1Action": {
      "description": "An action that describes the behavior when the form is submitted.\nFor example, you can invoke an Apps Script script to handle the form.\nIf the action is triggered, the form values are sent to the server.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "function": {
          "description": "A custom function to invoke when the containing element is\nclicked or otherwise activated.\n\nFor example usage, see [Read form\ndata](https://developers.google.com/workspace/chat/read-form-data).",
          "type": "string"
        },
        "parameters": {
          "description": "List of action parameters.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1ActionActionParameter"
          }
        },
        "loadIndicator": {
          "description": "Specifies the loading indicator that the action displays while\nmaking the call to the action.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Displays a spinner to indicate that content is loading.",
            "Nothing is displayed."
          ],
          "enum": [
            "SPINNER",
            "NONE"
          ]
        },
        "persistValues": {
          "description": "Indicates whether form values persist after the action. The default value\nis `false`.\n\nIf `true`, form values remain after the action is triggered. To let the\nuser make changes while the action is being processed, set\n[`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator)\nto `NONE`. For [card\nmessages](https://developers.google.com/workspace/chat/api/guides/v1/messages/create#create)\nin Chat apps, you must also set the action's\n[`ResponseType`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#responsetype)\nto `UPDATE_MESSAGE` and use the same\n[`card_id`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#CardWithId)\nfrom the card that contained the action.\n\nIf `false`, the form values are cleared when the action is triggered.\nTo prevent the user from making changes while the action is being\nprocessed, set\n[`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator)\nto `SPINNER`.",
          "type": "boolean"
        },
        "interaction": {
          "description": "Optional. Required when opening a\n[dialog](https://developers.google.com/workspace/chat/dialogs).\n\nWhat to do in response to an interaction with a user, such as a user\nclicking a button in a card message.\n\nIf unspecified, the app responds by executing an `action`\u2014like opening a\nlink or running a function\u2014as normal.\n\nBy specifying an `interaction`, the app can respond in special interactive\nways. For example, by setting `interaction` to `OPEN_DIALOG`, the app can\nopen a [dialog](https://developers.google.com/workspace/chat/dialogs). When\nspecified, a loading indicator isn't shown. If specified for\nan add-on, the entire card is stripped and nothing is shown in the client.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. The `action` executes as normal.",
            "Opens a [dialog](https://developers.google.com/workspace/chat/dialogs), a\nwindowed, card-based interface that Chat apps use to interact with users.\n\nOnly supported by Chat apps in response to button-clicks on card\nmessages. If specified for\nan add-on, the entire card is stripped and nothing is shown in the\nclient.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):"
          ],
          "enum": [
            "INTERACTION_UNSPECIFIED",
            "OPEN_DIALOG"
          ]
        },
        "requiredWidgets": {
          "description": "Optional. Fill this list with the names of widgets that this Action\nneeds for a valid submission.\n\nIf the widgets listed here don't have a value when this Action is invoked,\nthe form submission is aborted.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "allWidgetsAreRequired": {
          "description": "Optional. If this is true, then all widgets are considered required by\nthis action.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
          "type": "boolean"
        }
      }
    },
    "GoogleAppsCardV1ActionActionParameter": {
      "description": "List of string parameters to supply when the action method is invoked.\nFor example, consider three snooze buttons: snooze now, snooze one day,\nor snooze next week. You might use `action method = snooze()`, passing the\nsnooze type and snooze time in the list of string parameters.\n\nTo learn more, see\n[`CommonEventObject`](https://developers.google.com/workspace/chat/api/reference/rest/v1/Event#commoneventobject).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "key": {
          "description": "The name of the parameter for the action script.",
          "type": "string"
        },
        "value": {
          "description": "The value of the parameter.",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1OpenLink": {
      "description": "Represents an `onClick` event that opens a hyperlink.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "url": {
          "description": "The URL to open. HTTP URLs are converted to HTTPS.",
          "type": "string"
        },
        "openAs": {
          "description": "How to open a link.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):",
          "type": "string",
          "x-google-enum-descriptions": [
            "The link opens as a full-size window (if that's the frame used by the\nclient).",
            "The link opens as an overlay, such as a pop-up."
          ],
          "enum": [
            "FULL_SIZE",
            "OVERLAY"
          ]
        },
        "onClose": {
          "description": "Whether the client forgets about a link after opening it, or observes it\nuntil the window closes.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. The card doesn't reload; nothing happens.",
            "Reloads the card after the child window closes.\n\nIf used in conjunction with\n[`OpenAs.OVERLAY`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#openas),\nthe child window acts as a modal dialog and the parent card is blocked\nuntil the child window closes."
          ],
          "enum": [
            "NOTHING",
            "RELOAD"
          ]
        }
      }
    },
    "GoogleAppsCardV1OverflowMenu": {
      "description": "A widget that presents a pop-up menu with one or more actions that users can\ninvoke. For example, showing non-primary actions in a card. You can use this\nwidget when actions don't fit in the available space. To use, specify this\nwidget in the `OnClick` action of widgets that support it. For example, in a\n`Button`.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "items": {
          "description": "Required. The list of menu options.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1OverflowMenuOverflowMenuItem"
          }
        }
      }
    },
    "GoogleAppsCardV1OverflowMenuOverflowMenuItem": {
      "description": "An option that users can invoke in an overflow menu.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "startIcon": {
          "description": "The icon displayed in front of the text.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Icon"
            }
          ]
        },
        "text": {
          "description": "Required. The text that identifies or describes the item to users.",
          "type": "string"
        },
        "onClick": {
          "description": "Required. The action invoked when a menu option is selected.\nThis `OnClick` cannot contain an `OverflowMenu`, any specified\n`OverflowMenu` is dropped and the menu item disabled.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OnClick"
            }
          ]
        },
        "disabled": {
          "description": "Whether the menu option is disabled.\nDefaults to false.",
          "type": "boolean"
        }
      }
    },
    "GoogleAppsCardV1Icon": {
      "description": "An icon displayed in a widget on a card. For an example in Google Chat apps,\nsee [Add an\nicon](https://developers.google.com/workspace/chat/add-text-image-card-dialog#add_an_icon).\n\nSupports\n[built-in](https://developers.google.com/workspace/chat/format-messages#builtinicons)\nand\n[custom](https://developers.google.com/workspace/chat/format-messages#customicons)\nicons.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "knownIcon": {
          "description": "Display one of the built-in icons provided by Google Workspace.\n\nFor example, to display an airplane icon, specify `AIRPLANE`.\nFor a bus, specify `BUS`.\n\nFor a full list of supported icons, see [built-in\nicons](https://developers.google.com/workspace/chat/format-messages#builtinicons).",
          "type": "string"
        },
        "iconUrl": {
          "description": "Display a custom icon hosted at an HTTPS URL.\n\nFor example:\n\n```\n\"iconUrl\":\n\"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png\"\n```\n\nSupported file types include `.png` and `.jpg`.",
          "type": "string"
        },
        "materialIcon": {
          "description": "Display one of the [Google Material\nIcons](https://fonts.google.com/icons).\n\nFor example, to display a [checkbox\nicon](https://fonts.google.com/icons?selected=Material%20Symbols%20Outlined%3Acheck_box%3AFILL%400%3Bwght%40400%3BGRAD%400%3Bopsz%4048),\nuse\n```\n\"material_icon\": {\n  \"name\": \"check_box\"\n}\n```\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1MaterialIcon"
            }
          ]
        },
        "altText": {
          "description": "Optional. A description of the icon used for accessibility.\nIf unspecified, the default value `Button` is provided. As a best practice,\nyou should set a helpful description for what the icon displays, and if\napplicable, what it does. For example, `A user's account portrait`, or\n`Opens a new browser tab and navigates to the Google Chat developer\ndocumentation at https://developers.google.com/workspace/chat`.\n\nIf the icon is set in a `Button`, the\n`altText` appears as helper text when the user hovers over the button.\nHowever, if the button also sets `text`, the icon's `altText` is ignored.",
          "type": "string"
        },
        "imageType": {
          "description": "The crop style applied to the image. In some cases, applying a\n`CIRCLE` crop causes the image to be drawn larger than a built-in\nicon.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. Applies a square mask to the image. For example, a 4x3\nimage becomes 3x3.",
            "Applies a circular mask to the image. For example, a 4x3 image becomes a\ncircle with a diameter of 3."
          ],
          "enum": [
            "SQUARE",
            "CIRCLE"
          ]
        }
      }
    },
    "GoogleAppsCardV1MaterialIcon": {
      "description": "A [Google Material Icon](https://fonts.google.com/icons), which includes over\n2500+ options.\n\nFor example, to display a [checkbox\nicon](https://fonts.google.com/icons?selected=Material%20Symbols%20Outlined%3Acheck_box%3AFILL%400%3Bwght%40400%3BGRAD%400%3Bopsz%4048)\nwith customized weight and grade, write the following:\n\n```\n{\n  \"name\": \"check_box\",\n  \"fill\": true,\n  \"weight\": 300,\n  \"grade\": -25\n}\n```\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
      "type": "object",
      "properties": {
        "name": {
          "description": "The icon name defined in the [Google Material\nIcon](https://fonts.google.com/icons), for example, `check_box`. Any\ninvalid names are abandoned and replaced with empty string and\nresults in the icon failing to render.",
          "type": "string"
        },
        "fill": {
          "description": "Whether the icon renders as filled. Default value is false.\n\nTo preview different icon settings, go to\n[Google Font Icons](https://fonts.google.com/icons) and adjust the\nsettings under **Customize**.",
          "type": "boolean"
        },
        "weight": {
          "description": "The stroke weight of the icon. Choose from {100, 200, 300, 400,\n500, 600, 700}. If absent, default value is 400. If any other value is\nspecified, the default value is used.\n\nTo preview different icon settings, go to\n[Google Font Icons](https://fonts.google.com/icons) and adjust the\nsettings under **Customize**.",
          "type": "integer",
          "format": "int32"
        },
        "grade": {
          "description": "Weight and grade affect a symbol\u2019s thickness. Adjustments to grade are more\ngranular than adjustments to weight and have a small impact on the size of\nthe symbol. Choose from {-25, 0, 200}. If absent, default value is 0. If\nany other value is specified, the default value is used.\n\nTo preview different icon settings, go to\n[Google Font Icons](https://fonts.google.com/icons) and adjust the\nsettings under **Customize**.",
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleAppsCardV1DecoratedText": {
      "description": "A widget that displays text with optional decorations such as a label above\nor below the text, an icon in front of the text, a selection widget, or a\nbutton after the text. For an example in\nGoogle Chat apps, see [Display text with decorative\ntext](https://developers.google.com/workspace/chat/add-text-image-card-dialog#display_text_with_decorative_elements).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "icon": {
          "description": "Deprecated in favor of `startIcon`.",
          "deprecated": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Icon"
            }
          ]
        },
        "startIcon": {
          "description": "The icon displayed in front of the text.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Icon"
            }
          ]
        },
        "startIconVerticalAlignment": {
          "description": "Optional. Vertical alignment of the start icon. If not set, the icon\nwill be vertically centered.\n\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unspecified type. Do not use.",
            "Alignment to the top position.",
            "Alignment to the middle position.",
            "Alignment to the bottom position."
          ],
          "enum": [
            "VERTICAL_ALIGNMENT_UNSPECIFIED",
            "TOP",
            "MIDDLE",
            "BOTTOM"
          ]
        },
        "topLabel": {
          "description": "The text that appears above `text`. Always truncates.",
          "type": "string"
        },
        "topLabelText": {
          "description": "`TextParagraph` equivalent of `top_label`. Always truncates. Allows for\nmore complex formatting than `top_label`.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1TextParagraph"
            }
          ]
        },
        "text": {
          "description": "Required. The primary text.\n\nSupports simple formatting. For more information\nabout formatting text, see\n[Formatting text in Google Chat\napps](https://developers.google.com/workspace/chat/format-messages#card-formatting)\nand\n[Formatting\ntext in Google Workspace\nadd-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).",
          "type": "string"
        },
        "contentText": {
          "description": "`TextParagraph` equivalent of `text`. Allows for more complex formatting\nthan `text`.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1TextParagraph"
            }
          ]
        },
        "wrapText": {
          "description": "The wrap text setting. If `true`, the text wraps and displays on\nmultiple lines. Otherwise, the text is truncated.\n\nOnly applies to `text`, not `topLabel` and `bottomLabel`.",
          "type": "boolean"
        },
        "bottomLabel": {
          "description": "The text that appears below `text`. Always wraps.",
          "type": "string"
        },
        "bottomLabelText": {
          "description": "`TextParagraph` equivalent of `bottom_label`. Always wraps. Allows for\nmore complex formatting than `bottom_label`.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1TextParagraph"
            }
          ]
        },
        "onClick": {
          "description": "This action is triggered when users click anywhere on the `DecoratedText`\nwidget (including `text`, `top_label`, `bottom_label`, and icons), except\nwhen clicking a separate interactive control (`button` or\n`switch_control`).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OnClick"
            }
          ]
        },
        "button": {
          "description": "A button that a user can click to trigger an action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Button"
            }
          ]
        },
        "switchControl": {
          "description": "A switch widget that a user can click to change its state and trigger an\naction.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1DecoratedTextSwitchControl"
            }
          ]
        },
        "endIcon": {
          "description": "An icon displayed after the text.\n\nSupports\n[built-in](https://developers.google.com/workspace/chat/format-messages#builtinicons)\nand\n[custom](https://developers.google.com/workspace/chat/format-messages#customicons)\nicons.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Icon"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1Button": {
      "description": "A text, icon, or text and icon button that users can click. For an example in\nGoogle Chat apps, see\n[Add a\nbutton](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_button).\n\nTo make an image a clickable button, specify an\n`Image` (not an\n`ImageComponent`) and set an\n`onClick` action.\n\n[Google Workspace\nadd-ons and Chat apps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "text": {
          "description": "The text displayed inside the button.",
          "type": "string"
        },
        "icon": {
          "description": "An icon displayed inside the button. If both `icon` and `text` are set,\nthen the icon appears before the text.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Icon"
            }
          ]
        },
        "color": {
          "description": "Optional. The color of the button. If set, the button `type` is set to\n`FILLED` and the color of `text` and `icon` fields are set to a\ncontrasting color for readability. For example, if the button color is\nset to blue, any text or icons in the button are set to white.\n\nTo set the button color, specify a value for the `red`, `green`, and `blue`\nfields.\nThe value must be a float number between 0 and 1 based on the RGB color\nvalue, where `0` (0/255) represents the absence of color  and `1` (255/255)\nrepresents the maximum intensity of the color.\n\nFor example, the following sets the color to red at its maximum intensity:\n\n```\n\"color\": {\n   \"red\": 1,\n   \"green\": 0,\n   \"blue\": 0,\n}\n```\n\nThe `alpha` field is unavailable for button color. If specified, this field\nis ignored.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleTypeColor"
            }
          ]
        },
        "onClick": {
          "description": "Required. The action to perform when a user clicks the button, such as\nopening a hyperlink or running a custom function.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OnClick"
            }
          ]
        },
        "disabled": {
          "description": "If `true`, the button is displayed in an inactive state and doesn't respond\nto user actions.",
          "type": "boolean"
        },
        "altText": {
          "description": "The alternative text that's used for accessibility.\n\nSet descriptive text that lets users know what the button does. For\nexample, if a button opens a hyperlink, you might write: \"Opens a new\nbrowser tab and navigates to the Google Chat developer documentation at\nhttps://developers.google.com/workspace/chat\".",
          "type": "string"
        },
        "type": {
          "description": "Optional. The type of a button. If unset, button type defaults to\n`OUTLINED`. If the `color` field is set, the button type is forced to\n`FILLED` and any value set for this field is ignored.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "Outlined buttons are medium-emphasis buttons. They usually contain\nactions that are important, but aren\u2019t the primary action in a Chat app\nor an add-on.",
            "A filled button has a container with a solid color. It has the most\nvisual impact and is recommended for the important and primary action in\na Chat app or an add-on.",
            "A filled tonal button is an alternative middle ground between filled and\noutlined buttons. They\u2019re useful in contexts where a lower-priority\nbutton requires slightly more emphasis than an outline button would give.",
            "A button does not have an invisible container in its default state. It is\noften used for the lowest priority actions, especially when presenting\nmultiple options."
          ],
          "enum": [
            "TYPE_UNSPECIFIED",
            "OUTLINED",
            "FILLED",
            "FILLED_TONAL",
            "BORDERLESS"
          ]
        }
      }
    },
    "GoogleTypeColor": {
      "description": "Represents a color in the RGBA color space. This representation is designed\nfor simplicity of conversion to and from color representations in various\nlanguages over compactness. For example, the fields of this representation\ncan be trivially provided to the constructor of `java.awt.Color` in Java; it\ncan also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`\nmethod in iOS; and, with just a little work, it can be easily formatted into\na CSS `rgba()` string in JavaScript.\n\nThis reference page doesn't have information about the absolute color\nspace that should be used to interpret the RGB value\u2014for example, sRGB,\nAdobe RGB,\nDCI-P3, and BT.2020. By default, applications should assume the sRGB color\nspace.\n\nWhen color equality needs to be decided, implementations, unless documented\notherwise, treat two colors as equal if all their red, green, blue, and alpha\nvalues each differ by at most `1e-5`.\n\nExample (Java):\n\n     import com.google.type.Color;\n\n     // ...\n     public static java.awt.Color fromProto(Color protocolor) {\n       float alpha = protocolor.hasAlpha()\n           ? protocolor.getAlpha().getValue()\n           : 1.0;\n\n       return new java.awt.Color(\n           protocolor.getRed(),\n           protocolor.getGreen(),\n           protocolor.getBlue(),\n           alpha);\n     }\n\n     public static Color toProto(java.awt.Color color) {\n       float red = (float) color.getRed();\n       float green = (float) color.getGreen();\n       float blue = (float) color.getBlue();\n       float denominator = 255.0;\n       Color.Builder resultBuilder =\n           Color\n               .newBuilder()\n               .setRed(red / denominator)\n               .setGreen(green / denominator)\n               .setBlue(blue / denominator);\n       int alpha = color.getAlpha();\n       if (alpha != 255) {\n         result.setAlpha(\n             FloatValue\n                 .newBuilder()\n                 .setValue(((float) alpha) / denominator)\n                 .build());\n       }\n       return resultBuilder.build();\n     }\n     // ...\n\nExample (iOS / Obj-C):\n\n     // ...\n     static UIColor* fromProto(Color* protocolor) {\n        float red = [protocolor red];\n        float green = [protocolor green];\n        float blue = [protocolor blue];\n        FloatValue* alpha_wrapper = [protocolor alpha];\n        float alpha = 1.0;\n        if (alpha_wrapper != nil) {\n          alpha = [alpha_wrapper value];\n        }\n        return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];\n     }\n\n     static Color* toProto(UIColor* color) {\n         CGFloat red, green, blue, alpha;\n         if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {\n           return nil;\n         }\n         Color* result = [[Color alloc] init];\n         [result setRed:red];\n         [result setGreen:green];\n         [result setBlue:blue];\n         if (alpha <= 0.9999) {\n           [result setAlpha:floatWrapperWithValue(alpha)];\n         }\n         [result autorelease];\n         return result;\n    }\n    // ...\n\n Example (JavaScript):\n\n    // ...\n\n    var protoToCssColor = function(rgb_color) {\n       var redFrac = rgb_color.red || 0.0;\n       var greenFrac = rgb_color.green || 0.0;\n       var blueFrac = rgb_color.blue || 0.0;\n       var red = Math.floor(redFrac * 255);\n       var green = Math.floor(greenFrac * 255);\n       var blue = Math.floor(blueFrac * 255);\n\n       if (!('alpha' in rgb_color)) {\n          return rgbToCssColor(red, green, blue);\n       }\n\n       var alphaFrac = rgb_color.alpha.value || 0.0;\n       var rgbParams = [red, green, blue].join(',');\n       return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');\n    };\n\n    var rgbToCssColor = function(red, green, blue) {\n      var rgbNumber = new Number((red << 16) | (green << 8) | blue);\n      var hexString = rgbNumber.toString(16);\n      var missingZeros = 6 - hexString.length;\n      var resultBuilder = ['#'];\n      for (var i = 0; i < missingZeros; i++) {\n         resultBuilder.push('0');\n      }\n      resultBuilder.push(hexString);\n      return resultBuilder.join('');\n    };\n\n    // ...",
      "type": "object",
      "properties": {
        "red": {
          "description": "The amount of red in the color as a value in the interval [0, 1].",
          "type": "number",
          "format": "float"
        },
        "green": {
          "description": "The amount of green in the color as a value in the interval [0, 1].",
          "type": "number",
          "format": "float"
        },
        "blue": {
          "description": "The amount of blue in the color as a value in the interval [0, 1].",
          "type": "number",
          "format": "float"
        },
        "alpha": {
          "description": "The fraction of this color that should be applied to the pixel. That is,\nthe final pixel color is defined by the equation:\n\n  `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)`\n\nThis means that a value of 1.0 corresponds to a solid color, whereas\na value of 0.0 corresponds to a completely transparent color. This\nuses a wrapper message rather than a simple float scalar so that it is\npossible to distinguish between a default value and the value being unset.\nIf omitted, this color object is rendered as a solid color\n(as if the alpha value had been explicitly given a value of 1.0).",
          "type": "number",
          "format": "float"
        }
      }
    },
    "GoogleAppsCardV1DecoratedTextSwitchControl": {
      "description": "Either a toggle-style switch or a checkbox inside a `decoratedText` widget.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):\n\nOnly supported in the `decoratedText` widget.",
      "type": "object",
      "properties": {
        "name": {
          "description": "The name by which the switch widget is identified in a form input event\n(as the key in `CommonEventObject.form_inputs`).\n\nFor details about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).",
          "type": "string"
        },
        "value": {
          "description": "The value returned in `CommonEventObject.form_inputs[name].string_inputs`\nwhen the switch is selected (`selected` is `true`). If `selected` is\n`true` and `value` is unset, an empty string (`\"\"`) is returned in\n`string_inputs.value`. When `selected` is `false`, this value is omitted\nfrom `string_inputs.value`.\n\nFor details about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).",
          "type": "string"
        },
        "selected": {
          "description": "When `true`, the switch is selected, and its `value` is included in\n`CommonEventObject.form_inputs[name].string_inputs.value`.",
          "type": "boolean"
        },
        "onChangeAction": {
          "description": "The action to perform when the switch state is changed, such as what\n function to run.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Action"
            }
          ]
        },
        "controlType": {
          "description": "How the switch appears in the user interface.\n\n[Google Workspace add-ons\nand Chat apps](https://developers.google.com/workspace/extend):",
          "type": "string",
          "x-google-enum-descriptions": [
            "A toggle-style switch.",
            "Deprecated in favor of `CHECK_BOX`.",
            "A checkbox."
          ],
          "enum": [
            "SWITCH",
            "CHECKBOX",
            "CHECK_BOX"
          ]
        }
      }
    },
    "GoogleAppsCardV1ButtonList": {
      "description": "A list of buttons layed out horizontally. For an example in\nGoogle Chat apps, see\n[Add a\nbutton](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_button).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "buttons": {
          "description": "An array of buttons.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1Button"
          }
        }
      }
    },
    "GoogleAppsCardV1TextInput": {
      "description": "A field in which users can enter text. Supports suggestions and on-change\nactions.\nSupports form submission validation. When `Action.all_widgets_are_required`\nis set to `true` or this widget is specified in `Action.required_widgets`,\nthe submission action is blocked unless a value is entered. For an example in\nGoogle Chat apps, see [Add a field in which a user can enter\ntext](https://developers.google.com/workspace/chat/design-interactive-card-dialog#add_a_field_in_which_a_user_can_enter_text).\n\nChat apps receive and can process the value of entered text during form input\nevents. For details about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).\n\nWhen you need to collect undefined or abstract data from users,\nuse a text input. To collect defined or enumerated data from users, use the\nSelectionInput widget.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "name": {
          "description": "The name by which the text input is identified in a form input event.\n\nFor details about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).",
          "type": "string"
        },
        "label": {
          "description": "The text that appears above the text input field in the user interface.\n\nSpecify text that helps the user enter the information your app needs.\nFor example, if you are asking someone's name, but specifically need their\nsurname, write `surname` instead of `name`.\n\nRequired if `hintText` is unspecified. Otherwise, optional.",
          "type": "string"
        },
        "hintText": {
          "description": "Text that appears below the text input field meant to assist users by\nprompting them to enter a certain value. This text is always visible.\n\nRequired if `label` is unspecified. Otherwise, optional.",
          "type": "string"
        },
        "value": {
          "description": "The value entered by a user, returned as part of a form input event.\n\nFor details about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).",
          "type": "string"
        },
        "type": {
          "description": "How a text input field appears in the user interface.\nFor example, whether the field is single or multi-line.",
          "type": "string",
          "x-google-enum-descriptions": [
            "The text input field has a fixed height of one line.",
            "The text input field has a fixed height of multiple lines."
          ],
          "enum": [
            "SINGLE_LINE",
            "MULTIPLE_LINE"
          ]
        },
        "onChangeAction": {
          "description": "What to do when a change occurs in the text input field. For example, a\nuser adding to the field or deleting text.\n\nExamples of actions to take include running a custom function or opening\na [dialog](https://developers.google.com/workspace/chat/dialogs)\nin Google Chat.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Action"
            }
          ]
        },
        "initialSuggestions": {
          "description": "Suggested values that users can enter. These values appear when users click\ninside the text input field. As users type, the suggested values\ndynamically filter to match what the users have typed.\n\nFor example, a text input field for programming language might suggest\nJava, JavaScript, Python, and C++. When users start typing `Jav`, the list\nof suggestions filters to show just `Java` and `JavaScript`.\n\nSuggested values help guide users to enter values that your app can make\nsense of. When referring to JavaScript, some users might enter `javascript`\nand others `java script`. Suggesting `JavaScript` can standardize how users\ninteract with your app.\n\nWhen specified, `TextInput.type` is always `SINGLE_LINE`, even if it's set\nto `MULTIPLE_LINE`.\n\n[Google Workspace\nadd-ons and Chat apps](https://developers.google.com/workspace/extend):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Suggestions"
            }
          ]
        },
        "autoCompleteAction": {
          "description": "Optional. Specify what action to take when the text input field provides\nsuggestions to users who interact with it.\n\nIf unspecified, the suggestions are set by `initialSuggestions` and\nare processed by the client.\n\nIf specified, the app takes the action specified here, such as running\na custom function.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Action"
            }
          ]
        },
        "validation": {
          "description": "Specify the input format validation necessary for this text field.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Validation"
            }
          ]
        },
        "placeholderText": {
          "description": "Text that appears in the text input field when the field is empty.\nUse this text to prompt users to enter a value. For example, `Enter a\nnumber from 0 to 100`.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
          "type": "string"
        },
        "hostAppDataSource": {
          "description": "A data source that's unique to a Google Workspace host\napplication, such as Gmail emails, Google Calendar events, or Google\nChat messages.\n\nAvailable for Google Workspace add-ons that extend Google Workspace\nStudio. Unavailable for Google Chat apps.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupHostAppDataSourceMarkup"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1Suggestions": {
      "description": "Suggested values that users can enter. These values appear when users click\ninside the text input field. As users type, the suggested values\ndynamically filter to match what the users have typed.\n\nFor example, a text input field for programming language might suggest\nJava, JavaScript, Python, and C++. When users start typing `Jav`, the list\nof suggestions filters to show `Java` and `JavaScript`.\n\nSuggested values help guide users to enter values that your app can make\nsense of. When referring to JavaScript, some users might enter `javascript`\nand others `java script`. Suggesting `JavaScript` can standardize how users\ninteract with your app.\n\nWhen specified, `TextInput.type` is always `SINGLE_LINE`, even if it's set\nto `MULTIPLE_LINE`.\n\n[Google Workspace\nadd-ons and Chat apps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "items": {
          "description": "A list of suggestions used for autocomplete recommendations in text input\nfields.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1SuggestionsSuggestionItem"
          }
        }
      }
    },
    "GoogleAppsCardV1SuggestionsSuggestionItem": {
      "description": "One suggested value that users can enter in a text input field.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "text": {
          "description": "The value of a suggested input to a text input field. This is\nequivalent to what users enter themselves.",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1Validation": {
      "description": "Represents the necessary data for validating the widget it's attached to.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "characterLimit": {
          "description": "Specify the character limit for text input widgets.  Note that this is\nonly used for text input and is ignored for other widgets.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
          "type": "integer",
          "format": "int32"
        },
        "inputType": {
          "description": "Specify the type of the input widgets.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unspecified type. Do not use.",
            "Regular text that accepts all characters.",
            "An integer value.",
            "A float value.",
            "An email address.",
            "A emoji selected from system-provided emoji picker."
          ],
          "enum": [
            "INPUT_TYPE_UNSPECIFIED",
            "TEXT",
            "INTEGER",
            "FLOAT",
            "EMAIL",
            "EMOJI_PICKER"
          ]
        }
      }
    },
    "AppsExtensionsMarkupHostAppDataSourceMarkup": {
      "description": "A data source from a Google Workspace\napplication. The data source populates available items for a widget.",
      "type": "object",
      "properties": {
        "chatDataSource": {
          "description": "A data source from Google Chat.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupChatClientDataSourceMarkup"
            }
          ]
        },
        "workflowDataSource": {
          "description": "A data source from Google Workflow.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowDataSourceMarkup"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupChatClientDataSourceMarkup": {
      "description": "For a `SelectionInput`\nwidget that uses a multiselect menu, a data source from Google Chat. The data\nsource populates selection items for the multiselect menu. For\nexample, a user can select Google Chat spaces that they're a member of.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
      "type": "object",
      "properties": {
        "spaceDataSource": {
          "description": "Google Chat spaces that the user is a member of.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupChatClientDataSourceMarkupSpaceDataSource"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupChatClientDataSourceMarkupSpaceDataSource": {
      "description": "A data source that populates Google Chat spaces as selection items for a\nmultiselect menu. Only populates spaces that the user is a member of.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
      "type": "object",
      "properties": {
        "defaultToCurrentSpace": {
          "description": "If set to `true`, the multiselect menu selects the current\nGoogle Chat space as an item by default.",
          "type": "boolean"
        }
      }
    },
    "AppsExtensionsMarkupWorkflowDataSourceMarkup": {
      "description": "*\nOnly supported by Google Workspace Workflow, but not Google Chat apps or\nGoogle Workspace add-ons.\n\n\nIn a `TextInput`\nor `SelectionInput` widget with\nMULTI_SELECT type or a\n`DateTimePicker`, provide data source\nfrom Google.",
      "type": "object",
      "properties": {
        "includeVariables": {
          "description": "Whether to include variables from the previous step in the data source.",
          "type": "boolean"
        },
        "type": {
          "description": "The type of data source.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. Don't use.",
            "Google Workspace users. The user can only view and select users from\ntheir Google Workspace organization.",
            "Google Chat spaces that the user is a member of.",
            "Users can choose to view and select existing members from their Google\nWorkspace organization or manually enter an email address or a valid\ndomain."
          ],
          "enum": [
            "UNKNOWN",
            "USER",
            "SPACE",
            "USER_WITH_FREE_FORM"
          ]
        }
      }
    },
    "GoogleAppsCardV1SelectionInput": {
      "description": "A widget that creates one or more UI items that users can select.\nSupports form submission validation for `dropdown` and `multiselect` menus\nonly. When `Action.all_widgets_are_required` is set to `true` or this widget\nis specified in `Action.required_widgets`, the submission action is blocked\nunless a value is selected. For example, a dropdown menu or checkboxes. You\ncan use this widget to collect data that can be predicted or enumerated. For\nan example in Google Chat apps, see [Add selectable UI\nelements](/workspace/chat/design-interactive-card-dialog#add_selectable_ui_elements).\n\nChat apps can process the value of items that users select or input. For\ndetails about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).\n\nTo collect undefined or abstract data from users, use\nthe TextInput widget.\n\n[Google Workspace add-ons\nand Chat apps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "name": {
          "description": "Required. The name that identifies the selection input in a form input\nevent.\n\nFor details about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).",
          "type": "string"
        },
        "label": {
          "description": "The text that appears above the selection input field in the user\ninterface.\n\nSpecify text that helps the user enter the information your app needs.\nFor example, if users are selecting the urgency of a work ticket from a\ndrop-down menu, the label might be \"Urgency\" or \"Select urgency\".",
          "type": "string"
        },
        "type": {
          "description": "The type of items that are displayed to users in a `SelectionInput` widget.\nSelection types support different types of interactions. For example, users\ncan select one or more checkboxes, but they can only select one value from\na dropdown menu.",
          "type": "string",
          "x-google-enum-descriptions": [
            "A set of checkboxes. Users can select one or more checkboxes.",
            "A set of radio buttons. Users can select one radio button.",
            "A set of switches. Users can turn on one or more switches.",
            "A dropdown menu. Users can select one item from the menu.\n\nFor Google Chat apps, you can populate items using a dynamic data source\nand autosuggest items as users type in the menu. For example, users can\nstart typing the name of a Google Chat space and the widget autosuggests\nthe space. To dynamically populate items for a dropdown menu, use one of\nthe following types of data sources:\n\n * Google Workspace data: Items are populated using data from Google\n   Workspace, such as Google Workspace users or Google Chat spaces.\n * External data: Items are populated from an external data\n   source outside of Google Workspace.\n\nFor examples of how to implement dropdown menus for Chat apps, see\n[Add a dropdown\nmenu](https://developers.google.com/workspace/chat/design-interactive-card-dialog#dropdown-menu)\nand [Dynamically populate drop-down\nmenus](https://developers.google.com/workspace/chat/design-interactive-card-dialog#dynamic-dropdown-menu).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
            "A menu with a text box. Users can type and select one or more items.\nFor Google Workspace add-ons, you must populate items using a static\narray of `SelectionItem` objects.\n\nFor Google Chat apps, you can also populate items using a dynamic data\nsource and autosuggest items as users type in the menu. For example,\nusers can start typing the name of a Google Chat space and the widget\nautosuggests the space. To dynamically populate items for a multiselect\nmenu, use one of the following types of data sources:\n\n * Google Workspace data: Items are populated using data from Google\n   Workspace, such as Google Workspace users or Google Chat spaces.\n * External data: Items are populated from an external data\n   source outside of Google Workspace.\n\nFor examples of how to implement multiselect menus for Chat apps, see\n[Add a multiselect\nmenu](https://developers.google.com/workspace/chat/design-interactive-card-dialog#multiselect-menu).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):"
          ],
          "enum": [
            "CHECK_BOX",
            "RADIO_BUTTON",
            "SWITCH",
            "DROPDOWN",
            "MULTI_SELECT"
          ]
        },
        "items": {
          "description": "An array of selectable items. For example, an array of radio buttons or\ncheckboxes. Supports up to 100 items.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1SelectionInputSelectionItem"
          }
        },
        "onChangeAction": {
          "description": "If specified, the form is submitted when the selection changes. If not\nspecified, you must specify a separate button that submits the form.\n\nFor details about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Action"
            }
          ]
        },
        "multiSelectMaxSelectedItems": {
          "description": "For multiselect menus, the maximum number of items that a user can select.\nMinimum value is 1 item. If unspecified, defaults to 3 items.",
          "type": "integer",
          "format": "int32"
        },
        "hintText": {
          "description": "Optional. Text that appears below the selection input field meant to assist\nusers by prompting them to enter a certain value. This text is always\nvisible.\n\nAvailable for Google Workspace add-ons that extend Google Workspace\nStudio. Unavailable for Google Chat apps.",
          "type": "string"
        },
        "multiSelectMinQueryLength": {
          "description": "For multiselect menus, the number of text characters that a user inputs\nbefore the menu returns suggested selection items.\n\nIf unset, the multiselect menu uses the following default values:\n\n* If the menu uses a static array of `SelectionInput` items, defaults to\n  0 characters and immediately populates items from the array.\n* If the menu uses a dynamic data source (`multi_select_data_source`),\n defaults to 3 characters before querying the data source to return\n suggested items.",
          "type": "integer",
          "format": "int32"
        },
        "externalDataSource": {
          "description": "An external data source, such as a relational database.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Action"
            }
          ]
        },
        "platformDataSource": {
          "description": "A data source from Google Workspace.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1SelectionInputPlatformDataSource"
            }
          ]
        },
        "dataSourceConfigs": {
          "description": "Optional. The data source configs for the selection control. This field\nprovides more fine-grained control over the data source.\n\nIf specified, the `multi_select_max_selected_items` field,\n`multi_select_min_query_length` field, `external_data_source` field and\n`platform_data_source` field are ignored.\n\nAvailable for Google Workspace add-ons that extend Google Workspace\nStudio.\n\nAvailable for the\n`Dropdown\nwidget` in\nGoogle Chat apps. For the `Dropdown` widget in Google Chat apps, only one\n`DataSourceConfig` is supported. If multiple `DataSourceConfig`s are set,\nonly the first one is used.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1DataSourceConfig"
          }
        }
      }
    },
    "GoogleAppsCardV1SelectionInputSelectionItem": {
      "description": "An item that users can select in a selection input, such as a checkbox\nor switch. Supports up to 100 items.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "text": {
          "description": "The text that identifies or describes the item to users.",
          "type": "string"
        },
        "value": {
          "description": "The value associated with this item. The client should use this as a form\ninput value.\n\nFor details about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).",
          "type": "string"
        },
        "selected": {
          "description": "Whether the item is selected by default. If the selection input only\naccepts one value (such as for radio buttons or a dropdown menu), only\nset this field for one item.",
          "type": "boolean"
        },
        "startIconUri": {
          "type": "string"
        },
        "bottomText": {
          "description": "For multiselect menus, a text description or label that's\ndisplayed below the item's `text` field.",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1SelectionInputPlatformDataSource": {
      "description": "For a\n`SelectionInput` widget that uses a\nmultiselect menu, a data source from Google Workspace. Used to populate\nitems in a multiselect menu.\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
      "type": "object",
      "properties": {
        "commonDataSource": {
          "description": "A data source shared by all Google Workspace applications, such as\nusers in a Google Workspace organization.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. Don't use.",
            "Google Workspace users. The user can only view and select users from\ntheir Google Workspace organization."
          ],
          "enum": [
            "UNKNOWN",
            "USER"
          ]
        },
        "hostAppDataSource": {
          "description": "A data source that's unique to a Google Workspace host\napplication, such spaces in Google Chat.\n\nThis field supports the Google API Client Libraries but isn't available\nin the Cloud Client Libraries. To learn more, see\n[Install the client\nlibraries](https://developers.google.com/workspace/chat/libraries).",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupHostAppDataSourceMarkup"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1DataSourceConfig": {
      "description": "A configuration object that helps configure the data sources for a widget.\n\nAvailable for Google Chat apps and Google Workspace add-ons that extend\nGoogle Workspace Studio.",
      "type": "object",
      "properties": {
        "remoteDataSource": {
          "description": "The data is from a remote data provider.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Action"
            }
          ]
        },
        "platformDataSource": {
          "description": "The data is from a Google Workspace application.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1SelectionInputPlatformDataSource"
            }
          ]
        },
        "minCharactersTrigger": {
          "description": "The minimum number of characters the user must enter before\nthis data provider is triggered (i.e., before it starts returning results).",
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleAppsCardV1DateTimePicker": {
      "description": "Lets users input a date, a time, or both a date and a time.\nSupports form submission validation. When `Action.all_widgets_are_required`\nis set to `true` or this widget is specified in `Action.required_widgets`,\nthe submission action is blocked unless a value is selected. For an example\nin Google Chat apps, see [Let a user pick a date and\ntime](https://developers.google.com/workspace/chat/design-interactive-card-dialog#let_a_user_pick_a_date_and_time).\n\nUsers can input text or use the picker to select dates and times. If users\ninput an invalid date or time, the picker shows an error that prompts users\nto input the information correctly.\n\n[Google Workspace\nadd-ons and Chat apps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "name": {
          "description": "The name by which the `DateTimePicker` is identified in a form input event.\n\nFor details about working with form inputs, see [Receive form\ndata](https://developers.google.com/workspace/chat/read-form-data).",
          "type": "string"
        },
        "label": {
          "description": "The text that prompts users to input a date, a time, or a date and time.\nFor example, if users are scheduling an appointment, use a label such as\n`Appointment date` or `Appointment date and time`.",
          "type": "string"
        },
        "type": {
          "description": "Whether the widget supports inputting a date, a time, or the date and time.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Users input a date and time.",
            "Users input a date.",
            "Users input a time."
          ],
          "enum": [
            "DATE_AND_TIME",
            "DATE_ONLY",
            "TIME_ONLY"
          ]
        },
        "valueMsEpoch": {
          "description": "The default value displayed in the widget, in milliseconds since [Unix\nepoch time](https://en.wikipedia.org/wiki/Unix_time).\n\nSpecify the value based on the type of picker (`DateTimePickerType`):\n\n* `DATE_AND_TIME`: a calendar date and time in UTC. For example, to\n  represent January 1, 2023 at 12:00 PM UTC, use `1672574400000`.\n* `DATE_ONLY`: a calendar date at 00:00:00 UTC. For example, to represent\n  January 1, 2023, use `1672531200000`.\n* `TIME_ONLY`: a time in UTC. For example, to represent 12:00 PM, use\n  `43200000` (or `12 * 60 * 60 * 1000`).",
          "type": "string",
          "format": "int64"
        },
        "timezoneOffsetDate": {
          "description": "The number representing the time zone offset from UTC, in minutes.\nIf set, the `value_ms_epoch` is displayed in the specified time zone.\nIf unset, the value defaults to the user's time zone setting.\n\nNote: This field is in minutes, whereas user interaction event payloads\ntypically provide time zone offsets in milliseconds (divide by `60000` to\nconvert).",
          "type": "integer",
          "format": "int32"
        },
        "onChangeAction": {
          "description": "Triggered when the user clicks **Save** or **Clear** from the\n`DateTimePicker` interface.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Action"
            }
          ]
        },
        "hostAppDataSource": {
          "description": "A data source that's unique to a Google Workspace host\napplication, such as Gmail emails, Google Calendar events, or Google\nChat messages.\n\nAvailable for Google Workspace add-ons that extend Google Workspace\nStudio. Unavailable for Google Chat apps.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupHostAppDataSourceMarkup"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1Divider": {
      "description": "Displays a divider between widgets as a horizontal line. For an example in\nGoogle Chat apps, see\n[Add a horizontal divider between\nwidgets](https://developers.google.com/workspace/chat/format-structure-card-dialog#add_a_horizontal_divider_between_widgets).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):\n\nFor example, the following JSON creates a divider:\n\n```\n\"divider\": {}\n```",
      "type": "object"
    },
    "GoogleAppsCardV1Grid": {
      "description": "Displays a grid with a collection of items. Items can only include text or\nimages. For responsive columns, or to include more than text or images, use\n`Columns`. For an example in Google Chat apps,\nsee [Display a Grid with a collection of\nitems](https://developers.google.com/workspace/chat/format-structure-card-dialog#display_a_grid_with_a_collection_of_items).\n\nA grid supports any number of columns and items. The number of rows is\ndetermined by items divided by columns. A grid with\n10 items and 2 columns has 5 rows. A grid with 11 items and 2 columns\nhas 6 rows.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):\n\nFor example, the following JSON creates a 2 column grid with a single\nitem:\n\n```\n\"grid\": {\n  \"title\": \"A fine collection of items\",\n  \"columnCount\": 2,\n  \"borderStyle\": {\n    \"type\": \"STROKE\",\n    \"cornerRadius\": 4\n  },\n  \"items\": [\n    {\n      \"image\": {\n        \"imageUri\": \"https://www.example.com/image.png\",\n        \"cropStyle\": {\n          \"type\": \"SQUARE\"\n        },\n        \"borderStyle\": {\n          \"type\": \"STROKE\"\n        }\n      },\n      \"title\": \"An item\",\n      \"textAlignment\": \"CENTER\"\n    }\n  ],\n  \"onClick\": {\n    \"openLink\": {\n      \"url\": \"https://www.example.com\"\n    }\n  }\n}\n```",
      "type": "object",
      "properties": {
        "title": {
          "description": "The text that displays in the grid header.",
          "type": "string"
        },
        "items": {
          "description": "The items to display in the grid.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1GridGridItem"
          }
        },
        "borderStyle": {
          "description": "The border style to apply to each grid item.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1BorderStyle"
            }
          ]
        },
        "columnCount": {
          "description": "The number of columns to display in the grid. A default value\nis used if this field isn't specified, and that default value is\ndifferent depending on where the grid is shown (dialog versus companion).",
          "type": "integer",
          "format": "int32"
        },
        "onClick": {
          "description": "This callback is reused by each individual grid item, but with the\nitem's identifier added to the callback's parameters (under the key\n`\"grid_item_identifier\"`).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OnClick"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1GridGridItem": {
      "description": "Represents an item in a grid layout. Items can contain text, an image, or\nboth text and an image.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "id": {
          "description": "A user-specified identifier for this grid item. This identifier is\nreturned in the parent grid's `onClick` callback parameters.",
          "type": "string"
        },
        "image": {
          "description": "The image that displays in the grid item.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ImageComponent"
            }
          ]
        },
        "title": {
          "description": "The grid item's title.",
          "type": "string"
        },
        "subtitle": {
          "description": "The grid item's subtitle.",
          "type": "string"
        },
        "layout": {
          "description": "The layout to use for the grid item.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "The title and subtitle are shown below the grid item's image.",
            "The title and subtitle are shown above the grid item's image."
          ],
          "enum": [
            "GRID_ITEM_LAYOUT_UNSPECIFIED",
            "TEXT_BELOW",
            "TEXT_ABOVE"
          ]
        }
      }
    },
    "GoogleAppsCardV1ImageComponent": {
      "description": "Represents an image.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "imageUri": {
          "description": "The image URL.",
          "type": "string"
        },
        "altText": {
          "description": "The accessibility label for the image.",
          "type": "string"
        },
        "cropStyle": {
          "description": "The crop style to apply to the image.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ImageCropStyle"
            }
          ]
        },
        "borderStyle": {
          "description": "The border style to apply to the image.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1BorderStyle"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1ImageCropStyle": {
      "description": "Represents the crop style applied to an image.\n\n[Google Workspace add-ons and\nChat apps](https://developers.google.com/workspace/extend):\n\nFor example, here's how to apply a 16:9 aspect ratio:\n\n```\ncropStyle {\n \"type\": \"RECTANGLE_CUSTOM\",\n \"aspectRatio\": 16/9\n}\n```",
      "type": "object",
      "properties": {
        "type": {
          "description": "The crop type.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "Default value. Applies a square crop.",
            "Applies a circular crop.",
            "Applies a rectangular crop with a custom aspect ratio. Set the custom\naspect ratio with `aspectRatio`.",
            "Applies a rectangular crop with a 4:3 aspect ratio."
          ],
          "enum": [
            "IMAGE_CROP_TYPE_UNSPECIFIED",
            "SQUARE",
            "CIRCLE",
            "RECTANGLE_CUSTOM",
            "RECTANGLE_4_3"
          ]
        },
        "aspectRatio": {
          "description": "The aspect ratio to use if the crop type is `RECTANGLE_CUSTOM`.\n\nFor example, here's how to apply a 16:9 aspect ratio:\n\n```\ncropStyle {\n \"type\": \"RECTANGLE_CUSTOM\",\n \"aspectRatio\": 16/9\n}\n```",
          "type": "number",
          "format": "double"
        }
      }
    },
    "GoogleAppsCardV1BorderStyle": {
      "description": "The style options for the border of a card or widget, including the border\ntype and color.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "type": {
          "description": "The border type.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "No border.",
            "Default value. Outline."
          ],
          "enum": [
            "BORDER_TYPE_UNSPECIFIED",
            "NO_BORDER",
            "STROKE"
          ]
        },
        "strokeColor": {
          "description": "The colors to use when the type is `BORDER_TYPE_STROKE`.\n\nTo set the stroke color, specify a value for the `red`, `green`, and `blue`\nfields.\nThe value must be a float number between 0 and 1 based on the RGB color\nvalue, where `0` (0/255) represents the absence of color  and `1` (255/255)\nrepresents the maximum intensity of the color.\n\nFor example, the following sets the color to red at its maximum intensity:\n\n```\n\"color\": {\n   \"red\": 1,\n   \"green\": 0,\n   \"blue\": 0,\n}\n```\n\nThe `alpha` field is unavailable for stroke color. If specified, this field\nis ignored.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleTypeColor"
            }
          ]
        },
        "cornerRadius": {
          "description": "The corner radius for the border.",
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleAppsCardV1Columns": {
      "description": "The `Columns` widget displays up to 2 columns in a card or dialog. You can\nadd widgets to each column; the widgets appear in the order that they are\nspecified. For an example in Google Chat apps, see\n[Display cards and dialogs in\ncolumns](https://developers.google.com/workspace/chat/format-structure-card-dialog#display_cards_and_dialogs_in_columns).\n\nThe height of each column is determined by the taller column. For example, if\nthe first column is taller than the second column, both columns have the\nheight of the first column. Because each column can contain a different\nnumber of widgets, you can't define rows or align widgets between the\ncolumns.\n\nColumns are displayed side-by-side. You can customize the width of each\ncolumn using the `HorizontalSizeStyle` field. If the user's\nscreen width is too narrow, the second column wraps below the first:\n\n* On web, the second column wraps if the screen width is less than or equal\n  to 480 pixels.\n* On iOS devices, the second column wraps if the screen width is\n  less than or equal to 300 pt.\n* On Android devices, the second column wraps if the screen width is\n  less than or equal to 320 dp.\n\nTo include more than two columns, or to use rows, use the\n`Grid` widget.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):\nThe add-on UIs that support columns include:\n\n* The dialog displayed when users open the add-on from an email draft.\n* The dialog displayed when users open the add-on from the\n**Add attachment** menu in a Google Calendar event.",
      "type": "object",
      "properties": {
        "columnItems": {
          "description": "An array of columns. You can include up to 2 columns in a card or dialog.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1ColumnsColumn"
          }
        }
      }
    },
    "GoogleAppsCardV1ColumnsColumn": {
      "description": "A column.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend)",
      "type": "object",
      "properties": {
        "horizontalSizeStyle": {
          "description": "Specifies how a column fills the width of the card.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "Default value. Column fills the available space, up to 70% of the\ncard's width. If both columns are set to `FILL_AVAILABLE_SPACE`, each\ncolumn fills 50% of the space.",
            "Column fills the least amount of space possible and no more than 30% of\nthe card's width."
          ],
          "enum": [
            "HORIZONTAL_SIZE_STYLE_UNSPECIFIED",
            "FILL_AVAILABLE_SPACE",
            "FILL_MINIMUM_SPACE"
          ]
        },
        "horizontalAlignment": {
          "description": "Specifies whether widgets align to the left, right, or center of a\ncolumn.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "Default value. Aligns widgets to the start position of the column. For\nleft-to-right layouts, aligns to the left. For right-to-left layouts,\naligns to the right.",
            "Aligns widgets to the center of the column.",
            "Aligns widgets to the end position of the column. For left-to-right\nlayouts, aligns widgets to the right. For right-to-left layouts, aligns\nwidgets to the left."
          ],
          "enum": [
            "HORIZONTAL_ALIGNMENT_UNSPECIFIED",
            "START",
            "CENTER",
            "END"
          ]
        },
        "verticalAlignment": {
          "description": "Specifies whether widgets align to the top, bottom, or center of a\ncolumn.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "Default value. Aligns widgets to the center of a column.",
            "Aligns widgets to the top of a column.",
            "Aligns widgets to the bottom of a column."
          ],
          "enum": [
            "VERTICAL_ALIGNMENT_UNSPECIFIED",
            "CENTER",
            "TOP",
            "BOTTOM"
          ]
        },
        "widgets": {
          "description": "An array of widgets included in a column. Widgets appear in the order\nthat they are specified.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1ColumnsColumnWidgets"
          }
        }
      }
    },
    "GoogleAppsCardV1ColumnsColumnWidgets": {
      "description": "The supported widgets that you can include in a column.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend)",
      "type": "object",
      "properties": {
        "textParagraph": {
          "description": "TextParagraph widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1TextParagraph"
            }
          ]
        },
        "image": {
          "description": "Image widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Image"
            }
          ]
        },
        "decoratedText": {
          "description": "DecoratedText widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1DecoratedText"
            }
          ]
        },
        "buttonList": {
          "description": "ButtonList widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ButtonList"
            }
          ]
        },
        "textInput": {
          "description": "TextInput widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1TextInput"
            }
          ]
        },
        "selectionInput": {
          "description": "SelectionInput widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1SelectionInput"
            }
          ]
        },
        "dateTimePicker": {
          "description": "DateTimePicker widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1DateTimePicker"
            }
          ]
        },
        "chipList": {
          "description": "ChipList widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ChipList"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1ChipList": {
      "description": "A list of chips layed out horizontally, which can either scroll horizontally\nor wrap to the next line.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "layout": {
          "description": "Specified chip list layout.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "Default value. The chip list wraps to the next line if there isn't enough\nhorizontal space.",
            "The chips scroll horizontally if they don't fit in the available space."
          ],
          "enum": [
            "LAYOUT_UNSPECIFIED",
            "WRAPPED",
            "HORIZONTAL_SCROLLABLE"
          ]
        },
        "chips": {
          "description": "An array of chips.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1Chip"
          }
        }
      }
    },
    "GoogleAppsCardV1Chip": {
      "description": "A text, icon, or text and icon chip that users can click.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "icon": {
          "description": "The icon image. If both `icon` and `label` are set, then the icon appears\nbefore the label.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Icon"
            }
          ]
        },
        "label": {
          "description": "The text displayed inside the chip.",
          "type": "string"
        },
        "onClick": {
          "description": "Optional. The action to perform when a user clicks the chip, such as\nopening a hyperlink or running a custom function.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OnClick"
            }
          ]
        },
        "enabled": {
          "description": "Deprecated: Use `disabled` instead.\n\nWhether the chip is in an active state and responds to user actions.",
          "deprecated": true,
          "type": "boolean"
        },
        "disabled": {
          "description": "Whether the chip is in an inactive state and ignores user actions.\nDefaults to `false`.",
          "type": "boolean"
        },
        "altText": {
          "description": "The alternative text that's used for accessibility.\n\nSet descriptive text that lets users know what the chip does. For\nexample, if a chip opens a hyperlink, write: \"Opens a new\nbrowser tab and navigates to the Google Chat developer documentation at\nhttps://developers.google.com/workspace/chat\".",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1Carousel": {
      "description": "Rotates and displays a list of carousel cards in a slideshow format, with\nbuttons navigating to the previous or next card.\n\nFor example, this is a JSON representation of a carousel that contains three\ntext paragraph widgets.\n\n```\n{\n  \"carouselCards\": [\n    {\n      \"widgets\": [\n        {\n          \"textParagraph\": {\n            \"text\": \"First text paragraph in carousel\"\n          }\n        }\n      ]\n    },\n    {\n      \"widgets\": [\n        {\n          \"textParagraph\": {\n            \"text\": \"Second text paragraph in carousel\"\n          }\n        }\n      ]\n    },\n    {\n      \"widgets\": [\n        {\n          \"textParagraph\": {\n            \"text\": \"Third text paragraph in carousel\"\n          }\n        }\n      ]\n    }\n  ]\n}\n```\n\n[Google Chat apps](https://developers.google.com/workspace/chat):",
      "type": "object",
      "properties": {
        "carouselCards": {
          "description": "A list of cards included in the carousel.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1CarouselCarouselCard"
          }
        }
      }
    },
    "GoogleAppsCardV1CarouselCarouselCard": {
      "description": "A card that can be displayed as a carousel item.\n[Google Chat apps](https://developers.google.com/workspace/chat):",
      "type": "object",
      "properties": {
        "widgets": {
          "description": "A list of widgets displayed in the carousel card. The widgets are\ndisplayed in the order that they are specified.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1CardNestedWidget"
          }
        },
        "footerWidgets": {
          "description": "A list of widgets displayed at the bottom of the carousel card. The\nwidgets are displayed in the order that they are specified.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1CardNestedWidget"
          }
        }
      }
    },
    "GoogleAppsCardV1CardNestedWidget": {
      "description": "A list of widgets that can be displayed in a containing layout, such\nas a `CarouselCard`.\n[Google Chat apps](https://developers.google.com/workspace/chat):",
      "type": "object",
      "properties": {
        "textParagraph": {
          "description": "A text paragraph widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1TextParagraph"
            }
          ]
        },
        "buttonList": {
          "description": "A button list widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ButtonList"
            }
          ]
        },
        "image": {
          "description": "An image widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Image"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1EventAction": {
      "description": "Represents an actionthat can be performed on an ui element.\n\nAvailable for Google Workspace add-ons that extend Google Workspace Studio.\nUnavailable for Google Chat apps.",
      "type": "object",
      "properties": {
        "actionRuleId": {
          "description": "The unique identifier of the ActionRule.",
          "type": "string"
        },
        "postEventTriggers": {
          "description": "The list of triggers that will be triggered after the EventAction is\nexecuted.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1Trigger"
          }
        },
        "commonWidgetAction": {
          "description": "Common widget action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1EventActionCommonWidgetAction"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1Trigger": {
      "description": "Represents a trigger.\n\nAvailable for Google Workspace add-ons that extend Google Workspace Studio.\nUnavailable for Google Chat apps.",
      "type": "object",
      "properties": {
        "actionRuleId": {
          "description": "The unique identifier of the ActionRule.",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1EventActionCommonWidgetAction": {
      "description": "Represents an action that is not specific to a widget.\n\nAvailable for Google Workspace add-ons that extend Google Workspace\nStudio. Unavailable for Google Chat apps.",
      "type": "object",
      "properties": {
        "updateVisibilityAction": {
          "description": "The action to update the visibility of a widget.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1EventActionCommonWidgetActionUpdateVisibilityAction"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1EventActionCommonWidgetActionUpdateVisibilityAction": {
      "description": "Represents an action that updates the visibility of a widget.\n\nAvailable for Google Workspace add-ons that extend Google Workspace\nStudio. Unavailable for Google Chat apps.",
      "type": "object",
      "properties": {
        "visibility": {
          "description": "The new visibility.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unspecified visibility. Do not use.",
            "The UI element is visible.",
            "The UI element is hidden."
          ],
          "enum": [
            "VISIBILITY_UNSPECIFIED",
            "VISIBLE",
            "HIDDEN"
          ]
        }
      }
    },
    "GoogleAppsCardV1CollapseControl": {
      "description": "Represent an expand and collapse control.\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "horizontalAlignment": {
          "description": "The horizontal alignment of the expand and collapse button.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Don't use. Unspecified.",
            "Default value. Aligns widgets to the start position of the column. For\nleft-to-right layouts, aligns to the left. For right-to-left layouts,\naligns to the right.",
            "Aligns widgets to the center of the column.",
            "Aligns widgets to the end position of the column. For left-to-right\nlayouts, aligns widgets to the right. For right-to-left layouts, aligns\nwidgets to the left."
          ],
          "enum": [
            "HORIZONTAL_ALIGNMENT_UNSPECIFIED",
            "START",
            "CENTER",
            "END"
          ]
        },
        "expandButton": {
          "description": "Optional. Define a customizable button to expand the section.\nBoth expand_button and collapse_button field must be set. Only one\nfield set will not take into effect.\nIf this field isn't set, the default button is used.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Button"
            }
          ]
        },
        "collapseButton": {
          "description": "Optional. Define a customizable button to collapse the section.\nBoth expand_button and collapse_button field must be set. Only one\nfield set will not take into effect.\nIf this field isn't set, the default button is used.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Button"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1CardCardAction": {
      "description": "A card action is the action associated with the card. For example,\nan invoice card might include actions such as delete invoice, email\ninvoice, or open the invoice in a browser.\n\n[Google Workspace\nadd-ons](https://developers.google.com/workspace/add-ons):",
      "type": "object",
      "properties": {
        "actionLabel": {
          "description": "The label that displays as the action menu item.",
          "type": "string"
        },
        "onClick": {
          "description": "The `onClick` action for this action item.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OnClick"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1CardCardFixedFooter": {
      "description": "A persistent (sticky) footer that that appears at the bottom of the card.\n\nSetting `fixedFooter` without specifying a `primaryButton` or a\n`secondaryButton` causes an error.\n\nFor Chat apps, you can use fixed footers in\n[dialogs](https://developers.google.com/workspace/chat/dialogs), but not\n[card\nmessages](https://developers.google.com/workspace/chat/create-messages#create).\nFor an example in Google Chat apps, see [Add a persistent\nfooter](https://developers.google.com/workspace/chat/design-components-card-dialog#add_a_persistent_footer).\n\n[Google Workspace add-ons and Chat\napps](https://developers.google.com/workspace/extend):",
      "type": "object",
      "properties": {
        "primaryButton": {
          "description": "The primary button of the fixed footer. The button must be a text button\nwith text and color set.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Button"
            }
          ]
        },
        "secondaryButton": {
          "description": "The secondary button of the fixed footer.  The button must be a text\nbutton with text and color set.\nIf `secondaryButton` is set, you must also set `primaryButton`.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Button"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1ExpressionData": {
      "description": "Represents the data that is used to evaluate an expression.\n\nAvailable for Google Workspace add-ons that extend Google Workspace Studio.\nUnavailable for Google Chat apps.",
      "type": "object",
      "properties": {
        "id": {
          "description": "The unique identifier of the ExpressionData.",
          "type": "string"
        },
        "expression": {
          "description": "The uncompiled expression.",
          "type": "string"
        },
        "conditions": {
          "description": "The list of conditions that are determined by the expression evaluation\nresult.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1Condition"
          }
        },
        "eventActions": {
          "description": "The list of actions that the ExpressionData can be used.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1EventAction"
          }
        }
      }
    },
    "GoogleAppsCardV1Condition": {
      "description": "Represents a condition that can be used to trigger an action.\n\nAvailable for Google Workspace add-ons that extend Google Workspace Studio.\nUnavailable for Google Chat apps.",
      "type": "object",
      "properties": {
        "actionRuleId": {
          "description": "The unique identifier of the ActionRule.",
          "type": "string"
        },
        "expressionDataCondition": {
          "description": "The condition that is determined by the expression data.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ConditionExpressionDataCondition"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1ConditionExpressionDataCondition": {
      "description": "Represents a condition that is evaluated using CEL.\n\nAvailable for Google Workspace add-ons that extend Google Workspace\nStudio. Unavailable for Google Chat apps.",
      "type": "object",
      "properties": {
        "conditionType": {
          "description": "The type of the condition.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unspecified condition type.",
            "The expression evaluation was successful.",
            "The expression evaluation was unsuccessful."
          ],
          "enum": [
            "CONDITION_TYPE_UNSPECIFIED",
            "EXPRESSION_EVALUATION_SUCCESS",
            "EXPRESSION_EVALUATION_FAILURE"
          ]
        }
      }
    },
    "GoogleChatV1Annotation": {
      "description": "Annotations can be associated with the plain-text body of the message or\nwith chips that link to Google Workspace resources like Google Docs or Sheets\nwith `start_index` and `length` of 0. To add basic formatting to a text\nmessage, see [Format text\nmessages](https://developers.google.com/workspace/chat/format-messages).\n\nExample plain-text message body:\n```\nHello @FooBot how are you!\"\n```\n\nThe corresponding annotations metadata:\n```\n\"annotations\":[{\n  \"type\":\"USER_MENTION\",\n  \"startIndex\":6,\n  \"length\":7,\n  \"userMention\": {\n    \"user\": {\n      \"name\":\"users/{user}\",\n      \"displayName\":\"FooBot\",\n      \"avatarUrl\":\"https://goo.gl/aeDtrS\",\n      \"type\":\"BOT\"\n    },\n    \"type\":\"MENTION\"\n   }\n}]\n```",
      "type": "object",
      "properties": {
        "type": {
          "description": "The type of this annotation.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1AnnotationType"
            }
          ]
        },
        "startIndex": {
          "description": "Start index (0-based, inclusive) in the plain-text message body this\nannotation corresponds to.",
          "type": "integer",
          "format": "int32"
        },
        "length": {
          "description": "Length of the substring in the plain-text message body this annotation\ncorresponds to. If not present, indicates a length of 0.",
          "type": "integer",
          "format": "int32"
        },
        "userMention": {
          "description": "The metadata of user mention.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1UserMentionMetadata"
            }
          ]
        },
        "slashCommand": {
          "description": "The metadata for a slash command.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SlashCommandMetadata"
            }
          ]
        },
        "richLinkMetadata": {
          "description": "The metadata for a rich link.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1RichLinkMetadata"
            }
          ]
        },
        "customEmojiMetadata": {
          "description": "The metadata for a custom emoji.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1CustomEmojiMetadata"
            }
          ]
        }
      }
    },
    "GoogleChatV1UserMentionMetadata": {
      "description": "Annotation metadata for user mentions (@).",
      "type": "object",
      "properties": {
        "user": {
          "description": "The user mentioned.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1User"
            }
          ]
        },
        "type": {
          "description": "The type of user mention.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value for the enum. Don't use.",
            "Add user to space.",
            "Mention user in space."
          ],
          "enum": [
            "TYPE_UNSPECIFIED",
            "ADD",
            "MENTION"
          ]
        }
      }
    },
    "GoogleChatV1SlashCommandMetadata": {
      "description": "Annotation metadata for slash commands (/).",
      "type": "object",
      "properties": {
        "bot": {
          "description": "The Chat app whose command was invoked.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1User"
            }
          ]
        },
        "type": {
          "description": "The type of slash command.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value for the enum. Don't use.",
            "Add Chat app to space.",
            "Invoke slash command in space."
          ],
          "enum": [
            "TYPE_UNSPECIFIED",
            "ADD",
            "INVOKE"
          ]
        },
        "commandName": {
          "description": "The name of the invoked slash command.",
          "type": "string"
        },
        "commandId": {
          "description": "The command ID of the invoked slash command.",
          "type": "string",
          "format": "int64"
        },
        "triggersDialog": {
          "description": "Indicates whether the slash command is for a dialog.",
          "type": "boolean"
        }
      }
    },
    "GoogleChatV1RichLinkMetadata": {
      "description": "A rich link to a resource. Rich links can be associated with the plain-text\nbody of the message or represent chips that link to Google Workspace\nresources like Google Docs or Sheets with `start_index` and `length`\nof 0.",
      "type": "object",
      "properties": {
        "uri": {
          "description": "The URI of this link.",
          "type": "string"
        },
        "richLinkType": {
          "description": "The rich link type.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value for the enum. Don't use.",
            "A Google Drive rich link type.",
            "A Chat space rich link type. For example, a space smart chip.",
            "A Gmail message rich link type. Specifically, a Gmail chip from [Share to\nChat](https://support.google.com/chat?p=chat_gmail). The API only\nsupports reading messages with GMAIL_MESSAGE rich links.",
            "A Meet message rich link type. For example, a Meet chip.",
            "A Calendar message rich link type. For example, a Calendar chip."
          ],
          "enum": [
            "RICH_LINK_TYPE_UNSPECIFIED",
            "DRIVE_FILE",
            "CHAT_SPACE",
            "GMAIL_MESSAGE",
            "MEET_SPACE",
            "CALENDAR_EVENT"
          ]
        },
        "driveLinkData": {
          "description": "Data for a drive link.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1DriveLinkData"
            }
          ]
        },
        "chatSpaceLinkData": {
          "description": "Data for a chat space link.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1ChatSpaceLinkData"
            }
          ]
        },
        "meetSpaceLinkData": {
          "description": "Data for a Meet space link.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1MeetSpaceLinkData"
            }
          ]
        },
        "calendarEventLinkData": {
          "description": "Data for a Calendar event link.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1CalendarEventLinkData"
            }
          ]
        }
      }
    },
    "GoogleChatV1DriveLinkData": {
      "description": "Data for Google Drive links.",
      "type": "object",
      "properties": {
        "driveDataRef": {
          "description": "A\n[DriveDataRef](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments#drivedataref)\nwhich references a Google Drive file.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1DriveDataRef"
            }
          ]
        },
        "mimeType": {
          "description": "The mime type of the linked Google Drive resource.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1DriveDataRef": {
      "description": "A reference to the data of a drive attachment.",
      "type": "object",
      "properties": {
        "driveFileId": {
          "description": "The ID for the drive file. Use with the Drive API.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1ChatSpaceLinkData": {
      "description": "Data for Chat space links.",
      "type": "object",
      "properties": {
        "space": {
          "description": "The space of the linked Chat space resource.\n\nFormat: `spaces/{space}`",
          "type": "string"
        },
        "thread": {
          "description": "The thread of the linked Chat space resource.\n\nFormat: `spaces/{space}/threads/{thread}`",
          "type": "string"
        },
        "message": {
          "description": "The message of the linked Chat space resource.\n\nFormat: `spaces/{space}/messages/{message}`",
          "type": "string"
        }
      }
    },
    "GoogleChatV1MeetSpaceLinkData": {
      "description": "Data for Meet space links.",
      "type": "object",
      "properties": {
        "meetingCode": {
          "description": "Meeting code of the linked Meet space.",
          "type": "string"
        },
        "type": {
          "description": "Indicates the type of the Meet space.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value for the enum. Don't use.",
            "The Meet space is a meeting.",
            "The Meet space is a huddle."
          ],
          "enum": [
            "TYPE_UNSPECIFIED",
            "MEETING",
            "HUDDLE"
          ]
        },
        "huddleStatus": {
          "description": "Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle.\nOtherwise, this is unset.",
          "readOnly": true,
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value for the enum. Don't use.",
            "The huddle has started.",
            "The huddle has ended. In this case the Meet space URI and identifiers\nwill no longer be valid.",
            "The huddle has been missed. In this case the Meet space URI and\nidentifiers will no longer be valid."
          ],
          "enum": [
            "HUDDLE_STATUS_UNSPECIFIED",
            "STARTED",
            "ENDED",
            "MISSED"
          ]
        }
      }
    },
    "GoogleChatV1CalendarEventLinkData": {
      "description": "Data for Calendar event links.",
      "type": "object",
      "properties": {
        "calendarId": {
          "description": "The [Calendar\nidentifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars)\nof the linked Calendar.",
          "type": "string"
        },
        "eventId": {
          "description": "The [Event\nidentifier](https://developers.google.com/workspace/calendar/api/v3/reference/events)\nof the linked Calendar event.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1CustomEmojiMetadata": {
      "description": "Annotation metadata for custom emoji.",
      "type": "object",
      "properties": {
        "customEmoji": {
          "description": "The custom emoji.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1CustomEmoji"
            }
          ]
        }
      }
    },
    "GoogleChatV1CustomEmoji": {
      "description": "Represents a [custom emoji](https://support.google.com/chat/answer/12800149).",
      "type": "object",
      "properties": {
        "name": {
          "description": "Identifier. The resource name of the custom emoji, assigned by the server.\n\nFormat: `customEmojis/{customEmoji}`",
          "x-google-identifier": true,
          "type": "string"
        },
        "uid": {
          "description": "Output only. Unique key for the custom emoji resource.",
          "readOnly": true,
          "type": "string"
        },
        "emojiName": {
          "description": "Optional. Immutable. User-provided name for the custom emoji, which is unique within the\norganization.\n\nRequired when the custom emoji is created, output only otherwise.\n\nEmoji names must start and end with colons, must be lowercase and can only\ncontain alphanumeric characters, hyphens, and underscores.\nHyphens and underscores should be used to separate words and cannot be used\nconsecutively.\n\nExample: `:valid-emoji-name:`",
          "x-google-immutable": true,
          "type": "string"
        },
        "temporaryImageUri": {
          "description": "Output only. A temporary image URL for the custom emoji, valid for at least\n10 minutes. Note that this is not populated in the response when the custom\nemoji is created.",
          "readOnly": true,
          "type": "string"
        },
        "payload": {
          "description": "Optional. Input only. Payload data.\nRequired when the custom emoji is created.",
          "writeOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1CustomEmojiCustomEmojiPayload"
            }
          ]
        }
      }
    },
    "GoogleChatV1CustomEmojiCustomEmojiPayload": {
      "description": "Payload data for the custom emoji.",
      "type": "object",
      "properties": {
        "fileContent": {
          "description": "Required. Input only. The image used for the custom emoji.\n\nThe payload must be under 256 KB and the dimension of\nthe image must be square and between 64 and 500 pixels. The\nrestrictions are subject to change.",
          "writeOnly": true,
          "type": "string",
          "format": "byte"
        },
        "filename": {
          "description": "Required. Input only. The image file name.\n\nSupported file extensions: `.png`, `.jpg`, `.gif`.",
          "writeOnly": true,
          "type": "string"
        }
      },
      "required": [
        "fileContent",
        "filename"
      ]
    },
    "GoogleChatV1Thread": {
      "description": "A thread in a Google Chat space. For example usage, see\n[Start or reply to a message\nthread](https://developers.google.com/workspace/chat/create-messages#create-message-thread).\n\nIf you specify a thread when creating a message, you can set the\n[`messageReplyOption`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#messagereplyoption)\nfield to determine what happens if no matching thread is found.",
      "type": "object",
      "properties": {
        "name": {
          "description": "Identifier. Resource name of the thread.\n\nExample: `spaces/{space}/threads/{thread}`",
          "x-google-identifier": true,
          "type": "string"
        },
        "threadKey": {
          "description": "Optional. Input for creating or updating a thread. Otherwise, output only.\nID for the thread. Supports up to 4000 characters.\n\nThis ID is unique to the Chat app that sets it. For example, if\nmultiple Chat apps create a message using the same thread key,\nthe messages are posted in different threads. To reply in a\nthread created by a person or another Chat app, specify the thread `name`\nfield instead.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1ActionResponse": {
      "description": "Parameters that a Chat app can use to configure how its response is posted.",
      "type": "object",
      "properties": {
        "type": {
          "description": "Input only. The type of Chat app response.",
          "writeOnly": true,
          "type": "string",
          "x-google-enum-descriptions": [
            "Default type that's handled as `NEW_MESSAGE`.",
            "Post as a new message in the topic.",
            "Update the Chat app's message. This is only permitted on a `CARD_CLICKED`\nevent where the message sender type is `BOT`.",
            "Update the cards on a user's message. This is only permitted as a\nresponse to a `MESSAGE` event with a matched url, or a `CARD_CLICKED`\nevent where the message sender type is `HUMAN`. Text is ignored.",
            "Privately ask the user for additional authentication or configuration.",
            "Presents a\n[dialog](https://developers.google.com/workspace/chat/dialogs).",
            "Widget text autocomplete options query."
          ],
          "enum": [
            "TYPE_UNSPECIFIED",
            "NEW_MESSAGE",
            "UPDATE_MESSAGE",
            "UPDATE_USER_MESSAGE_CARDS",
            "REQUEST_CONFIG",
            "DIALOG",
            "UPDATE_WIDGET"
          ]
        },
        "url": {
          "description": "Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG`\nresponse types.)",
          "writeOnly": true,
          "type": "string"
        },
        "dialogAction": {
          "description": "Input only. A response to an interaction event related to a\n[dialog](https://developers.google.com/workspace/chat/dialogs). Must be\naccompanied by `ResponseType.Dialog`.",
          "writeOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1DialogAction"
            }
          ]
        },
        "updatedWidget": {
          "description": "Input only. The response of the updated widget.",
          "writeOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1ActionResponseUpdatedWidget"
            }
          ]
        }
      }
    },
    "GoogleChatV1DialogAction": {
      "description": "Contains a\n[dialog](https://developers.google.com/workspace/chat/dialogs) and request\nstatus code.",
      "type": "object",
      "properties": {
        "dialog": {
          "description": "Input only. [Dialog](https://developers.google.com/workspace/chat/dialogs) for the\nrequest.",
          "writeOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Dialog"
            }
          ]
        },
        "actionStatus": {
          "description": "Input only. Status for a request to either invoke or submit a\n[dialog](https://developers.google.com/workspace/chat/dialogs). Displays\na status and message to users, if necessary.\nFor example, in case of an error or success.",
          "writeOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1ActionStatus"
            }
          ]
        }
      }
    },
    "GoogleChatV1Dialog": {
      "description": "Wrapper around the card body of the dialog.",
      "type": "object",
      "properties": {
        "body": {
          "description": "Input only. Body of the dialog, which is rendered in a modal.",
          "writeOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Card"
            }
          ]
        }
      }
    },
    "GoogleChatV1ActionStatus": {
      "description": "Represents the status for a request to either invoke or submit a\n[dialog](https://developers.google.com/workspace/chat/dialogs).",
      "type": "object",
      "properties": {
        "statusCode": {
          "description": "The status code.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleRpcCode"
            }
          ]
        },
        "userFacingMessage": {
          "description": "The message to send users about the status of their request.\nIf unset, a generic message based on the `status_code` is sent.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1ActionResponseUpdatedWidget": {
      "description": "For `selectionInput` widgets, returns autocomplete suggestions for a\nmultiselect menu.",
      "type": "object",
      "properties": {
        "suggestions": {
          "description": "List of widget autocomplete results",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1ActionResponseSelectionItems"
            }
          ]
        },
        "widget": {
          "description": "The ID of the updated widget. The ID must match the one for the\nwidget that triggered the update request.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1ActionResponseSelectionItems": {
      "description": "List of widget autocomplete results.",
      "type": "object",
      "properties": {
        "items": {
          "description": "An array of the SelectionItem objects.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1SelectionInputSelectionItem"
          }
        }
      }
    },
    "GoogleChatV1SlashCommand": {
      "description": "Metadata about a [slash\ncommand](https://developers.google.com/workspace/chat/commands) in\nGoogle Chat.",
      "type": "object",
      "properties": {
        "commandId": {
          "description": "The ID of the slash command.",
          "type": "string",
          "format": "int64"
        }
      }
    },
    "GoogleChatV1Attachment": {
      "description": "An attachment in Google Chat.",
      "type": "object",
      "properties": {
        "name": {
          "description": "Identifier. Resource name of the attachment.\n\nFormat: `spaces/{space}/messages/{message}/attachments/{attachment}`.",
          "x-google-identifier": true,
          "type": "string"
        },
        "contentName": {
          "description": "Output only. The original file name for the content, not the full path.",
          "readOnly": true,
          "type": "string"
        },
        "contentType": {
          "description": "Output only. The content type (MIME type) of the file.",
          "readOnly": true,
          "type": "string"
        },
        "attachmentDataRef": {
          "description": "Optional. A reference to the attachment data. This field is used to create or\nupdate messages with attachments, or with the media API to download the\nattachment data.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1AttachmentDataRef"
            }
          ]
        },
        "driveDataRef": {
          "description": "Output only. A reference to the Google Drive attachment. This field is used with the\nGoogle Drive API.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1DriveDataRef"
            }
          ]
        },
        "thumbnailUri": {
          "description": "Output only. The thumbnail URL which should be used to preview the\nattachment to a human user. Chat apps shouldn't use this URL to download\nattachment content.",
          "readOnly": true,
          "type": "string"
        },
        "downloadUri": {
          "description": "Output only. The download URL which should be used to allow a human user to\ndownload the attachment. Chat apps shouldn't use this URL to download\nattachment content.",
          "readOnly": true,
          "type": "string"
        },
        "source": {
          "description": "Output only. The source of the attachment.",
          "readOnly": true,
          "type": "string",
          "x-google-enum-descriptions": [
            "Reserved.",
            "The file is a Google Drive file.",
            "The file is uploaded to Chat."
          ],
          "enum": [
            "SOURCE_UNSPECIFIED",
            "DRIVE_FILE",
            "UPLOADED_CONTENT"
          ]
        }
      }
    },
    "GoogleChatV1AttachmentDataRef": {
      "description": "A reference to the attachment data.",
      "type": "object",
      "properties": {
        "resourceName": {
          "description": "Optional. The resource name of the attachment data. This field is used with the media\nAPI to download the attachment data.",
          "type": "string"
        },
        "attachmentUploadToken": {
          "description": "Optional. Opaque token containing a reference to an uploaded attachment. Treated by\nclients as an opaque string and used to create or update Chat messages with\nattachments.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1MatchedUrl": {
      "description": "A matched URL in a Chat message. Chat apps can preview matched URLs. For more\ninformation, see [Preview\nlinks](https://developers.google.com/chat/how-tos/preview-links).",
      "type": "object",
      "properties": {
        "url": {
          "description": "Output only. The URL that was matched.",
          "readOnly": true,
          "type": "string"
        }
      }
    },
    "GoogleChatV1EmojiReactionSummary": {
      "description": "The number of people who reacted to a message with a specific emoji.",
      "type": "object",
      "properties": {
        "emoji": {
          "description": "Output only. Emoji associated with the reactions.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Emoji"
            }
          ]
        },
        "reactionCount": {
          "description": "Output only. The total number of reactions using the associated emoji.",
          "readOnly": true,
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleChatV1Emoji": {
      "description": "An emoji that is used as a reaction to a message.",
      "type": "object",
      "properties": {
        "unicode": {
          "description": "Optional. A basic emoji represented by a unicode string.",
          "type": "string"
        },
        "customEmoji": {
          "description": "A custom emoji.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1CustomEmoji"
            }
          ]
        }
      }
    },
    "GoogleChatV1DeletionMetadata": {
      "description": "Information about a deleted message. A message is deleted when `delete_time`\nis set.",
      "type": "object",
      "properties": {
        "deletionType": {
          "description": "Indicates who deleted the message.",
          "type": "string",
          "x-google-enum-descriptions": [
            "This value is unused.",
            "User deleted their own message.",
            "An owner or manager deleted the message.",
            "A Google Workspace administrator deleted the message. Administrators can\ndelete any message in the space, including messages sent by any space\nmember or Chat app.",
            "A Chat app deleted its own message when it expired.",
            "A Chat app deleted the message on behalf of the creator (using user\nauthentication).",
            "A Chat app deleted the message on behalf of a space manager (using user\nauthentication).",
            "A member of the space deleted the message. Users can delete messages sent\nby apps."
          ],
          "enum": [
            "DELETION_TYPE_UNSPECIFIED",
            "CREATOR",
            "SPACE_OWNER",
            "ADMIN",
            "APP_MESSAGE_EXPIRY",
            "CREATOR_VIA_APP",
            "SPACE_OWNER_VIA_APP",
            "SPACE_MEMBER"
          ]
        }
      }
    },
    "GoogleChatV1QuotedMessageMetadata": {
      "description": "Information about a message that another message quotes.\n\nWhen you update a message, you can't add or replace the\n`quotedMessageMetadata` field, but you can remove it.\n\nFor example usage, see [Quote another\nmessage](https://developers.google.com/workspace/chat/create-messages#quote-a-message).",
      "type": "object",
      "properties": {
        "name": {
          "description": "Required. Resource name of the message that is quoted.\n\nFormat: `spaces/{space}/messages/{message}`",
          "type": "string"
        },
        "lastUpdateTime": {
          "description": "Required. The timestamp when the quoted message was created or when the\nquoted message was last updated.\n\nIf the message was edited, use this field, `last_update_time`.\nIf the message was never edited, use `create_time`.\n\nIf `last_update_time` doesn't match the latest version of the quoted\nmessage, the request fails.",
          "type": "string",
          "format": "date-time"
        },
        "quoteType": {
          "description": "Optional. Specifies the quote type. If not set, defaults to REPLY in the message\nread/write path for backward compatibility.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Reserved. This value is unused.",
            "When `quote_type` is `REPLY`, you can do the following:\n\n* If you're replying in a thread, you can quote another message in that\nthread.\n\n* If you're creating a root message, you can quote another root message\nin that space.",
            "When `quote_type` is `FORWARD`, you can quote a:\n\n* Message from a different space.\n\n* Message reply from a different thread in the same space."
          ],
          "enum": [
            "QUOTE_TYPE_UNSPECIFIED",
            "REPLY",
            "FORWARD"
          ]
        },
        "quotedMessageSnapshot": {
          "description": "Output only. A snapshot of the quoted message's content.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1QuotedMessageSnapshot"
            }
          ]
        },
        "forwardedMetadata": {
          "description": "Output only. Metadata about the source space of the quoted message.\nPopulated only for FORWARD quote type.",
          "readOnly": true,
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1ForwardedMetadata"
            }
          ]
        }
      },
      "required": [
        "name",
        "lastUpdateTime"
      ]
    },
    "GoogleChatV1QuotedMessageSnapshot": {
      "description": "Provides a snapshot of the content of the quoted message at the time of\nquoting or forwarding",
      "type": "object",
      "properties": {
        "sender": {
          "description": "Output only. The quoted message's author name.\nPopulated for both REPLY & FORWARD quote types.",
          "readOnly": true,
          "type": "string"
        },
        "text": {
          "description": "Output only. Snapshot of the quoted message's text content.",
          "readOnly": true,
          "type": "string"
        },
        "formattedText": {
          "description": "Output only. Contains the quoted message `text` with markups added to\nsupport rich formatting like hyperlinks,custom emojis, markup, etc.\nPopulated only for FORWARD quote type.",
          "readOnly": true,
          "type": "string"
        },
        "annotations": {
          "description": "Output only. Annotations parsed from the text body of the quoted message.\nPopulated only for FORWARD quote type.",
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1Annotation"
          }
        },
        "attachments": {
          "description": "Output only. Attachments that were part of the quoted message. These are\ncopies of the quoted message's attachment metadata. Populated only for\nFORWARD quote type.",
          "readOnly": true,
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1Attachment"
          }
        }
      }
    },
    "GoogleChatV1ForwardedMetadata": {
      "description": "Metadata about the source space from which a message was forwarded.",
      "type": "object",
      "properties": {
        "space": {
          "description": "Output only. The resource name of the source space.\nFormat: spaces/{space}",
          "readOnly": true,
          "type": "string"
        },
        "spaceDisplayName": {
          "description": "Output only. The display name of the source space or DM at the time of forwarding.\nFor `SPACE`, this is the space name.\nFor `DIRECT_MESSAGE`, this is the other participant's name (e.g., \"User\nA\").\nFor `GROUP_CHAT`, this is a generated name based on members' first\nnames, limited to 5 including the creator (e.g., \"User A, User B\").",
          "readOnly": true,
          "type": "string"
        }
      }
    },
    "GoogleChatV1AttachedGif": {
      "description": "A GIF image that's specified by a URL.",
      "type": "object",
      "properties": {
        "uri": {
          "description": "Output only. The URL that hosts the GIF image.",
          "readOnly": true,
          "type": "string"
        }
      }
    },
    "GoogleChatV1AccessoryWidget": {
      "description": "One or more interactive widgets that appear at the bottom of a message. For\ndetails, see [Add interactive widgets at the bottom of a\nmessage](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets).",
      "type": "object",
      "properties": {
        "buttonList": {
          "description": "A list of buttons.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ButtonList"
            }
          ]
        }
      }
    },
    "GoogleChatV1Elements": {
      "description": "Elements are additional message components,\nincluding inline `citations` (where each citation is associated with a\nspecific portion of the message text) and `cited_sources` (which are general\nreferences used to generate the response and are not directly linked to\nspecific segments of the text). Both `citations` and `cited_sources` can be\nprovided as input when creating or updating a message and are populated on\noutput when reading a message.",
      "type": "object",
      "properties": {
        "citedSources": {
          "description": "Optional. A list of sources to be displayed under the message as footer links.\nThese are not referenced inline. For inline references, use `citations`.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1CitedSource"
          }
        },
        "citations": {
          "description": "Optional. A list of inline citations referenced within the message text (via\n`` tags) that render as interactive hover cards.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1Citation"
          }
        },
        "steps": {
          "description": "Optional. A component that displays the steps taken by a Chat app to\ngenerate the message.\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Steps"
            }
          ]
        }
      }
    },
    "GoogleChatV1CitedSource": {
      "description": "A reference to a source of information.",
      "type": "object",
      "properties": {
        "title": {
          "description": "Required. The plaintext title of the `CitedSource`. Does not support markdown\nformat.",
          "type": "string"
        },
        "uri": {
          "description": "Required. The URI pointing to the resource referenced by this `CitedSource`.",
          "type": "string"
        },
        "snippet": {
          "description": "Optional. Snippet containing information directly from the source.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1CitedSourceSnippet"
            }
          ]
        },
        "footer": {
          "description": "Optional. Additional information to show alongside the snippet in the form of a\nfooter.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1CitedSourceFooter"
            }
          ]
        }
      },
      "required": [
        "title",
        "uri"
      ]
    },
    "GoogleChatV1CitedSourceSnippet": {
      "description": "A snippet object representing an excerpt from a larger corpus.",
      "type": "object",
      "properties": {
        "text": {
          "description": "Optional. A short plaintext excerpt directly from the corpus that is rendered in\nthe citation hover card or source preview. When footer sources are\nautomatically populated from inline `citations` (because\n`Elements.cited_sources` is not set), snippets are omitted from the\ndeduplicated footer sources. Does not support markdown format, and must\nnot exceed 1,000 characters.",
          "type": "string"
        },
        "imagePreview": {
          "description": "Optional. Image preview of the snippet provided as an input when creating the\ncitation.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1ElementsImage"
            }
          ]
        }
      }
    },
    "GoogleChatV1ElementsImage": {
      "description": "An object encapsulating different ways of representing an image.\nCurrently supported representations:\n\n* An image fetched from a URI.\n\nAdditional representations might be supported in the future.",
      "type": "object",
      "properties": {
        "imageUri": {
          "description": "Required. The URI of the image. Must be a publicly accessible URI so that Chat can\nfetch and display it.",
          "type": "string"
        }
      },
      "required": [
        "imageUri"
      ]
    },
    "GoogleChatV1CitedSourceFooter": {
      "description": "A footer for a source, used for attribution.",
      "type": "object",
      "properties": {
        "text": {
          "description": "Optional. The plaintext to display in the footer. Does not support markdown\nformat.",
          "type": "string"
        }
      }
    },
    "GoogleChatV1Citation": {
      "description": "Citations are inline references that can provide users more detailed\ninformation about the inline reference. Corresponding inline citations\nshould be present in the message text in a markup format of\n`{text}`. Citations are\nonly supported when the message's `markup_syntax` is set to `MARKDOWN`.\n\nUnreferenced citations in `Elements.citations` (those without a matching\n`` tag in the message text) are ignored and do not cause the\nmessage to be rejected.",
      "type": "object",
      "properties": {
        "id": {
          "description": "Required. The ID of the citation. This ID is defined by the app creating the\ncitation and must match the `data-id` attribute of the ``\ntag in the message text. Must contain only ASCII letters and numbers, and\nless than 63 characters.",
          "type": "string"
        },
        "citedSources": {
          "description": "Optional. A list of sources that are relevant to the citation. Sources are\ndisplayed in the citation hover card.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1CitedSource"
          }
        }
      },
      "required": [
        "id"
      ]
    },
    "GoogleChatV1Steps": {
      "description": "The set of items associated with a Chat message that identify how the message\nwas generated. A Chat app can use steps to display reasoning, tool calls, or\nprogress associated with generating a message.\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
      "type": "object",
      "properties": {
        "steps": {
          "description": "Optional. The list of steps.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1Step"
          }
        }
      }
    },
    "GoogleChatV1Step": {
      "description": "An individual step entry performed by a Chat app while generating a message.\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
      "type": "object",
      "properties": {
        "title": {
          "description": "Required. Plain-text title of the step.",
          "type": "string"
        },
        "description": {
          "description": "Optional. Plain-text description of the step.",
          "type": "string"
        }
      },
      "required": [
        "title"
      ]
    },
    "GoogleAppsAddonsV1ChatChatEventObjectAddedToSpacePayload": {
      "description": "A user adds the Chat app to a space, or a DM between the app and a user is\ncreated.",
      "type": "object",
      "properties": {
        "space": {
          "description": "Required. The [Chat\nspace](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)\nin which the event object occurs.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Space"
            }
          ]
        },
        "interactionAdd": {
          "description": "Whether the app was added to the space with a user interaction (e.g., by\n@ mentioning the Chat app or invoking with a slash command). If this is\nset to true then there will be a separate event object associated with\nthe interaction itself dispatched to the Chat app.",
          "type": "boolean"
        },
        "configCompleteRedirectUri": {
          "description": "Optional. The URL the Chat app should redirect the user to after they\ncomplete an authorization or configuration flow outside of Google Chat.\nFor more information, see [Connect a Chat app with other services &\ntools](https://developers.google.com/workspace/add-ons/guides/connect-third-party-service).",
          "type": "string"
        }
      },
      "required": [
        "space"
      ]
    },
    "GoogleAppsAddonsV1ChatChatEventObjectRemovedFromSpacePayload": {
      "description": "A user removes the Chat app from a space.",
      "type": "object",
      "properties": {
        "space": {
          "description": "Required. The [Chat\nspace](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)\nin which the event object occurs.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Space"
            }
          ]
        }
      },
      "required": [
        "space"
      ]
    },
    "GoogleAppsAddonsV1ChatChatEventObjectButtonClickedPayload": {
      "description": "A user interacts with an interactive element of a card or dialog from a\nChat Add-on that triggers an `Action` callback. Despite the name, this\npayload is populated for all card and dialog `Action` callbacks, including\nbutton clicks, `on_change_action` triggers, `on_click` actions,\n`CardAction` clicks, and dialog submission or cancellation (`SUBMIT_DIALOG`\nand `CANCEL_DIALOG`).\n\nIf a user interacts with a dialog, the ButtonClickedPayload's\n`isDialogEvent` field is set to `true` and includes a\n[`DialogEventType`](https://developers.google.com/workspace/add-ons/chat/build#buttonclickedpayload).\nThis payload maps to `SUBMIT_FORM` and `CARD_CLICKED` event types for\nChat apps that are not add-ons.\n\nThe complete payload also includes `CommonEventObject.form_inputs` and\n`CommonEventObject.parameters`.",
      "type": "object",
      "properties": {
        "space": {
          "description": "Required. The [Chat\nspace](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)\nin which the event object occurs.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Space"
            }
          ]
        },
        "message": {
          "description": "The message that triggers the event object.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Message"
            }
          ]
        },
        "isDialogEvent": {
          "description": "For `ButtonClicked` and `Message` event objects, whether the user\nis interacting with or about to interact with a\n[dialog](https://developers.google.com/workspace/add-ons/chat/dialogs).",
          "type": "boolean"
        },
        "dialogEventType": {
          "description": "The type of\n[dialog](https://developers.google.com/workspace/add-ons/chat/dialogs)\nevent object received.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatDialogEventType"
            }
          ]
        }
      },
      "required": [
        "space"
      ]
    },
    "GoogleAppsAddonsV1ChatChatEventObjectWidgetUpdatedPayload": {
      "description": "A user updates a\n[widget](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#widgets)\nin an in-stream card or dialog.\n\nThe complete payload also includes\n`CommonEventObject.parameters['autocomplete_widget_query']`.",
      "type": "object",
      "properties": {
        "space": {
          "description": "Required. The [Chat\nspace](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)\nin which the event object occurs.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Space"
            }
          ]
        }
      },
      "required": [
        "space"
      ]
    },
    "GoogleAppsAddonsV1ChatChatEventObjectAppCommandPayload": {
      "description": "A user invokes an [app\ncommand](https://developers.google.com/workspace/add-ons/chat/commands).",
      "type": "object",
      "properties": {
        "appCommandMetadata": {
          "description": "Populated for app commands, including slash commands and quick commands.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1AppCommandMetadata"
            }
          ]
        },
        "space": {
          "description": "Optional. The [Chat\nspace](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)\nin which the event object occurs.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Space"
            }
          ]
        },
        "thread": {
          "description": "Optional. The thread in which the event object occurs, if applicable. This field is\npopulated if the event object is associated with a specific message or\nthread.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Thread"
            }
          ]
        },
        "message": {
          "description": "Optional. The message that triggers the event object, if applicable. This field is\nonly populated for slash commands.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Message"
            }
          ]
        },
        "configCompleteRedirectUri": {
          "description": "Optional. The URL the user should be redirected to after they complete an\nauthorization or configuration flow outside of Google Chat. For more\ninformation, see [Connect a Chat app with other services &\ntools](https://developers.google.com/workspace/add-ons/guides/connect-third-party-service).",
          "type": "string"
        },
        "isDialogEvent": {
          "description": "Optional. Whether the user is interacting with or about to interact with a\n[dialog](https://developers.google.com/workspace/add-ons/chat/dialogs).",
          "type": "boolean"
        },
        "dialogEventType": {
          "description": "Optional. The type of\n[dialog](https://developers.google.com/workspace/add-ons/chat/dialogs)\nevent object received. This field only applies if `isDialogEvent` is\n`true`.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1ChatDialogEventType"
            }
          ]
        }
      }
    },
    "GoogleChatV1AppCommandMetadata": {
      "description": "Metadata about a [Chat app\ncommand](https://developers.google.com/workspace/chat/commands).",
      "type": "object",
      "properties": {
        "appCommandId": {
          "description": "The ID for the command specified in the Chat API configuration.",
          "type": "integer",
          "format": "int32"
        },
        "appCommandType": {
          "description": "The type of Chat app command.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. Unspecified.",
            "A slash command. The user sends the command in a Chat message.",
            "A quick command. The user selects the command from the Chat menu\nin the message reply area.",
            "A message action. The user selects the command from the message context\nmenu in Chat."
          ],
          "enum": [
            "APP_COMMAND_TYPE_UNSPECIFIED",
            "SLASH_COMMAND",
            "QUICK_COMMAND",
            "MESSAGE_ACTION"
          ]
        }
      }
    },
    "GoogleAppsAddonsV1ChatChatEventObjectSystemCommandPayload": {
      "description": "A user invokes a system command.",
      "type": "object",
      "properties": {
        "systemCommandMetadata": {
          "description": "Metadata about the system command that was invoked.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SystemCommandMetadata"
            }
          ]
        },
        "space": {
          "description": "Optional. The [Chat\nspace](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)\nin which the event object occurs.",
          "type": "string"
        },
        "thread": {
          "description": "Optional. The thread in which the event object occurs, if applicable. This field is\npopulated if the event object is associated with a specific message or\nthread.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Thread"
            }
          ]
        }
      }
    },
    "GoogleChatV1SystemCommandMetadata": {
      "description": "Metadata about a system command that is triggered by the user.\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
      "type": "object",
      "properties": {
        "cancelStream": {
          "description": "Command for cancelling an active stream message.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1SystemCommandMetadataCancelStream"
            }
          ]
        }
      }
    },
    "GoogleChatV1SystemCommandMetadataCancelStream": {
      "description": "Command for cancelling an active stream message.",
      "type": "object",
      "properties": {
        "streamMessage": {
          "description": "Required. The resource name of the stream message on which the cancel\ncommand was performed.\n\nFormat: `spaces/{space}/streamMessages/{stream_message}`",
          "type": "string"
        }
      },
      "required": [
        "streamMessage"
      ]
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObject": {
      "description": "LINT.IfChange\nThe event object passed to Workflow add-ons.",
      "type": "object",
      "properties": {
        "actionInvocation": {
          "description": "Invocation of a workflow action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectActionInvocation"
            }
          ]
        },
        "triggerCreation": {
          "description": "Creation of a workflow trigger.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectTriggerCreation"
            }
          ]
        },
        "triggerDeletion": {
          "description": "Deletion of a workflow trigger.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectTriggerDeletion"
            }
          ]
        },
        "resourceRetrieval": {
          "description": "Retrieval of a resource (used for variable inflation).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectResourceRetrieval"
            }
          ]
        },
        "elementConfiguration": {
          "description": "Configuration of a workflow element.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectElementConfiguration"
            }
          ]
        },
        "resourceFieldsDefinitionRetrieval": {
          "description": "The retrieval of field definitions supported by a resource.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectResourceFieldsDefinitionRetrieval"
            }
          ]
        },
        "elementUiAutocomplete": {
          "description": "Autocomplete suggestions for the currently rendered card.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectElementUiAutocomplete"
            }
          ]
        },
        "executionMetadata": {
          "description": "Metadata about the workflow execution.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectExecutionMetadata"
            }
          ]
        },
        "triggerEventSource": {
          "description": "Source of the triggering events.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. DO NOT USE.",
            "Execution is triggered automatically by events.",
            "Execution is triggered via test run."
          ],
          "enum": [
            "TRIGGER_EVENT_SOURCE_UNSPECIFIED",
            "TRIGGER_EVENT_SOURCE_AUTOMATED",
            "TRIGGER_EVENT_SOURCE_TEST_RUN"
          ]
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectActionInvocation": {
      "description": "Invocation of a workflow action.",
      "type": "object",
      "properties": {
        "inputs": {
          "description": "Map of the input variables keyed by input variable name.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectVariableData"
          }
        },
        "triggerId": {
          "description": "Trigger ID to use for async action responses.",
          "type": "string"
        },
        "flowLevelContext": {
          "description": "Optional. Flow-level context from preceding steps.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectFlowLevelContext"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectVariableData": {
      "description": "Represents variable data, which can hold multiple values of different\ntypes.",
      "type": "object",
      "properties": {
        "booleanValues": {
          "description": "Boolean values.",
          "type": "array",
          "items": {
            "type": "boolean"
          }
        },
        "integerValues": {
          "description": "Integer values.",
          "type": "array",
          "items": {
            "type": "string",
            "format": "int64"
          }
        },
        "floatValues": {
          "description": "Float values.",
          "type": "array",
          "items": {
            "type": "number",
            "format": "float"
          }
        },
        "stringValues": {
          "description": "String values.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "timestampValues": {
          "description": "Timestamp values.",
          "type": "array",
          "items": {
            "type": "string",
            "format": "date-time"
          }
        },
        "resourceReferences": {
          "description": "Resource references (IDs).",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectResourceReference"
          }
        },
        "emailAddressValues": {
          "description": "Email address values.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "googleUserValues": {
          "description": "Google user values in the format `users/{user}`.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "textFormatValues": {
          "description": "Workflow Text Format values.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormat"
          }
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectResourceReference": {
      "description": "Id value of application specific resource.",
      "type": "object",
      "properties": {
        "resourceType": {
          "description": "The type of the resource this ID points to.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowDataTypeResourceType"
            }
          ]
        },
        "resourceId": {
          "description": "ID of the resource.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowDataTypeResourceType": {
      "description": "Name of custom resource type.",
      "type": "object",
      "properties": {
        "workflowBundleId": {
          "description": "ID of the workflow bundle that owns this resource type. This is optional\nand if empty it's considered to be the same bundle where it's being used.",
          "type": "string"
        },
        "workflowResourceDefinitionId": {
          "description": "Unique identifier of the resource. This is only required to be unique\nwithin the same bundle.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormat": {
      "description": "A block of text with rich formatting options including styles, hyperlinks,\nand interactive elements.",
      "type": "object",
      "properties": {
        "textFormatElements": {
          "description": "A collection of text format elements.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElement"
          }
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElement": {
      "description": "A single element within a WorkflowTextFormat message, which can be\na chip, styled text, a hyperlink, or a list container.",
      "type": "object",
      "properties": {
        "text": {
          "description": "Text in the text format.",
          "type": "string"
        },
        "chip": {
          "description": "Clickable chip in the text format.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatChip"
            }
          ]
        },
        "styledText": {
          "description": "Styled text in the text format.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElementStyledText"
            }
          ]
        },
        "hyperlink": {
          "description": "Hyperlink in the text format.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElementHyperlink"
            }
          ]
        },
        "listContainer": {
          "description": "List container in the text format.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElementListContainer"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatChip": {
      "description": "A clickable chip in the text format.",
      "type": "object",
      "properties": {
        "icon": {
          "description": "The icon displayed in the chip.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatIcon"
            }
          ]
        },
        "label": {
          "description": "The text displayed in the chip.",
          "type": "string"
        },
        "url": {
          "description": "The URL to navigate to when the chip is clicked.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatIcon": {
      "description": "An icon in the chip.",
      "type": "object",
      "properties": {
        "iconUrl": {
          "description": "Display a custom icon hosted at an HTTPS URL.\n\nFor example:\n\n```\n\"iconUrl\":\n\"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png\"\n```\n\nSupported file types include `.png` and `.jpg`.",
          "type": "string"
        },
        "materialIconName": {
          "description": "The icon name defined in the [Google Material\nIcon](https://fonts.google.com/icons), for example, `check_box`. Any\ninvalid names are abandoned and replaced with empty string and\nresults in the icon failing to render.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElementStyledText": {
      "description": "Text element with styles such as bold, italic and color.",
      "type": "object",
      "properties": {
        "text": {
          "description": "The main content of the text.",
          "type": "string"
        },
        "styles": {
          "description": "A collection of styles applied to the text.",
          "type": "array",
          "items": {
            "type": "string",
            "x-google-enum-descriptions": [
              "No style applied. DO NOT USE.",
              "Italic style.",
              "Underline style.",
              "Strikethrough style.",
              "Line break.",
              "Uppercase style.",
              "Code.",
              "Code block."
            ],
            "enum": [
              "STYLE_UNSPECIFIED",
              "ITALIC",
              "UNDERLINE",
              "STRIKETHROUGH",
              "LINE_BREAK",
              "UPPERCASE",
              "CODE",
              "CODE_BLOCK"
            ]
          }
        },
        "fontWeight": {
          "description": "The font weight of the text.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Standard weight with normal thickness. DO NOT USE.",
            "Lighter weight with reduced thickness.",
            "Intermediate weight between light and bold.",
            "Heavier weight with increased thickness."
          ],
          "enum": [
            "FONT_WEIGHT_UNSPECIFIED",
            "LIGHT",
            "MEDIUM",
            "BOLD"
          ]
        },
        "color": {
          "description": "The color of the text.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleTypeColor"
            }
          ]
        },
        "wrapStyle": {
          "description": "The wrap style of the text.",
          "type": "string",
          "x-google-enum-descriptions": [
            "No wrap style specified.",
            "No wrap style."
          ],
          "enum": [
            "WRAP_STYLE_UNSPECIFIED",
            "NO_WRAP"
          ]
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElementHyperlink": {
      "description": "Hyperlink element with text and link.",
      "type": "object",
      "properties": {
        "link": {
          "description": "The destination URL of the hyperlink.",
          "type": "string"
        },
        "text": {
          "description": "The text of the hyperlink.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElementListContainer": {
      "description": "Container for list items, where each list item can contain multiple\nTextFormatElement's.",
      "type": "object",
      "properties": {
        "listNestLevel": {
          "description": "The nest level of the list. Starts from 0 for the top level, and\nincreases by 1 for each nested list.",
          "type": "string",
          "format": "int64"
        },
        "listType": {
          "description": "The type of the list.",
          "type": "string",
          "x-google-enum-descriptions": [
            "No list type specified. DO NOT USE.",
            "Ordered list.",
            "Unordered list.",
            "Represents a blockquote list."
          ],
          "enum": [
            "LIST_TYPE_UNSPECIFIED",
            "ORDERED",
            "UNORDERED",
            "BLOCKQUOTE"
          ]
        },
        "listItems": {
          "description": "A collection of list items.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElementListContainerListItem"
          }
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElementListContainerListItem": {
      "description": "A list item.",
      "type": "object",
      "properties": {
        "textFormatElements": {
          "description": "A collection of text format elements.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectWorkflowTextFormatTextFormatElement"
          }
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectFlowLevelContext": {
      "description": "Flow-level context containing outputs from preceding steps.",
      "type": "object",
      "properties": {
        "stepContexts": {
          "description": "Optional. List of preceding steps. The order matters, so make sure the execution\norder is maintained in this list.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectFlowLevelContextStepContext"
          }
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectFlowLevelContextStepContext": {
      "description": "Step context metadata and outputs for flow-level context.",
      "type": "object",
      "properties": {
        "stepId": {
          "description": "Optional. Unique ID of the step in the workflow graph.",
          "type": "string"
        },
        "outputs": {
          "description": "Optional. Map of output variables produced by this step, keyed by variable name.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectVariableData"
          }
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectTriggerCreation": {
      "description": "Creation of a workflow trigger.",
      "type": "object",
      "properties": {
        "triggerId": {
          "description": "Unique identifier of the trigger provided during creation.",
          "type": "string"
        },
        "triggerType": {
          "description": "Type of the trigger.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. DO NOT USE.",
            "The trigger will fire every time the input conditions are met."
          ],
          "enum": [
            "TRIGGER_TYPE_UNDEFINED",
            "REPEATING"
          ]
        },
        "inputs": {
          "description": "Map of the input variables keyed by input variable name.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectVariableData"
          }
        },
        "notifyUri": {
          "description": "The endpoint that will be called when the trigger fires.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectTriggerDeletion": {
      "description": "Deletion of a workflow trigger.",
      "type": "object",
      "properties": {
        "triggerId": {
          "description": "Unique identifier of the trigger provided during creation.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectResourceRetrieval": {
      "description": "Retrieval of a resource.",
      "type": "object",
      "properties": {
        "resourceReference": {
          "description": "Type and ID of the resource to be retrieved.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectResourceReference"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectElementConfiguration": {
      "description": "Invocation when configuring a workflow element.",
      "type": "object",
      "properties": {
        "inputs": {
          "description": "Map of the input variables keyed by input variable name. This map could\nbe empty. Used when configuring single workflow element (trigger or\naction) in workflow home.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectVariableData"
          }
        },
        "displayDestination": {
          "description": "The destination of the element configuration card. Elements can\nuse this field to return different configuration card layouts based on\nthe destination.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. DO NOT USE.",
            "Configuration card is to be displayed in the Side Panel.",
            "Configuration card is to be displayed in the Full Screen app."
          ],
          "enum": [
            "DISPLAY_DESTINATION_UNSPECIFIED",
            "DISPLAY_DESTINATION_SIDE_PANEL",
            "DISPLAY_DESTINATION_FULL_SCREEN"
          ]
        },
        "nodeId": {
          "description": "The node id of the primitive config being rendered.",
          "type": "string"
        },
        "workflowId": {
          "description": "The workflow id of the primitive config being rendered.",
          "type": "string"
        },
        "availableVariables": {
          "description": "Available variables ordered by node position.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectElementConfigurationVariableReference"
          }
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectElementConfigurationVariableReference": {
      "description": "A variable reference to a variable in the workflow.",
      "type": "object",
      "properties": {
        "parentElementId": {
          "description": "The primitive id of the element that produces the variable\nWe can expand this to WorkflowElement or a more detailed metadata proto\nif needed.",
          "type": "string"
        },
        "nodeId": {
          "description": "Node reference id",
          "type": "string"
        },
        "path": {
          "description": "The variable selector path signature",
          "type": "string"
        },
        "dataType": {
          "description": "The variable data type",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowDataType"
            }
          ]
        },
        "iconUrl": {
          "description": "The icon url of the primitive that produces this variable.",
          "type": "string"
        },
        "stepNumber": {
          "description": "The step number of the primitive that produces this variable.",
          "type": "integer",
          "format": "int32"
        },
        "descriptionText": {
          "description": "The description of the variable.",
          "type": "string"
        },
        "displayText": {
          "description": "The display text of the variable chip.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowDataType": {
      "description": "Type of the variable.",
      "type": "object",
      "properties": {
        "basicType": {
          "description": "Basic data type.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value. DO NOT USE.",
            "A string of characters.",
            "An integer number.",
            "A floating point number.",
            "Timestamp in ISO 8601 format.",
            "A value that can be true or false.",
            "An email address, which is a string in the format of an email address.",
            "User of Google services, in the format `users/{user}`.",
            "File reference.",
            "Text with rich formatting."
          ],
          "enum": [
            "BASIC_TYPE_UNSPECIFIED",
            "STRING",
            "INTEGER",
            "FLOAT",
            "TIMESTAMP",
            "BOOLEAN",
            "EMAIL_ADDRESS",
            "GOOGLE_USER",
            "FILE",
            "FORMATTED_TEXT"
          ]
        },
        "resourceType": {
          "description": "Application resource id type.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowDataTypeResourceType"
            }
          ]
        },
        "valueMetadata": {
          "description": "Metadata about the potential values of a variable.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowDataTypeValueMetadata"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowDataTypeValueMetadata": {
      "description": "Information about the potential values of a variable.",
      "type": "object",
      "properties": {
        "enumValues": {
          "description": "Optional. Specifies the allowed values for a string. This may only be set\nif `DataType` is `STRING`.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "defaultValue": {
          "description": "Optional. String specifying the default value for this variable. For\nexample, for booleans, `default_value` may be set to `true` or\n`false`.",
          "type": "string"
        },
        "dynamicTypes": {
          "description": "Optional. Specifies the allowed types that can be dynamically casted for\na variable. This may only be set if the DataType is a String and the\nvariable is an output.",
          "type": "array",
          "items": {
            "type": "string",
            "x-google-enum-descriptions": [
              "Default value. DO NOT USE.",
              "A string of characters.",
              "An integer number.",
              "A floating point number.",
              "Timestamp in ISO 8601 format.",
              "A value that can be true or false.",
              "An email address, which is a string in the format of an email address.",
              "User of Google services, in the format `users/{user}`.",
              "File reference.",
              "Text with rich formatting."
            ],
            "enum": [
              "BASIC_TYPE_UNSPECIFIED",
              "STRING",
              "INTEGER",
              "FLOAT",
              "TIMESTAMP",
              "BOOLEAN",
              "EMAIL_ADDRESS",
              "GOOGLE_USER",
              "FILE",
              "FORMATTED_TEXT"
            ]
          }
        },
        "semanticDescriptors": {
          "description": "Optional. Helps describe the semantic meaning of a variable.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowDataTypeValueMetadataSemanticDescriptor"
          }
        },
        "dynamicSchema": {
          "description": "Optional. Configuration for dynamically resolving this variable's schema.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowDataTypeValueMetadataDynamicSchema"
            }
          ]
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowDataTypeValueMetadataSemanticDescriptor": {
      "description": "Metadata about the semantic meaning of a variable.",
      "type": "object",
      "properties": {
        "resourceAttribute": {
          "description": "Indicates that the variable corresponds to a specific attribute of a\nresource. This is particularly useful for variables that represent an\nidentifier for a resource (id, url, key, etc.).\n\nThe recommended format is:\n  - `\"{brand}/{app_name}/{resource}:{attribute}\"`\n{brand} is optional and should be omitted if it's the same as the\n{app_name}.\n\nExamples:\n- `\"google/drive/file:id\"`\n- `\"google/drive/folder:id\"`\n- `\"google/docs/document:id\"`\n- `\"google/sheets/spreadsheet:id\"`\n- `\"jira/issue:key\"`\n- `\"slack/channel:id\"`\netc.\n\nThe client will use this information to hint the user what output\nvariables are compatible with a certain input.",
          "type": "string"
        },
        "disallowedResourceAttributes": {
          "description": "Optional. Only applicable for inputs, and ignored for outputs.\nDisallowed attributes that correspond to this semantic descriptor. The\nclient will explicitly prevent variable selection for outputs that\ncorrespond to any of these disallowed resource attributes.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowDataTypeValueMetadataDynamicSchema": {
      "description": "Configuration for dynamically resolving this variable's schema at\nruntime.",
      "type": "object",
      "properties": {
        "requiredInputIds": {
          "description": "IDs of sibling input variables that must be provided before this\nvariable's schema can be dynamically resolved.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "strictEnum": {
          "description": "When true, the variable's value must match one of the dynamically\nresolved enum values. When false, dynamically resolved values are\ntreated as non-strict suggestions.",
          "type": "boolean"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectResourceFieldsDefinitionRetrieval": {
      "description": "Retrieves definition of fields supported by a resource.",
      "type": "object",
      "properties": {
        "elementId": {
          "description": "Specifies the ID of the element whose dynamic resource schema to fetch.",
          "type": "string"
        },
        "inputs": {
          "description": "This comprises of field inputs of the node that provides the variable.\nMap of the input variables keyed by input variable name.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectVariableData"
          }
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectElementUiAutocomplete": {
      "description": "Autocomplete suggestions for the currently rendered card.",
      "type": "object",
      "properties": {
        "query": {
          "description": "The query to autocomplete.",
          "type": "string"
        },
        "inputs": {
          "description": "Map of the input variables keyed by input variable name.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/GoogleAppsAddonsV1WorkflowWorkflowEventObjectVariableData"
          }
        },
        "invokedFunction": {
          "description": "The invoked function associated with the widget.",
          "type": "string"
        },
        "resourceId": {
          "description": "The resource ID that should be autocompleted for.\nThis is an optional field and may not be set.",
          "type": "string"
        },
        "operationId": {
          "description": "The ID of the operation that provided the resource to be autocompleted.\nThis is an optional field and may not be set.",
          "type": "string"
        }
      }
    },
    "GoogleAppsAddonsV1WorkflowWorkflowEventObjectExecutionMetadata": {
      "description": "Metadata about the workflow execution.",
      "type": "object",
      "properties": {
        "versionId": {
          "description": "The version of the workflow element being invoked.",
          "type": "integer",
          "format": "int32"
        },
        "timeZone": {
          "description": "The time zone of the workflow being saved. e.g. \"America/Los_Angeles\".",
          "type": "string"
        },
        "stepNumber": {
          "description": "Represents the step number of the primitive being invoked.",
          "type": "integer",
          "format": "int32"
        }
      }
    },
    "GoogleAppsAddonsV1HandleEventResponse": {
      "description": "A polymorphic callback response payload returned by a Google Workspace Add-on or Chat app HTTP webhook. The response must be one of the canonical response types directly without outer wrapper keys.",
      "oneOf": [
        {
          "$ref": "#/definitions/GoogleAppsCardV1RenderActions"
        },
        {
          "$ref": "#/definitions/GoogleAppsCardV1SubmitFormResponse"
        },
        {
          "$ref": "#/definitions/GoogleAppsCardV1GetAutocompletionResponse"
        },
        {
          "$ref": "#/definitions/GoogleAppsCardV1DataActions"
        },
        {
          "$ref": "#/definitions/GoogleAppsCardV1AuthorizationError"
        },
        {
          "$ref": "#/definitions/GoogleAppsCardV1Card"
        }
      ]
    },
    "GoogleAppsCardV1RenderActions": {
      "description": "A set of render instructions that tells a host application how to render a\ncard or perform an action in response to a user interaction.\n\n[Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):",
      "type": "object",
      "properties": {
        "action": {
          "description": "The action that add-ons can use to update the UI.\n\n[Add-ons in Google\nChat](https://developers.google.com/workspace/add-ons/chat).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1RenderActionsAction"
            }
          ]
        },
        "hostAppAction": {
          "description": "Actions handled by individual host apps.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupHostAppActionMarkup"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1RenderActionsAction": {
      "description": "The\n[actions](https://developers.google.com/workspace/add-ons/concepts/actions)\nthat add-ons can use in cards or the host application.\n\n[Google Workspace\nAdd-ons](https://developers.google.com/workspace/add-ons):",
      "type": "object",
      "properties": {
        "navigations": {
          "description": "Pushes, pops, or updates a card.\n\n[Add-ons in Google\nChat](https://developers.google.com/workspace/add-ons/chat).",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1Navigation"
          }
        },
        "link": {
          "description": "Opens the target link in a new tab or pop-up window.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1OpenLink"
            }
          ]
        },
        "notification": {
          "description": "Displays a notification in the host Google Workspace application when\na user interacts with a card.\n\nFor [add-ons in Google\nChat](https://developers.google.com/workspace/add-ons/chat), displays\na notification when users submit and close a\n[dialog](https://developers.google.com/workspace/add-ons/chat/dialogs).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Notification"
            }
          ]
        },
        "linkPreview": {
          "description": "Available in Google Docs, Google Sheets, and Google Slides. Previews\nlinks with smart chips and card. For details, see [Preview links with\nsmart\nchips](https://developers.google.com/workspace/add-ons/guides/preview-links-smart-chips).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1LinkPreview"
            }
          ]
        },
        "links": {
          "description": "Available in Google Docs. Returns a link from a third-party resource and\nconverts it to a smart chip in the host application. Formatted as an\narray of objects with one item.\n\nFor more information, see [Create third-party\nresources from the @\nmenu](https://developers.google.com/workspace/add-ons/guides/create-insert-resource-smart-chip).",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1Link"
          }
        },
        "modifyOperations": {
          "description": "For [add-ons in Google\nChat](https://developers.google.com/workspace/add-ons/chat), updates a\ncard based on a user interaction. The array must only contain a\nsingle object.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1ModifyCard"
          }
        }
      }
    },
    "GoogleAppsCardV1Navigation": {
      "description": "Updates or [navigates between\ncards](https://developers.google.com/workspace/add-ons/how-tos/navigation)\nin a card stack.\n\n[Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):\n\nFor example:\n\n1) Return a new card (Navigate forward).\n\n```\n navigations : {\n    pushCard : CARD\n  }\n```\n\n2) Update the card on top of the stack (in place update).\n\n```\n  navigations : {\n    popCard : true,\n  }, {\n    pushCard : CARD\n  }\n```\n\n3) Go back one step without updating.\n\n```\n  navigations : {\n    popCard : true,\n  }\n```\n\n4) Go back multiple steps and update that card.\n\n```\n  navigations : {\n    popCard : true,\n  }, ... {\n    pushCard : CARD\n  }\n```\n\n5) Go back multiple steps to a defined `CARD_NAME`.\n\n```\n  navigations : {\n    popToCardName : CARD_NAME,\n  }, {\n    pushCard : CARD\n  }\n```\n\n6) Go back to the root and update that card.\n\n```\n  navigations : {\n    popToRoot : true\n  }, {\n    pushCard : CARD\n  }\n```\n\n7) Pop to the specified card and pop that one as well.\n\n```\n  navigations : {\n    popToCardName : CARD_NAME\n  }, {\n    popCard : true,\n  }\n ```\n\n8) Replace the top card with a new card.\n\n```\n  navigations : {\n    updateCard : CARD\n  }\n```",
      "type": "object",
      "properties": {
        "popToRoot": {
          "description": "Pops all cards off except the root card.",
          "type": "boolean"
        },
        "pop": {
          "description": "Pops one card off.",
          "type": "boolean"
        },
        "popToCard": {
          "description": "Pops all cards above the specified card with given card name.",
          "type": "string"
        },
        "pushCard": {
          "description": "Pushes a card onto the card stack.\n\nFor [dialogs in Google\nChat](https://developers.google.com/workspace/add-ons/chat/dialogs),\nopens or updates a dialog.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Card"
            }
          ]
        },
        "updateCard": {
          "description": "Updates the top card with a new card and preserves filled form\nfields values. For a non-equivalent field, the value is dropped.\n\nFor [dialogs in Google\nChat](https://developers.google.com/workspace/add-ons/chat/dialogs),\nopens or updates a dialog.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Card"
            }
          ]
        },
        "endNavigation": {
          "description": "For [add-ons in Google\nChat](https://developers.google.com/workspace/add-ons/chat), closes a\n[dialog](https://developers.google.com/workspace/add-ons/chat/dialogs).\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1EndNavigation"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1EndNavigation": {
      "description": "For [add-ons in Google\nChat](https://developers.google.com/workspace/add-ons/chat), closes a\n[dialog](https://developers.google.com/workspace/add-ons/chat/dialogs).\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
      "type": "object",
      "properties": {
        "action": {
          "description": "For [add-ons in Google\nChat](https://developers.google.com/workspace/add-ons/chat), the action\nthat closes a\n[dialog](https://developers.google.com/workspace/add-ons/chat/dialogs).\n\n[Developer Preview](https://developers.google.com/workspace/preview).\n[Google Workspace\nAdd-ons](https://developers.google.com/workspace/add-ons):",
          "type": "string",
          "x-google-enum-descriptions": [
            "Action unspecified.",
            "Closes a dialog.",
            "Closes a dialog and refreshes the card that opened the dialog."
          ],
          "enum": [
            "ACTION_UNSPECIFIED",
            "CLOSE_DIALOG",
            "CLOSE_DIALOG_AND_EXECUTE"
          ]
        }
      }
    },
    "GoogleAppsCardV1Notification": {
      "description": "An action that displays a notification in the host Google Workspace\napplication when a user interacts with a card.\n\nFor [add-ons in Google\nChat](https://developers.google.com/workspace/add-ons/chat/), displays a\nnotification when users submit and close a\n[dialog](https://developers.google.com/workspace/add-ons/chat/dialogs).\n\n[Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):",
      "type": "object",
      "properties": {
        "text": {
          "description": "Plain text to display for the notification, without HTML tags.",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1LinkPreview": {
      "description": "Card action that previews a third-party link by displaying a card and smart\nchip. To learn more, see [Preview links with smart\nchips](https://developers.google.com/workspace/add-ons/guides/preview-links-smart-chips).\n\n[Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):\n\nFor example, the following JSON returns a unique title for the link preview\nand its smart chip, and a preview card with a header and text description:\n```\n{\n  \"action\": {\n    \"linkPreview\": {\n      \"title\": \"Smart chip title\",\n      \"linkPreviewTitle\": \"Link preview title\",\n      \"previewCard\": {\n        \"header\": {\n          \"title\": \"Preview card header\",\n        },\n        \"sections\": [\n          {\n            \"widgets\": [\n              {\n                \"textParagraph\": {\n                  \"text\": \"Description of the link.\"\n                }\n              }\n            ]\n          }\n        ]\n      }\n    }\n  }\n}\n```\n\nThe example returns the following link preview:\n\n![Example link\npreview](https://developers.google.com/workspace/add-ons/images/link-preview-reference.png)",
      "type": "object",
      "properties": {
        "previewCard": {
          "description": "A card that displays information about a link from a third-party service.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1Card"
            }
          ]
        },
        "title": {
          "description": "The title that displays in the smart chip for the link preview. If unset,\nthe smart chip displays the\n[header](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#cardheader)\nof the `previewCard`.",
          "type": "string"
        },
        "linkPreviewTitle": {
          "description": "The title that displays in the link preview. If unset, the link preview\ndisplays the\n[header](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#cardheader)\nof the `previewCard`.",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1Link": {
      "description": "The link object for the third-party resource that's returned to the add-on.\nFor more information, see [Create third-party resources from the @\nmenu](https://developers.google.com/workspace/add-ons/guides/create-insert-resource-smart-chip).\n\n[Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):",
      "type": "object",
      "properties": {
        "url": {
          "description": "URL of the link to return to the add-on.",
          "type": "string"
        },
        "title": {
          "description": "Title of the link to return to the add-on.",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1ModifyCard": {
      "description": "For [add-ons in Google\nChat](https://developers.google.com/workspace/add-ons/chat), updates a\ncard based on a user interaction. The array must only contain a\nsingle object.\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
      "type": "object",
      "properties": {
        "updateWidget": {
          "description": "For [add-ons in\nGoogle Chat](https://developers.google.com/workspace/add-ons/chat),\nupdates a widget in a card or dialog.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ModifyCardUpdateWidget"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1ModifyCardUpdateWidget": {
      "description": "For [add-ons in Google\n Chat](https://developers.google.com/workspace/add-ons/chat), updates a\n widget in a card or dialog. It is used for providing auto-complete\n suggestions when user types in an input box. See [Suggest multiselect\n items](https://developers.google.com/workspace/add-ons/chat/collect-information#suggest-multiselect)\n for more details.",
      "type": "object",
      "properties": {
        "selectionInputWidgetSuggestions": {
          "description": "For `selectionInput` widgets, an array of suggested items in a\nmultiselect menu. When a multiselect menu uses an external data source\nto populate its items, the widget can dynamically populate suggestions\nbased on what they type into the menu. For more information, see\n[Collect information from Google Chat\nusers](https://developers.google.com/workspace/add-ons/chat/collect-information).\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1ModifyCardUpdateWidgetSelectionInputWidgetSuggestions"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1ModifyCardUpdateWidgetSelectionInputWidgetSuggestions": {
      "description": "For a `selectionInput` widget that uses a multiselect menu, returns\nselection items from an external dynamic data source.\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
      "type": "object",
      "properties": {
        "suggestions": {
          "description": "An array of selectable items that appear to a user after they type\ninto a multiselect menu.\n\n[Developer Preview](https://developers.google.com/workspace/preview).",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleAppsCardV1SelectionInputSelectionItem"
          }
        }
      }
    },
    "AppsExtensionsMarkupHostAppActionMarkup": {
      "description": "Actions handled by individual host apps.",
      "type": "object",
      "properties": {
        "gmailAction": {
          "description": "Actions handled by Gmail.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkup"
            }
          ]
        },
        "calendarAction": {
          "description": "Actions handled by Calendar.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkup"
            }
          ]
        },
        "driveAction": {
          "description": "Actions handled by Drive.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupDriveClientActionMarkup"
            }
          ]
        },
        "editorAction": {
          "description": "Actions handled by Docs, Sheets, or Slides.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupEditorClientActionMarkup"
            }
          ]
        },
        "sheetsAction": {
          "description": "Actions handled by Sheets.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupSheetsClientActionMarkup"
            }
          ]
        },
        "workflowAction": {
          "description": "Actions handled by Workspace Studio.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkup"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkup": {
      "type": "object",
      "properties": {
        "taskAction": {
          "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupTaskActionMarkup"
        },
        "updateDraftActionMarkup": {
          "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkup"
        },
        "openCreatedDraftActionMarkup": {
          "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupOpenCreatedDraftActionMarkup"
        },
        "addonComposeUiActionMarkup": {
          "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupAddonComposeUiActionMarkup"
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupTaskActionMarkup": {
      "type": "object",
      "properties": {
        "reloadTasks": {
          "type": "boolean"
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkup": {
      "type": "object",
      "properties": {
        "updateBody": {
          "description": "A field that contains a series of update actions to perform on the draft\nbody that the user is currently editing.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateBody"
            }
          ]
        },
        "updateToRecipients": {
          "description": "If set, replaces the existing To recipients of the draft the user is\ncurrently editing.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateToRecipients"
            }
          ]
        },
        "updateCcRecipients": {
          "description": "If set, replaces the existing Cc recipients of the draft the user is\ncurrently editing.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateCcRecipients"
            }
          ]
        },
        "updateBccRecipients": {
          "description": "If set, replaces the existing Bcc recipients of the draft the user is\ncurrently editing.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateBccRecipients"
            }
          ]
        },
        "updateSubject": {
          "description": "If set, replaces the existing subject of the draft the user is\ncurrently editing.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateSubject"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateBody": {
      "type": "object",
      "properties": {
        "insertContents": {
          "description": "A repeated field that contains a series of content to insert into\nthe draft that the user is currently editing. The content can\ncontain HTML content or plain text content.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateBodyInsertContent"
          }
        },
        "type": {
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value when nothing is set for Type.",
            "Indicates this action is to perform an in-place insertion. By default\nthe content is inserted at the current cursor position, if there\nis selected content, it replaces the selected content.",
            "Indicates this action is to perform insert at the start of the\nmessage body.",
            "Indicates this action is to perform insert at the end of the message\nbody.",
            "Indicates this action is to replace the message body."
          ],
          "enum": [
            "UNSPECIFIED_ACTION_TYPE",
            "IN_PLACE_INSERT",
            "INSERT_AT_START",
            "INSERT_AT_END",
            "REPLACE"
          ]
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateBodyInsertContent": {
      "type": "object",
      "properties": {
        "content": {
          "description": "The content to be inserted.",
          "type": "string"
        },
        "mimeType": {
          "deprecated": true,
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value when nothing is set for EmailMimeType.",
            "Specifies that the inserted content is in plain text.",
            "Specifies that the inserted content is in HTML."
          ],
          "enum": [
            "UNSPECIFIED_EMAIL_MIME_TYPE",
            "PLAIN_TEXT",
            "HTML"
          ]
        },
        "contentType": {
          "description": "The type of inserted content.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value when nothing is set for ContentType.",
            "Specifies that the content is in plain text.",
            "Specifies that the content is in HTML and is mutable (can be\nedited).",
            "Specifies that the content is in HTML and is immutable (cannot\nbe edited)."
          ],
          "enum": [
            "UNSPECIFIED_CONTENT_TYPE",
            "TEXT",
            "MUTABLE_HTML",
            "IMMUTABLE_HTML"
          ]
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateToRecipients": {
      "type": "object",
      "properties": {
        "toRecipients": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupRecipient"
          }
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupRecipient": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateCcRecipients": {
      "type": "object",
      "properties": {
        "ccRecipients": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupRecipient"
          }
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateBccRecipients": {
      "type": "object",
      "properties": {
        "bccRecipients": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupRecipient"
          }
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupUpdateDraftActionMarkupUpdateSubject": {
      "type": "object",
      "properties": {
        "subject": {
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupOpenCreatedDraftActionMarkup": {
      "type": "object",
      "properties": {
        "draftId": {
          "description": "The ID of the newly created draft in the form \"r123\".",
          "type": "string"
        },
        "draftStorageId": {
          "description": "The server storage ID in hex format, for example,\"15e9fa622ce1029d\".",
          "type": "string"
        },
        "draftThreadServerPermId": {
          "description": "The server permanent ID for the draft's thread.\nThis field isn't set anywhere, and it's ignored when processing\nOpenCreatedDraftActionMarkup. Supply and use draftThreadStorageId\ninstead.",
          "type": "string"
        },
        "draftThreadId": {
          "description": "The ID of the thread containing the newly created draft, for example,\n\"15e9fa622ce1029d\".",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupGmailClientActionMarkupAddonComposeUiActionMarkup": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "x-google-enum-descriptions": [
            "Default. When unspecified, no action is taken.",
            "Dismisses the add-on compose UI."
          ],
          "enum": [
            "UNSPECIFIED",
            "DISMISS"
          ]
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkup": {
      "type": "object",
      "properties": {
        "editAttendeesActionMarkup": {
          "description": "An action that adds attendees to the Google Calendar event.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupEditAttendeesActionMarkup"
            }
          ]
        },
        "editConferenceDataActionMarkup": {
          "description": "An action that adds conference data to the Google Calendar event.\nThird-party conferencing add-ons can only be built in [Apps\nScript](https://developers.google.com/apps-script/reference/conference-data).",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupEditConferenceDataActionMarkup"
            }
          ]
        },
        "addAttachmentsActionMarkup": {
          "description": "An action that adds attachments to the Google Calendar event.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupAddAttachmentsActionMarkup"
            }
          ]
        },
        "createConferenceDataActionMarkup": {
          "description": "An action that shows conference data when create a Google Calendar event.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupCreateConferenceDataActionMarkup"
            }
          ]
        },
        "createConferenceSettingUrlActionMarkup": {
          "description": "An action that generates generate createconference setting url.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupCreateConferenceSettingUrlActionMarkup"
            }
          ]
        },
        "calendarSubscriptionActionMarkup": {
          "description": "An action that manages a calendar subscription. Supports subscription\ncreation in [HTTP endpoints add-ons]\n(https://developers.google.com/workspace/add-ons/guides/alternate-runtimes)\n only. Not applicable to Apps Script add-ons.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupCalendarSubscriptionActionMarkup"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupEditAttendeesActionMarkup": {
      "type": "object",
      "properties": {
        "addAttendeeEmails": {
          "description": "A list of attendees to add to the Google Calendar event.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupEditConferenceDataActionMarkup": {
      "type": "object",
      "properties": {
        "conferenceData": {
          "description": "The conference data to add to the Google Calendar event.\nThird-party conferencing add-ons can only be built in [Apps\nScript](https://developers.google.com/apps-script/reference/conference-data).",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupConferenceDataMarkup"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupConferenceDataMarkup": {
      "description": "Markup that defines conference data associated to a Google Calendar event.\nThird-party conferencing add-ons can only be built in [Apps\nScript](https://developers.google.com/apps-script/reference/conference-data).",
      "type": "object",
      "properties": {
        "conferenceId": {
          "description": "Unique identifier for this conference data. Maximum 512 characters long.",
          "type": "string"
        },
        "entryPoints": {
          "description": "Entry points to the conference. Maximum 300 entry points are allowed.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupConferenceDataMarkupEntryPointMarkup"
          }
        },
        "parameters": {
          "description": "Additional add-on parameters. Maximum 300 parameters are allowed.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupConferenceDataMarkupParameter"
          }
        },
        "error": {
          "description": "If set, it means an error occurred during conference creation.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupConferenceDataMarkupError"
            }
          ]
        },
        "note": {
          "description": "Additional notes (such as instructions from the administrator,\nlegal notices) to display to the user. Can contain HTML.\nMax length 2048 characters.",
          "type": "string"
        },
        "conferenceSolutionId": {
          "description": "An identifier of the conferencing solution. Must match a value from\nthe deployment's `calendar.conferenceSolution.id` field.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupConferenceDataMarkupEntryPointMarkup": {
      "description": "A way to join the conference.\nThird-party conferencing add-ons can only be built in [Apps\nScript](https://developers.google.com/apps-script/reference/conference-data).",
      "type": "object",
      "properties": {
        "type": {
          "description": "The type of the entry point. Required.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unknown conference type.",
            "A video conference.",
            "A phone conference.",
            "Used to provide a link to further conference joining information.",
            "A conference using [Session Initiation\nProtocol](https://en.wikipedia.org/wiki/Session_Initiation_Protocol)"
          ],
          "enum": [
            "UNKNOWN",
            "VIDEO",
            "PHONE",
            "MORE",
            "SIP"
          ]
        },
        "uri": {
          "description": "A URI for joining the conference. Supports tel: and http(s): and should\nbe at most 1300 characters long. Required.",
          "type": "string"
        },
        "label": {
          "description": "The label of the entry point to display to the user. Maximum 512\ncharacters long.",
          "type": "string"
        },
        "meetingCode": {
          "description": "A meeting code for accessing the conference. Maximum 128 characters\nlong.",
          "type": "string"
        },
        "accessCode": {
          "description": "An access code for accessing the conference. Maximum 128 characters\nlong.",
          "type": "string"
        },
        "passcode": {
          "description": "A passcode for accessing the conference. Maximum 128 characters long.",
          "type": "string"
        },
        "password": {
          "description": "A password for accessing the conference. Maximum 128 characters long.",
          "type": "string"
        },
        "pin": {
          "description": "A PIN for accessing the conference. Maximum 128 characters long.",
          "type": "string"
        },
        "regionCode": {
          "description": "The CLDR/ISO 3166 region code for the country associated with this\nentry point. Applicable only to `Type.PHONE`.",
          "type": "string"
        },
        "features": {
          "description": "Features of the entry point, such as being toll or toll-free. One entry\npoint can have multiple features.",
          "type": "array",
          "items": {
            "type": "string",
            "x-google-enum-descriptions": [
              "Unknown feature.",
              "Applies to `PHONE` entry point. A call to a toll number is charged\nto the calling party. A number can't be toll and toll-free at the\nsame time.",
              "Applies to `PHONE` entry point. For the calling party, a call to a\ntoll-free number is free of charge. A number can't be toll and\ntoll-free at the same time."
            ],
            "enum": [
              "UNKNOWN_FEATURE",
              "TOLL",
              "TOLL_FREE"
            ]
          }
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupConferenceDataMarkupParameter": {
      "description": "Solution-specific parameters that are persisted with the event data\nand, if an update or delete is needed, are passed to the add-on.\nFor example:\n`[{key: 'sessionKey', value: '123'}, {key: 'meetingId', value: '456'}]`",
      "type": "object",
      "properties": {
        "key": {
          "description": "The key of the parameter. Maximum 50 characters long. Required.",
          "type": "string"
        },
        "value": {
          "description": "The value of the parameter. Maximum 1024 characters long. Required.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupConferenceDataMarkupError": {
      "description": "Represents an error that occurred during conference creation.\nThird-party conferencing add-ons can only be built in [Apps\nScript](https://developers.google.com/apps-script/reference/conference-data).",
      "type": "object",
      "properties": {
        "type": {
          "description": "The type of error. Required.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unknown error.",
            "An authentication error.",
            "A temporary error.",
            "A permanent error.",
            "The user isn't allowed to perform some action in the third-party\nconferencing system.",
            "The user isn't allowed to use the selected conference solution (but\nmight be allowed to use other solutions offered by the add-on)."
          ],
          "enum": [
            "UNKNOWN",
            "AUTHENTICATION",
            "TEMPORARY",
            "PERMANENT",
            "PERMISSION_DENIED",
            "CONFERENCE_SOLUTION_FORBIDDEN"
          ]
        },
        "authenticationUrl": {
          "description": "If the error type is `AUTHENTICATION`, the add-on can provide a URL\nallowing users to log in. Maximum 1300 characters long.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupAddAttachmentsActionMarkup": {
      "type": "object",
      "properties": {
        "addonAttachments": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupAddAttachmentsActionMarkupAddonAttachment"
          }
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupAddAttachmentsActionMarkupAddonAttachment": {
      "type": "object",
      "properties": {
        "resourceUrl": {
          "type": "string"
        },
        "title": {
          "description": "Title of the attachment.",
          "type": "string"
        },
        "mimeType": {
          "description": "MIME type of the content in resource_url.",
          "type": "string"
        },
        "iconUrl": {
          "description": "Link to the resource's icon.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupCreateConferenceDataActionMarkup": {
      "type": "object",
      "properties": {
        "createConferenceData": {
          "description": "The conference data to add to a Google Calendar event when creating it.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupCalendarClientActionMarkupConferenceDataMarkup"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupCreateConferenceSettingUrlActionMarkup": {
      "type": "object",
      "properties": {
        "settingsUrl": {
          "description": "The uri for a settings page generated by the add-on.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupCalendarClientActionMarkupCalendarSubscriptionActionMarkup": {
      "description": "An action that manages a calendar subscription for the current user.\n\nCreating a subscription is idempotent: if the user is already subscribed to\nthe specified calendar under this add-on deployment, returning this action\nensures the subscription remains active without creating duplicate\nsubscriptions or duplicate event notifications. You don't need to\ncheck for existing subscriptions before returning this action.\n\nSupports subscription creation in [HTTP endpoints add-ons]\n(https://developers.google.com/workspace/add-ons/guides/alternate-runtimes)\nonly. Not applicable to Apps Script add-ons.",
      "type": "object",
      "properties": {
        "operation": {
          "description": "The operation to perform. Currently only `CREATE` is supported.\nCreating a subscription is idempotent.",
          "type": "string",
          "x-google-enum-descriptions": [
            "",
            ""
          ],
          "enum": [
            "OPERATION_UNSPECIFIED",
            "CREATE"
          ]
        },
        "calendarId": {
          "description": "The calendar id to subscribe to.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupDriveClientActionMarkup": {
      "type": "object",
      "properties": {
        "requestFileScope": {
          "$ref": "#/definitions/AppsExtensionsMarkupDriveClientActionMarkupRequestFileScope"
        }
      }
    },
    "AppsExtensionsMarkupDriveClientActionMarkupRequestFileScope": {
      "type": "object",
      "properties": {
        "itemId": {
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupEditorClientActionMarkup": {
      "type": "object",
      "properties": {
        "requestFileScopeForActiveDocument": {
          "$ref": "#/definitions/AppsExtensionsMarkupEditorClientActionMarkupRequestFileScopeForActiveDocument"
        }
      }
    },
    "AppsExtensionsMarkupEditorClientActionMarkupRequestFileScopeForActiveDocument": {
      "type": "object"
    },
    "AppsExtensionsMarkupSheetsClientActionMarkup": {
      "description": "Next ID: 5.",
      "type": "object",
      "properties": {
        "customFunctionReturnValueMarkup": {
          "$ref": "#/definitions/AppsExtensionsMarkupSheetsClientActionMarkupCustomFunctionReturnValueMarkup"
        }
      }
    },
    "AppsExtensionsMarkupSheetsClientActionMarkupCustomFunctionReturnValueMarkup": {
      "description": "The result of a user running a custom function.",
      "type": "object",
      "properties": {
        "value": {
          "description": "The value that resulted from running the custom function."
        },
        "errorMessage": {
          "description": "The error message to show to the user if something went wrong.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkup": {
      "description": "Client actions for Workspace Studio add-ons.",
      "type": "object",
      "properties": {
        "saveWorkflowAction": {
          "description": "Action to initiate saving of the workflow.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupSaveWorkflowAction"
            }
          ]
        },
        "returnOutputVariablesAction": {
          "description": "Action containing output variables generated by an executed workflow\naction.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupReturnOutputVariablesAction"
            }
          ]
        },
        "resourceRetrievedAction": {
          "description": "Action containing a retrieved resource.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupResourceRetrievedAction"
            }
          ]
        },
        "resourceFieldsDefinitionRetrievedAction": {
          "description": "Action containing the definition of fields for a resource.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupResourceFieldsDefinitionRetrievedAction"
            }
          ]
        },
        "returnElementErrorAction": {
          "description": "Action indicating an error occurred during element invocation.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupReturnElementErrorAction"
            }
          ]
        },
        "workflowValidationErrorAction": {
          "description": "Action indicating a workflow validation error.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupWorkflowValidationErrorAction"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupSaveWorkflowAction": {
      "description": "Indicates that the Builder should initiate saving of\nthe workflow.",
      "type": "object"
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupReturnOutputVariablesAction": {
      "description": "Contains output variables generated by the executed workflow action.",
      "type": "object",
      "properties": {
        "variables": {
          "description": "Map of variables keyed by variable ID.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupVariableData"
          }
        },
        "log": {
          "description": "Log of the executed workflow action.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkup"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupVariableData": {
      "description": "Represents variable data, which can hold multiple values of different\ntypes.",
      "type": "object",
      "properties": {
        "booleanValues": {
          "description": "Boolean values.",
          "type": "array",
          "items": {
            "type": "boolean"
          }
        },
        "integerValues": {
          "description": "Integer values.",
          "type": "array",
          "items": {
            "type": "string",
            "format": "int64"
          }
        },
        "stringValues": {
          "description": "String values.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "timestampValues": {
          "description": "Timestamp values.",
          "type": "array",
          "items": {
            "type": "string",
            "format": "date-time"
          }
        },
        "resourceReferences": {
          "description": "A list of resource IDs (e.g. \"spaces/123\").",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "resourceDataValues": {
          "description": "Resource data.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupResourceData"
          }
        },
        "emailAddressValues": {
          "description": "Email address values.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "googleUserValues": {
          "description": "Google user values in the format `users/{user}`.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "textFormatValues": {
          "description": "Workflow text format values.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkup"
          }
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupResourceData": {
      "description": "Application specific resource value.",
      "type": "object",
      "properties": {
        "fields": {
          "description": "A map of the resource fields keyed by the field name.",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupVariableData"
          }
        },
        "sourceResourceReference": {
          "description": "Deprecated. Use VariableData.variable_source_data instead.",
          "deprecated": true,
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupSourceResourceReference"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupSourceResourceReference": {
      "description": "Reference to a specific instance of a Workspace Resource",
      "type": "object",
      "properties": {
        "sourceResourceType": {
          "description": "The type of the source resource.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupSourceResourceType"
            }
          ]
        },
        "resourceId": {
          "description": "The unique ID of the resource (e.g., Drive file ID, Gmail message ID).",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupSourceResourceType": {
      "description": "The type of the source resource. This is used to identify the resource\ntype and the workflow bundle that owns the resource type.",
      "type": "object",
      "properties": {
        "workflowBundleId": {
          "description": "ID of the workflow bundle that owns this resource type.",
          "type": "string"
        },
        "resourceDefinitionId": {
          "description": "The ID of the resource definition within the bundle\n(e.g., \"spreadsheet\", \"gmailMessage\").",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupWorkflowTextFormatMarkup": {
      "description": "A block of text with rich formatting options including styles, hyperlinks,\nand interactive elements.",
      "type": "object",
      "properties": {
        "textFormatElements": {
          "description": "A collection of text format elements.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElement"
          }
        }
      }
    },
    "AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElement": {
      "description": "A single element within a WorkflowTextFormatMarkup message, which can be\na chip, styled text, a hyperlink, or a list container.",
      "type": "object",
      "properties": {
        "text": {
          "description": "Text in the text format.",
          "type": "string"
        },
        "chip": {
          "description": "Clickable chip in the text format.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkupChip"
            }
          ]
        },
        "styledText": {
          "description": "Styled text in the text format.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElementStyledText"
            }
          ]
        },
        "hyperlink": {
          "description": "Hyperlink in the text format.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElementHyperlink"
            }
          ]
        },
        "listContainer": {
          "description": "List container in the text format.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElementListContainer"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupWorkflowTextFormatMarkupChip": {
      "description": "A clickable chip in the text format.",
      "type": "object",
      "properties": {
        "icon": {
          "description": "The icon displayed in the chip.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkupIcon"
            }
          ]
        },
        "label": {
          "description": "The text displayed in the chip.",
          "type": "string"
        },
        "url": {
          "description": "The URL to navigate to when the chip is clicked.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupWorkflowTextFormatMarkupIcon": {
      "description": "An icon in the chip.",
      "type": "object",
      "properties": {
        "iconUrl": {
          "description": "Display a custom icon hosted at an HTTPS URL.\n\nFor example:\n\n```\n\"iconUrl\":\n\"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png\"\n```\n\nSupported file types include `.png` and `.jpg`.",
          "type": "string"
        },
        "materialIconName": {
          "description": "The icon name defined in the [Google Material\nIcon](https://fonts.google.com/icons), for example, `check_box`. Any\ninvalid names are abandoned and replaced with empty string and\nresults in the icon failing to render.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElementStyledText": {
      "description": "Text element with styles such as bold, italic and color.",
      "type": "object",
      "properties": {
        "text": {
          "description": "The main content of the text.",
          "type": "string"
        },
        "styles": {
          "description": "A collection of styles applied to the text.",
          "type": "array",
          "items": {
            "type": "string",
            "x-google-enum-descriptions": [
              "No style applied.",
              "Italic style.",
              "Underline style.",
              "Strikethrough style.",
              "Line break.",
              "Uppercase style.",
              "Code.",
              "Code block."
            ],
            "enum": [
              "STYLE_UNSPECIFIED",
              "ITALIC",
              "UNDERLINE",
              "STRIKETHROUGH",
              "LINE_BREAK",
              "UPPERCASE",
              "CODE",
              "CODE_BLOCK"
            ]
          }
        },
        "fontWeight": {
          "description": "The font weight of the text.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Standard weight with normal thickness.",
            "Lighter weight with reduced thickness.",
            "Intermediate weight between light and bold.",
            "Heavier weight with increased thickness."
          ],
          "enum": [
            "FONT_WEIGHT_UNSPECIFIED",
            "LIGHT",
            "MEDIUM",
            "BOLD"
          ]
        },
        "color": {
          "description": "The color of the text.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleTypeColor"
            }
          ]
        },
        "wrapStyle": {
          "description": "The wrap style of the text.",
          "type": "string",
          "x-google-enum-descriptions": [
            "No wrap style specified.",
            "No wrap style."
          ],
          "enum": [
            "WRAP_STYLE_UNSPECIFIED",
            "NO_WRAP"
          ]
        }
      }
    },
    "AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElementHyperlink": {
      "description": "Hyperlink element with text and link.",
      "type": "object",
      "properties": {
        "link": {
          "description": "The destination URL of the hyperlink.",
          "type": "string"
        },
        "text": {
          "description": "The text of the hyperlink.",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElementListContainer": {
      "description": "Container for list items, where each list item can contain multiple\nTextFormatElement's.",
      "type": "object",
      "properties": {
        "listNestLevel": {
          "description": "The nest level of the list. Starts from 0 for the top level, and\nincreases by 1 for each nested list.",
          "type": "string",
          "format": "int64"
        },
        "listType": {
          "description": "The type of the list.",
          "type": "string",
          "x-google-enum-descriptions": [
            "No list type specified.",
            "Ordered list.",
            "Unordered list.",
            "Blockquote list."
          ],
          "enum": [
            "LIST_TYPE_UNSPECIFIED",
            "ORDERED",
            "UNORDERED",
            "BLOCKQUOTE"
          ]
        },
        "listItems": {
          "description": "A collection of list items.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElementListContainerListItem"
          }
        }
      }
    },
    "AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElementListContainerListItem": {
      "description": "A list item.",
      "type": "object",
      "properties": {
        "textFormatElements": {
          "description": "A collection of text format elements.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkupTextFormatElement"
          }
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupResourceRetrievedAction": {
      "description": "Contains the returned resource.",
      "type": "object",
      "properties": {
        "resourceData": {
          "description": "Custom data in proto format.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupResourceData"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupResourceFieldsDefinitionRetrievedAction": {
      "description": "Contains the definition of each field supported by a resource.",
      "type": "object",
      "properties": {
        "dynamicResourceDefinitions": {
          "description": "Dynamic resource definitions.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupResourceFieldsDefinitionRetrievedActionDynamicResourceDefinition"
          }
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupResourceFieldsDefinitionRetrievedActionDynamicResourceDefinition": {
      "description": "Contains the definition of each field supported by a dynamic resource.",
      "type": "object",
      "properties": {
        "resourceId": {
          "description": "Unique identifier of the dynamic resource type. e.g.\n\"FORM_RESPONSE_VALUES\"",
          "type": "string"
        },
        "fields": {
          "description": "List of fields supported by this dynamic resource.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/AppsExtensionsMarkupWorkflowClientActionMarkupResourceFieldsDefinitionRetrievedActionResourceField"
          }
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupResourceFieldsDefinitionRetrievedActionResourceField": {
      "type": "object",
      "properties": {
        "selector": {
          "description": "The field's reference key used to retrieve its associated value.",
          "type": "string"
        },
        "displayText": {
          "description": "The human-readable description of the field that is displayed to the\nend user during variable selection.",
          "type": "string"
        },
        "dataType": {
          "description": "The data type of the field.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsScriptTypeWorkflowDataType"
            }
          ]
        },
        "cardinality": {
          "description": "The cardinality of the field.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsScriptTypeWorkflowCardinality"
            }
          ]
        }
      }
    },
    "GoogleAppsScriptTypeWorkflowDataType": {
      "description": "Type of the variable.",
      "type": "object",
      "properties": {
        "basicType": {
          "description": "Basic data type.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Default value.",
            "A string of characters.",
            "A number.",
            "A floating point number.",
            "Timestamp in ISO 8601 format.",
            "A value that can be true or false.",
            "An email address, which is a string in the format of an email address.",
            "User of the Google services, in the format of \u201cusers/encoded_GAIA_ID\u201d.\nDo not use yet (being implemented).",
            "File.",
            "Text with rich formatting."
          ],
          "enum": [
            "BASIC_TYPE_UNSPECIFIED",
            "STRING",
            "INTEGER",
            "FLOAT",
            "TIMESTAMP",
            "BOOLEAN",
            "EMAIL_ADDRESS",
            "GOOGLE_USER",
            "FILE",
            "FORMATTED_TEXT"
          ]
        },
        "resourceType": {
          "description": "Application specific data type.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsScriptTypeWorkflowDataTypeResourceType"
            }
          ]
        },
        "valueMetadata": {
          "description": "Metadata about the potential values of a variable.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsScriptTypeWorkflowDataTypeValueMetadata"
            }
          ]
        }
      }
    },
    "GoogleAppsScriptTypeWorkflowDataTypeResourceType": {
      "description": "Application specific resource type.",
      "type": "object",
      "properties": {
        "workflowResourceDefinitionId": {
          "description": "Unique identifier of the resource type. Does not need to be\nglobally unique. There should be corresponding\nWorkflowResourceDefinition.",
          "type": "string"
        }
      }
    },
    "GoogleAppsScriptTypeWorkflowDataTypeValueMetadata": {
      "description": "Information about the potential values of a variable.",
      "type": "object",
      "properties": {
        "enumValues": {
          "description": "Optional. Specifies the allowed values for a string. This may only be set\nif the DataType is a String.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "defaultValue": {
          "description": "Optional. String specifying the default value for this variable. For\nexample, if this is a boolean, default_value may be set to \"true\" or\n\"false\".",
          "type": "string"
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupReturnElementErrorAction": {
      "description": "Indicates that an error occurred during element invocation.",
      "type": "object",
      "properties": {
        "developerErrorMessage": {
          "description": "Developer-facing error message.",
          "type": "string"
        },
        "errorLog": {
          "description": "The human-readable error message to be displayed to the end user.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupWorkflowTextFormatMarkup"
            }
          ]
        },
        "errorActionability": {
          "description": "Whether the error is actionable by the user.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unspecified error actionability. Do not use.",
            "The user can attempt to fix the error.",
            "The error is not fixable by the user."
          ],
          "enum": [
            "ERROR_ACTIONABILITY_UNSPECIFIED",
            "ACTIONABLE",
            "NOT_ACTIONABLE"
          ]
        },
        "retryability": {
          "description": "Whether the error is retryable or not.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unspecified retryability. Do not use.",
            "The error is retryable.",
            "The error is not retryable."
          ],
          "enum": [
            "RETRYABILITY_UNSPECIFIED",
            "RETRYABLE",
            "NOT_RETRYABLE"
          ]
        }
      }
    },
    "AppsExtensionsMarkupWorkflowClientActionMarkupWorkflowValidationErrorAction": {
      "description": "Indicates that validation of the workflow element failed with the\nspecified severity.",
      "type": "object",
      "properties": {
        "severity": {
          "description": "The severity of the validation error.",
          "type": "string",
          "x-google-enum-descriptions": [
            "Unspecified severity. Do not use.",
            "The error is non-critical and is not blocking publish.",
            "The error is critical and must be fixed before publish."
          ],
          "enum": [
            "SEVERITY_UNSPECIFIED",
            "WARNING",
            "CRITICAL"
          ]
        }
      }
    },
    "GoogleAppsCardV1SubmitFormResponse": {
      "description": "A response to a form submit other than getting an autocomplete container,\nwhich contains the actions the card should perform and/or the add-on host app\nshould perform, and whether the card's state has changed.\n\n[Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):\nFor example:\n```\n{\n  \"renderActions\": {\n    \"action\": {\n      \"notification\": {\n        \"text\": \"Email address is added: salam.heba@example.com\"\n      }\n    },\n    \"hostAppAction\": {\n      \"gmailAction\": {\n        \"openCreatedDraftAction\": {\n          \"draftId\": \"msg-a:r-79766936926021702\",\n          \"threadServerPermId\": \"thread-f:15700999851086004\"\n        }\n      }\n    }\n  }\n}\n```",
      "type": "object",
      "properties": {
        "renderActions": {
          "description": "A set of render instructions that tells the card to perform an action\nand/or tells the add-on host app to perform an app-specific action.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1RenderActions"
            }
          ]
        },
        "stateChanged": {
          "description": "Whether the state of the cards has changed and data in existing cards is\nstale.",
          "type": "boolean"
        }
      }
    },
    "GoogleAppsCardV1DataActions": {
      "description": "An [add-on\naction](https://developers.google.com/workspace/add-ons/chat/build#actions)\nthat updates Google Workspace data.",
      "type": "object",
      "properties": {
        "hostAppDataAction": {
          "description": "Defines how to update Google Workspace data.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupHostAppDataActionMarkup"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupHostAppDataActionMarkup": {
      "description": "Defines how to update Google Workspace data.",
      "type": "object",
      "properties": {
        "chatDataAction": {
          "description": "A [Google Chat\naction](https://developers.google.com/workspace/add-ons/chat/build#actions)\nthat creates or updates text or cards in a message.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupChatDataActionMarkup"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupChatDataActionMarkup": {
      "description": "Creates or updates a message in Google Chat. For details,\nsee [Build Google Chat\ninterfaces](https://developers.google.com/workspace/add-ons/chat/build).",
      "type": "object",
      "properties": {
        "createMessageAction": {
          "description": "Sends a message as a Google Chat app.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupChatDataActionMarkupCreateMessageAction"
            }
          ]
        },
        "updateMessageAction": {
          "description": "Updates a Google Chat app's message.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupChatDataActionMarkupUpdateMessageAction"
            }
          ]
        },
        "updateInlinePreviewAction": {
          "description": "To [preview\nlinks](https://developers.google.com/workspace/add-ons/chat/preview-links),\nadds one or more cards to a Google Chat user's message.",
          "allOf": [
            {
              "$ref": "#/definitions/AppsExtensionsMarkupChatDataActionMarkupUpdateInlinePreviewAction"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupChatDataActionMarkupCreateMessageAction": {
      "description": "The Chat app sends a message. For details, see [Send Google Chat\nmessages](https://developers.google.com/workspace/add-ons/chat/send-messages).",
      "type": "object",
      "properties": {
        "message": {
          "description": "The Google Chat message.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Message"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupChatDataActionMarkupUpdateMessageAction": {
      "description": "The Chat app updates text or cards in a message. For details, see [Send\nGoogle Chat\nmessages](https://developers.google.com/workspace/add-ons/chat/send-messages).",
      "type": "object",
      "properties": {
        "message": {
          "description": "The updated message.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleChatV1Message"
            }
          ]
        }
      }
    },
    "AppsExtensionsMarkupChatDataActionMarkupUpdateInlinePreviewAction": {
      "description": "The Chat app previews a link in a message by adding or updating one or more\ncards. For details, see [Preview links in Google Chat\nmessages](https://developers.google.com/workspace/add-ons/chat/preview-links).",
      "type": "object",
      "properties": {
        "cardsV2": {
          "description": "An array of one or more cards.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/GoogleChatV1CardWithId"
          }
        }
      }
    },
    "GoogleAppsCardV1AuthorizationError": {
      "description": "Add-ons that access 3P services or requires more oAuth scopes from Google\nwill need to show the end user an authorization card when the login\ncredentials (e.g. OAuth tokens) are not available. Add-ons should return the\nAuthorizationError object to render the authorization card.",
      "type": "object",
      "properties": {
        "basicAuthorizationPrompt": {
          "description": "Let the platform construct the basic authorization card.  The\ndeveloper only needs to provide the authorization URL. The basic\naction can be used by add-ons that do NOT intend to be published\npublicly.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1BasicAuthorizationAction"
            }
          ]
        },
        "customAuthorizationPrompt": {
          "description": "Render instructions for a customized authorization card. A custom\nauthorization prompt will be enforced during the Google Workspace\nMarketplace review process. End users should see a customized\nauthorization card, making it clear the end user is authorizing access to\nexternal 3P services.",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1RenderActions"
            }
          ]
        },
        "requestingGoogleScopes": {
          "description": "When unbundled oAuth consent is enabled, the HTTP add-on might need to\nrequest more Google oAuth scopes. The add-on should return this object to\nrender the authorization card. See [`Manage granular\npermissions`](https://developers.google.com/workspace/add-ons/guides/alternate-runtimes#manage-granular).",
          "allOf": [
            {
              "$ref": "#/definitions/GoogleAppsCardV1RequestingGoogleScopes"
            }
          ]
        }
      }
    },
    "GoogleAppsCardV1BasicAuthorizationAction": {
      "description": "Action that will let the platform construct a basic authorization card for\nend users.",
      "type": "object",
      "properties": {
        "authorizationUrl": {
          "description": "If add-on is using OAuth2 to connect to the 3P service, this will be the\nOAuth2 authorization url.",
          "type": "string"
        },
        "resource": {
          "description": "The text displayed to the end user when a protected resource is missing\nauthorization. Example values would be: \"Salesforce account\" or \"Salesforce\ndata\".",
          "type": "string"
        }
      }
    },
    "GoogleAppsCardV1RequestingGoogleScopes": {
      "description": "When unbundled oAuth consent is enabled, the HTTP add-on might need to\nrequest more Google oAuth scopes. The add-on should return this object to\nrender the authorization card. See [`Manage granular\npermissions`](https://developers.google.com/workspace/add-ons/guides/alternate-runtimes#manage-granular).",
      "type": "object",
      "properties": {
        "scopes": {
          "description": "The scopes that the add-on is requesting.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "allScopes": {
          "description": "If true, the add-on is requesting all scopes from the manifest. The scopes\nfield should be empty in this case.",
          "type": "boolean"
        }
      }
    },
    "GoogleAppsCardV1GetAutocompletionResponse": {
      "description": "A response to getting autocomplete container, which includes elements\nnecessary for showing auto complete items for text field.\n\n[Google Workspace Add-ons](https://developers.google.com/workspace/add-ons):\nFor example:\n```\n{\n  \"auto_complete\": {\n    \"items\": [\n      {\n        \"text\": \"C++\"\n      },\n      {\n        \"text\": \"Java\"\n      },\n      {\n        \"text\": \"JavaScript\"\n      },\n      {\n        \"text\": \"Python\"\n      }\n    ]\n  }\n}\n```",
      "type": "object",
      "properties": {
        "autoComplete": {
          "$ref": "#/definitions/GoogleAppsCardV1Suggestions"
        }
      }
    },
    "GoogleAppsAddonsV1HostApp": {
      "type": "string",
      "x-google-enum-descriptions": [
        "Google can't identify a host app.",
        "The add-on launches from Gmail.",
        "The add-on launches from Google Calendar.",
        "The add-on launches from Google Drive.",
        "Not used.",
        "The add-on launches from Google Docs.",
        "The add-on launches from Google Meet.",
        "The add-on launches from Google Sheets.",
        "The add-on launches from Google Slides.",
        "The add-on launches from Google Drawings.",
        "A Google Chat app."
      ],
      "enum": [
        "UNSPECIFIED_HOST_APP",
        "GMAIL",
        "CALENDAR",
        "DRIVE",
        "DEMO",
        "DOCS",
        "MEET",
        "SHEETS",
        "SLIDES",
        "DRAWINGS",
        "CHAT"
      ]
    },
    "GoogleChatV1HistoryState": {
      "type": "string",
      "x-google-enum-descriptions": [
        "Default value. Do not use.",
        "History off. [Messages and threads are kept for 24\nhours](https://support.google.com/chat/answer/7664687).",
        "History on. The organization's [Vault retention\nrules](https://support.google.com/vault/answer/7657597) specify for\nhow long messages and threads are kept."
      ],
      "enum": [
        "HISTORY_STATE_UNSPECIFIED",
        "HISTORY_OFF",
        "HISTORY_ON"
      ]
    },
    "GoogleChatV1AnnotationType": {
      "type": "string",
      "x-google-enum-descriptions": [
        "Default value for the enum. Don't use.",
        "A user is mentioned.",
        "A slash command is invoked.",
        "A rich link annotation.",
        "A custom emoji annotation."
      ],
      "enum": [
        "ANNOTATION_TYPE_UNSPECIFIED",
        "USER_MENTION",
        "SLASH_COMMAND",
        "RICH_LINK",
        "CUSTOM_EMOJI"
      ]
    },
    "GoogleRpcCode": {
      "type": "string",
      "x-google-enum-descriptions": [
        "Not an error; returned on success.\n\nHTTP Mapping: 200 OK",
        "The operation was cancelled, typically by the caller.\n\nHTTP Mapping: 499 Client Closed Request",
        "Unknown error.  For example, this error may be returned when\na `Status` value received from another address space belongs to\nan error space that is not known in this address space.  Also\nerrors raised by APIs that do not return enough error information\nmay be converted to this error.\n\nHTTP Mapping: 500 Internal Server Error",
        "The client specified an invalid argument.  Note that this differs\nfrom `FAILED_PRECONDITION`.  `INVALID_ARGUMENT` indicates arguments\nthat are problematic regardless of the state of the system\n(e.g., a malformed file name).\n\nHTTP Mapping: 400 Bad Request",
        "The deadline expired before the operation could complete. For operations\nthat change the state of the system, this error may be returned\neven if the operation has completed successfully.  For example, a\nsuccessful response from a server could have been delayed long\nenough for the deadline to expire.\n\nHTTP Mapping: 504 Gateway Timeout",
        "Some requested entity (e.g., file or directory) was not found.\n\nNote to server developers: if a request is denied for an entire class\nof users, such as gradual feature rollout or undocumented allowlist,\n`NOT_FOUND` may be used. If a request is denied for some users within\na class of users, such as user-based access control, `PERMISSION_DENIED`\nmust be used.\n\nHTTP Mapping: 404 Not Found",
        "The entity that a client attempted to create (e.g., file or directory)\nalready exists.\n\nHTTP Mapping: 409 Conflict",
        "The caller does not have permission to execute the specified\noperation. `PERMISSION_DENIED` must not be used for rejections\ncaused by exhausting some resource (use `RESOURCE_EXHAUSTED`\ninstead for those errors). `PERMISSION_DENIED` must not be\nused if the caller can not be identified (use `UNAUTHENTICATED`\ninstead for those errors). This error code does not imply the\nrequest is valid or the requested entity exists or satisfies\nother pre-conditions.\n\nHTTP Mapping: 403 Forbidden",
        "The request does not have valid authentication credentials for the\noperation.\n\nHTTP Mapping: 401 Unauthorized",
        "Some resource has been exhausted, perhaps a per-user quota, or\nperhaps the entire file system is out of space.\n\nHTTP Mapping: 429 Too Many Requests",
        "The operation was rejected because the system is not in a state\nrequired for the operation's execution.  For example, the directory\nto be deleted is non-empty, an rmdir operation is applied to\na non-directory, etc.\n\nService implementors can use the following guidelines to decide\nbetween `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:\n (a) Use `UNAVAILABLE` if the client can retry just the failing call.\n (b) Use `ABORTED` if the client should retry at a higher level. For\n     example, when a client-specified test-and-set fails, indicating the\n     client should restart a read-modify-write sequence.\n (c) Use `FAILED_PRECONDITION` if the client should not retry until\n     the system state has been explicitly fixed. For example, if an \"rmdir\"\n     fails because the directory is non-empty, `FAILED_PRECONDITION`\n     should be returned since the client should not retry unless\n     the files are deleted from the directory.\n\nHTTP Mapping: 400 Bad Request",
        "The operation was aborted, typically due to a concurrency issue such as\na sequencer check failure or transaction abort.\n\nSee the guidelines above for deciding between `FAILED_PRECONDITION`,\n`ABORTED`, and `UNAVAILABLE`.\n\nHTTP Mapping: 409 Conflict",
        "The operation was attempted past the valid range.  E.g., seeking or\nreading past end-of-file.\n\nUnlike `INVALID_ARGUMENT`, this error indicates a problem that may\nbe fixed if the system state changes. For example, a 32-bit file\nsystem will generate `INVALID_ARGUMENT` if asked to read at an\noffset that is not in the range [0,2^32-1], but it will generate\n`OUT_OF_RANGE` if asked to read from an offset past the current\nfile size.\n\nThere is a fair bit of overlap between `FAILED_PRECONDITION` and\n`OUT_OF_RANGE`.  We recommend using `OUT_OF_RANGE` (the more specific\nerror) when it applies so that callers who are iterating through\na space can easily look for an `OUT_OF_RANGE` error to detect when\nthey are done.\n\nHTTP Mapping: 400 Bad Request",
        "The operation is not implemented or is not supported/enabled in this\nservice.\n\nHTTP Mapping: 501 Not Implemented",
        "Internal errors.  This means that some invariants expected by the\nunderlying system have been broken.  This error code is reserved\nfor serious errors.\n\nHTTP Mapping: 500 Internal Server Error",
        "The service is currently unavailable.  This is most likely a\ntransient condition, which can be corrected by retrying with\na backoff. Note that it is not always safe to retry\nnon-idempotent operations.\n\nSee the guidelines above for deciding between `FAILED_PRECONDITION`,\n`ABORTED`, and `UNAVAILABLE`.\n\nHTTP Mapping: 503 Service Unavailable",
        "Unrecoverable data loss or corruption.\n\nHTTP Mapping: 500 Internal Server Error"
      ],
      "enum": [
        "OK",
        "CANCELLED",
        "UNKNOWN",
        "INVALID_ARGUMENT",
        "DEADLINE_EXCEEDED",
        "NOT_FOUND",
        "ALREADY_EXISTS",
        "PERMISSION_DENIED",
        "UNAUTHENTICATED",
        "RESOURCE_EXHAUSTED",
        "FAILED_PRECONDITION",
        "ABORTED",
        "OUT_OF_RANGE",
        "UNIMPLEMENTED",
        "INTERNAL",
        "UNAVAILABLE",
        "DATA_LOSS"
      ]
    },
    "GoogleChatV1MarkupSyntax": {
      "type": "string",
      "x-google-enum-descriptions": [
        "Represents the unspecified value.",
        "Uses Google Chat's markup syntax.\nSee\nhttps://developers.google.com/workspace/chat/format-messages#format-texts\nfor more information.",
        "Uses Markdown syntax. This syntax is based on the\n[CommonMark](https://commonmark.org/help/) specification, with additional\nextensions.\nSee\nhttps://developers.google.com/workspace/chat/format-messages#format-texts\nfor more information."
      ],
      "enum": [
        "MARKUP_SYNTAX_UNSPECIFIED",
        "MARKUP_SYNTAX_CHAT",
        "MARKUP_SYNTAX_MARKDOWN"
      ]
    },
    "GoogleAppsAddonsV1ChatDialogEventType": {
      "type": "string",
      "x-google-enum-descriptions": [
        "Default value. Unspecified.",
        "A user opens a dialog.",
        "A user clicks an interactive element of a dialog. For example, a user\nfills out information in a dialog and clicks a button to submit the\ninformation.",
        "A user closes a dialog without submitting information, or the dialog is\ncanceled."
      ],
      "enum": [
        "DIALOG_EVENT_TYPE_UNSPECIFIED",
        "REQUEST_DIALOG",
        "SUBMIT_DIALOG",
        "CANCEL_DIALOG"
      ]
    },
    "GoogleAppsScriptTypeWorkflowCardinality": {
      "type": "string",
      "x-google-enum-descriptions": [
        "Default value.",
        "Only one value is permitted.",
        "Multiple values are permitted, including duplicates.",
        "Both single and multiple values are permitted."
      ],
      "enum": [
        "CARDINALITY_UNSPECIFIED",
        "SINGLE",
        "MULTIPLE",
        "SINGLE_OR_MULTIPLE"
      ]
    }
  }
}