@maxim_mazurok/gapi.client.chat-v1 0.0.20230514 → 0.0.20230516

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://chat.googleapis.com/$discovery/rest?version=v1
-// Revision: 20230514
+// Revision: 20230516
 
 /// <reference types="gapi.client" />
 
@@ -37,7 +37,7 @@ declare namespace gapi.client {
             /** Input only. The type of Chat app response. */
             type?:
                 string;
-            /** Input only. URL for users to auth or config. (Only for REQUEST_CONFIG response types.) */
+            /** Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.) */
             url?:
                 string;
         }
@@ -67,7 +67,7 @@ declare namespace gapi.client {
                 UserMentionMetadata;
         }
         interface Attachment {
-            /** A reference to the attachment data. This is used with the media API to download the attachment data. */
+            /** A reference to the attachment data. This field is used with the media API to download the attachment data. */
             attachmentDataRef?:
                 AttachmentDataRef;
             /** The original file name for the content, not the full path. */
@@ -76,19 +76,19 @@ declare namespace gapi.client {
             /** The content type (MIME type) of the file. */
             contentType?:
                 string;
-            /** Output only. The download URL which should be used to allow a human user to download the attachment. Chat apps should not use this URL to download attachment content. */
+            /** Output only. The download URL which should be used to allow a human user to download the attachment. Chat apps shouldn't use this URL to download attachment content. */
             downloadUri?:
                 string;
-            /** A reference to the drive attachment. This is used with the Drive API. */
+            /** A reference to the drive attachment. This field is used with the Drive API. */
             driveDataRef?:
                 DriveDataRef;
-            /** Resource name of the attachment, in the form "spaces/*‍/messages/*‍/attachments/*". */
+            /** Resource name of the attachment, in the form `spaces/*‍/messages/*‍/attachments/*`. */
             name?:
                 string;
             /** The source of the attachment. */
             source?:
                 string;
-            /** Output only. The thumbnail URL which should be used to preview the attachment to a human user. Chat apps should not use this URL to download attachment content. */
+            /** Output only. The thumbnail URL which should be used to preview the attachment to a human user. Chat apps shouldn't use this URL to download attachment content. */
             thumbnailUri?:
                 string;
         }
@@ -99,15 +99,15 @@ declare namespace gapi.client {
              */
             attachmentUploadToken?:
                 string;
-            /** The resource name of the attachment data. This is used with the media API to download the attachment data. */
+            /** The resource name of the attachment data. This field is used with the media API to download the attachment data. */
             resourceName?:
                 string;
         }
         interface Button {
-            /** A button with image and onclick action. */
+            /** A button with image and `onclick` action. */
             imageButton?:
                 ImageButton;
-            /** A button with text and onclick action. */
+            /** A button with text and `onclick` action. */
             textButton?:
                 TextButton;
         }
@@ -134,7 +134,7 @@ declare namespace gapi.client {
                 OnClick;
         }
         interface CardHeader {
-            /** The image's type (e.g. square border or circular border). */
+            /** The image's type (for example, square border or circular border). */
             imageStyle?:
                 string;
             /** The URL of the image in the card header. */
@@ -144,7 +144,7 @@ declare namespace gapi.client {
             subtitle?:
                 string;
             /**
-             * The title must be specified. The header has a fixed height: if both a title and subtitle is specified, each will take up 1 line. If only the title is specified, it will take up both
+             * The title must be specified. The header has a fixed height: if both a title and subtitle is specified, each takes up one line. If only the title is specified, it takes up both
              * lines.
              */
             title?:
@@ -304,7 +304,7 @@ declare namespace gapi.client {
                 User;
         }
         interface Dialog {
-            /** Input only. Body of the dialog, which is rendered in a modal. Google Chat apps do not support the following card entities: `DateTimePicker`, `OnChangeAction`. */
+            /** Input only. Body of the dialog, which is rendered in a modal. Google Chat apps don't support the following card entities: `DateTimePicker`, `OnChangeAction`. */
             body?:
                 GoogleAppsCardV1Card;
         }
@@ -320,7 +320,7 @@ declare namespace gapi.client {
                 Dialog;
         }
         interface DriveDataRef {
-            /** The id for the drive file, for use with the Drive API. */
+            /** The ID for the drive file. Use with the Drive API. */
             driveFileId?:
                 string;
         }
@@ -345,8 +345,8 @@ declare namespace gapi.client {
         }
         interface FormAction {
             /**
-             * The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the Chat app as part of the card click event. The same
-             * method name can be used for several elements that trigger a common behavior if desired.
+             * The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the Chat app as part of the card click event. You can
+             * use the same method name for several elements that trigger a common behavior.
              */
             actionMethodName?:
                 string;
@@ -362,11 +362,11 @@ declare namespace gapi.client {
             function?:
                 string;
             /**
-             * Optional. Required when opening a [dialog](https://developers.google.com/chat/how-tos/dialogs). What to do in response to an interaction with a user, such as a user clicking button
-             * on a card message. If unspecified, the app responds by executing an `action` - like opening a link or running a function - as normal. By specifying an `interaction`, the app can
+             * Optional. Required when opening a [dialog](https://developers.google.com/chat/how-tos/dialogs). What to do in response to an interaction with a user, such as a user clicking a
+             * button in a card message. If unspecified, the app responds by executing an `action`—like opening a link or running a function—as normal. By specifying an `interaction`, the app can
              * respond in special interactive ways. For example, by setting `interaction` to `OPEN_DIALOG`, the app can open a [dialog](https://developers.google.com/chat/how-tos/dialogs). When
-             * specified, a loading indicator is not shown. Supported by Chat apps, but not Google Workspace Add-ons. If specified for an add-on, the entire card is stripped and nothing is shown
-             * in the client.
+             * specified, a loading indicator isn't shown. Supported by Chat apps, but not Google Workspace Add-ons. If specified for an add-on, the entire card is stripped and nothing is shown in
+             * the client.
              */
             interaction?:
                 string;
@@ -378,12 +378,12 @@ declare namespace gapi.client {
                 GoogleAppsCardV1ActionParameter[];
             /**
              * Indicates whether form values persist after the action. The default value is `false`. If `true`, form values remain after the action is triggered. To let the user make changes while
-             * the action is being processed, set [LoadIndicator](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `NONE`. For [card
+             * the action is being processed, set [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `NONE`. For [card
              * messages](https://developers.google.com/chat/api/guides/message-formats/cards) in Chat apps, you must also set the action's
-             * [ResponseType](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use the same
+             * [`ResponseType`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages#responsetype) to `UPDATE_MESSAGE` and use the same
              * [`card_id`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages#CardWithId) from the card that contained the action. If `false`, the form values are cleared
              * when the action is triggered. To prevent the user from making changes while the action is being processed, set
-             * [LoadIndicator](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `SPINNER`.
+             * [`LoadIndicator`](https://developers.google.com/workspace/add-ons/reference/rpc/google.apps.card.v1#loadindicator) to `SPINNER`.
              */
             persistValues?:
                 boolean;
@@ -409,17 +409,17 @@ declare namespace gapi.client {
         }
         interface GoogleAppsCardV1Button {
             /**
-             * The alternative text used for accessibility. Set descriptive text that lets users know what the button does. For example, if a button opens a hyperlink, you might write: "Opens a
-             * new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat".
+             * The alternative text that's used for accessibility. Set descriptive text that lets users know what the button does. For example, if a button opens a hyperlink, you might write:
+             * "Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat".
              */
             altText?:
                 string;
             /**
-             * If set, the button is filled with a solid background color and the font color changes to maintain contrast with the background color. For example, setting a blue background will
-             * likely result in white text. If unset, the image background is white and the font color is blue. For red, green and blue, the value of each field is a `float` number that can be
-             * expressed in either of two ways: as a number between 0 and 255 divided by 255 (153/255) or as a value between 0 and 1 (0.6). 0 represents the absence of a color and 1 or 255/255
-             * represent the full presence of that color on the RGB scale. Optionally set alpha, which sets a level of transparency using this equation: ``` pixel color = alpha * (this color) +
-             * (1.0 - alpha) * (background color) ``` For alpha, a value of 1 corresponds with a solid color, and a value of 0 corresponds with a completely transparent color. For example, the
+             * If set, the button is filled with a solid background color and the font color changes to maintain contrast with the background color. For example, setting a blue background likely
+             * results in white text. If unset, the image background is white and the font color is blue. For red, green, and blue, the value of each field is a `float` number that you can express
+             * in either of two ways: as a number between 0 and 255 divided by 255 (153/255), or as a value between 0 and 1 (0.6). 0 represents the absence of a color and 1 or 255/255 represent
+             * the full presence of that color on the RGB scale. Optionally set `alpha`, which sets a level of transparency using this equation: ``` pixel color = alpha * (this color) + (1.0 -
+             * alpha) * (background color) ``` For `alpha`, a value of `1` corresponds with a solid color, and a value of `0` corresponds with a completely transparent color. For example, the
              * following color represents a half transparent red: ``` "color": { "red": 1, "green": 0, "blue": 0, "alpha": 0.5 } ```
              */
             color?:
@@ -430,7 +430,7 @@ declare namespace gapi.client {
             /** The icon image. If both `icon` and `text` are set, then the icon appears before the text. */
             icon?:
                 GoogleAppsCardV1Icon;
-            /** Required. The action to perform when the button is clicked, such as opening a hyperlink or running a custom function. */
+            /** Required. The action to perform when a user clicks the button, such as opening a hyperlink or running a custom function. */
             onClick?:
                 GoogleAppsCardV1OnClick;
             /** The text displayed inside the button. */
@@ -444,10 +444,10 @@ declare namespace gapi.client {
         }
         interface GoogleAppsCardV1Card {
             /**
-             * The card's actions. Actions are added to the card's toolbar menu. Because Chat app cards have no toolbar, `cardActions[]` is not supported by Chat apps. For example, the following
-             * JSON constructs a card action menu with Settings and Send Feedback options: ``` "card_actions": [ { "actionLabel": "Settings", "onClick": { "action": { "functionName": "goToView",
-             * "parameters": [ { "key": "viewType", "value": "SETTING" } ], "loadIndicator": "LoadIndicator.SPINNER" } } }, { "actionLabel": "Send Feedback", "onClick": { "openLink": { "url":
-             * "https://example.com/feedback" } } } ] ```
+             * The card's actions. Actions are added to the card's toolbar menu. Because Chat app cards have no toolbar, `cardActions[]` isn't supported by Chat apps. For example, the following
+             * JSON constructs a card action menu with `Settings` and `Send Feedback` options: ``` "card_actions": [ { "actionLabel": "Settings", "onClick": { "action": { "functionName":
+             * "goToView", "parameters": [ { "key": "viewType", "value": "SETTING" } ], "loadIndicator": "LoadIndicator.SPINNER" } } }, { "actionLabel": "Send Feedback", "onClick": { "openLink": {
+             * "url": "https://example.com/feedback" } } } ] ```
              */
             cardActions?:
                 GoogleAppsCardV1CardAction[];
@@ -489,7 +489,7 @@ declare namespace gapi.client {
             /** The primary button of the fixed footer. The button must be a text button with text and color set. */
             primaryButton?:
                 GoogleAppsCardV1Button;
-            /** The secondary button of the fixed footer. The button must be a text button with text and color set. `primaryButton` must be set if `secondaryButton` is set. */
+            /** The secondary button of the fixed footer. The button must be a text button with text and color set. If `secondaryButton` is set, you must also set `primaryButton`. */
             secondaryButton?:
                 GoogleAppsCardV1Button;
             /** A list of widgets included in the card footer. Primary button and secondary button are rendered below these widgets. */
@@ -497,7 +497,7 @@ declare namespace gapi.client {
                 GoogleAppsCardV1FooterWidget[];
         }
         interface GoogleAppsCardV1CardHeader {
-            /** The alternative text of this image which is used for accessibility. */
+            /** The alternative text of this image that's used for accessibility. */
             imageAltText?:
                 string;
             /** The shape used to crop the image. */
@@ -573,7 +573,7 @@ declare namespace gapi.client {
             /** The text that appears below `text`. Always truncates. */
             bottomLabel?:
                 string;
-            /** A button that can be clicked to trigger an action. */
+            /** A button that a user can click to trigger an action. */
             button?:
                 GoogleAppsCardV1Button;
             /**
@@ -585,18 +585,19 @@ declare namespace gapi.client {
             /** Deprecated in favor of `startIcon`. */
             icon?:
                 GoogleAppsCardV1Icon;
-            /** When users click on `topLabel` or `bottomLabel`, this action triggers. */
+            /** This action is triggered when users click `topLabel` or `bottomLabel`. */
             onClick?:
                 GoogleAppsCardV1OnClick;
             /** The icon displayed in front of the text. */
             startIcon?:
                 GoogleAppsCardV1Icon;
-            /** A switch widget can be clicked to change its state and trigger an action. */
+            /** A switch widget that a user can click to change its state and trigger an action. */
             switchControl?:
                 GoogleAppsCardV1SwitchControl;
             /**
-             * Required. The primary text. Supports simple formatting. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in Google Workspace
-             * Add-ons.
+             * Required. The primary text. Supports simple formatting. For more information about formatting text, see [Formatting text in Google Chat
+             * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
+             * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
              */
             text?:
                 string;
@@ -648,7 +649,7 @@ declare namespace gapi.client {
                 string;
         }
         interface GoogleAppsCardV1GridItem {
-            /** A user-specified identifier for this grid item. This identifier is returned in the parent Grid's onClick callback parameters. */
+            /** A user-specified identifier for this grid item. This identifier is returned in the parent grid's `onClick` callback parameters. */
             id?:
                 string;
             /** The image that displays in the grid item. */
@@ -666,9 +667,9 @@ declare namespace gapi.client {
         }
         interface GoogleAppsCardV1Icon {
             /**
-             * Optional. A description of the icon used for accessibility. If unspecified, the default value "Button" is provided. As a best practice, you should set a helpful description for what
+             * Optional. A description of the icon used for accessibility. If unspecified, the default value `Button` is provided. As a best practice, you should set a helpful description for what
              * the icon displays, and if applicable, what it does. For example, `A user's account portrait`, or `Opens a new browser tab and navigates to the Google Chat developer documentation at
-             * https://developers.google.com/chat`. If the icon is set in a Button, the `altText` appears as helper text when the user hovers over the button. However, if the button also sets
+             * https://developers.google.com/chat`. If the icon is set in a `Button`, the `altText` appears as helper text when the user hovers over the button. However, if the button also sets
              * `text`, the icon's `altText` is ignored.
              */
             altText?:
@@ -690,13 +691,13 @@ declare namespace gapi.client {
                 string;
         }
         interface GoogleAppsCardV1Image {
-            /** The alternative text of this image, used for accessibility. */
+            /** The alternative text of this image that's used for accessibility. */
             altText?:
                 string;
-            /** The `https` URL that hosts the image. For example: ``` https://developers.google.com/chat/images/quickstart-app-avatar.png ``` */
+            /** The HTTPS URL that hosts the image. For example: ``` https://developers.google.com/chat/images/quickstart-app-avatar.png ``` */
             imageUrl?:
                 string;
-            /** When a user clicks on the image, the click triggers this action. */
+            /** When a user clicks the image, the click triggers this action. */
             onClick?:
                 GoogleAppsCardV1OnClick;
         }
@@ -716,8 +717,8 @@ declare namespace gapi.client {
         }
         interface GoogleAppsCardV1ImageCropStyle {
             /**
-             * The aspect ratio to use if the crop type is `RECTANGLE_CUSTOM`. For example, here's how to apply a 16 by 9 aspect ratio: ``` cropStyle { "type": "RECTANGLE_CUSTOM", "aspectRatio":
-             * 16/9 } ```
+             * The aspect ratio to use if the crop type is `RECTANGLE_CUSTOM`. For example, here's how to apply a 16:9 aspect ratio: ``` cropStyle { "type": "RECTANGLE_CUSTOM", "aspectRatio": 16/9
+             * } ```
              */
             aspectRatio?:
                 number;
@@ -761,8 +762,9 @@ declare namespace gapi.client {
             collapsible?:
                 boolean;
             /**
-             * Text that appears at the top of a section. Supports simple HTML formatted text. For more information about formatting text, see Formatting text in Google Chat apps and Formatting
-             * text in Google Workspace Add-ons.
+             * Text that appears at the top of a section. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat
+             * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
+             * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
              */
             header?:
                 string;
@@ -773,7 +775,7 @@ declare namespace gapi.client {
              */
             uncollapsibleWidgetsCount?:
                 number;
-            /** All the widgets in the section. Must contain at least 1 widget. */
+            /** All the widgets in the section. Must contain at least one widget. */
             widgets?:
                 GoogleAppsCardV1Widget[];
         }
@@ -824,7 +826,7 @@ declare namespace gapi.client {
                 string;
         }
         interface GoogleAppsCardV1SuggestionItem {
-            /** The value of a suggested input to a text input field. This is equivalent to what users would enter themselves. */
+            /** The value of a suggested input to a text input field. This is equivalent to what users enter themselves. */
             text?:
                 string;
         }
@@ -871,16 +873,16 @@ declare namespace gapi.client {
                 string;
             /**
              * Suggested values that users can enter. These values appear when users click inside the text input field. As users type, the suggested values dynamically filter to match what the
-             * users have typed. For example, a text input field for programming language might suggest Java, JavaScript, Python, and C++. When users start typing "Jav", the list of suggestions
-             * filters to show just Java and JavaScript. Suggested values help guide users to enter values that your app can make sense of. When referring to JavaScript, some users might enter
-             * "javascript" and others "java script". Suggesting "JavaScript" can standardize how users interact with your app. When specified, `TextInput.type` is always `SINGLE_LINE`, even if it
-             * is set to `MULTIPLE_LINE`.
+             * users have typed. For example, a text input field for programming language might suggest Java, JavaScript, Python, and C++. When users start typing `Jav`, the list of suggestions
+             * filters to show just `Java` and `JavaScript`. Suggested values help guide users to enter values that your app can make sense of. When referring to JavaScript, some users might enter
+             * `javascript` and others `java script`. Suggesting `JavaScript` can standardize how users interact with your app. When specified, `TextInput.type` is always `SINGLE_LINE`, even if
+             * it's set to `MULTIPLE_LINE`.
              */
             initialSuggestions?:
                 GoogleAppsCardV1Suggestions;
             /**
              * The text that appears above the text input field in the user interface. Specify text that helps the user enter the information your app needs. For example, if you are asking
-             * someone's name, but specifically need their surname, write "surname" instead of "name". Required if `hintText` is unspecified. Otherwise, optional.
+             * someone's name, but specifically need their surname, write `surname` instead of `name`. Required if `hintText` is unspecified. Otherwise, optional.
              */
             label?:
                 string;
@@ -891,8 +893,8 @@ declare namespace gapi.client {
             name?:
                 string;
             /**
-             * What to do when a change occurs in the text input field. Examples of changes include a user adding to the field, or deleting text. Examples of actions to take include running a
-             * custom function or opening a [dialog](https://developers.google.com/chat/how-tos/dialogs) in Google Chat.
+             * What to do when a change occurs in the text input field. For example, a user adding to the field or deleting text. Examples of actions to take include running a custom function or
+             * opening a [dialog](https://developers.google.com/chat/how-tos/dialogs) in Google Chat.
              */
             onChangeAction?:
                 GoogleAppsCardV1Action;
@@ -978,8 +980,10 @@ declare namespace gapi.client {
             textInput?:
                 GoogleAppsCardV1TextInput;
             /**
-             * Displays a text paragraph. Supports simple HTML formatted text. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in Google
-             * Workspace Add-ons. For example, the following JSON creates a bolded text: ``` "textParagraph": { "text": " *bold text*" } ```
+             * Displays a text paragraph. Supports simple HTML formatted text. For more information about formatting text, see [Formatting text in Google Chat
+             * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
+             * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting). For example, the following JSON creates a bolded text: ``` "textParagraph": { "text": "
+             * *bold text*" } ```
              */
             textParagraph?:
                 GoogleAppsCardV1TextParagraph;
@@ -1009,29 +1013,29 @@ declare namespace gapi.client {
         }
         interface Image {
             /**
-             * The aspect ratio of this image (width/height). This field allows clients to reserve the right height for the image while waiting for it to load. It's not meant to override the
-             * native aspect ratio of the image. If unset, the server fills it by prefetching the image.
+             * The aspect ratio of this image (width and height). This field lets you reserve the right height for the image while waiting for it to load. It's not meant to override the built-in
+             * aspect ratio of the image. If unset, the server fills it by prefetching the image.
              */
             aspectRatio?:
                 number;
             /** The URL of the image. */
             imageUrl?:
                 string;
-            /** The onclick action. */
+            /** The `onclick` action. */
             onClick?:
                 OnClick;
         }
         interface ImageButton {
-            /** The icon specified by an enum that indices to an icon provided by Chat API. */
+            /** The icon specified by an `enum` that indices to an icon provided by Chat API. */
             icon?:
                 string;
             /** The icon specified by a URL. */
             iconUrl?:
                 string;
-            /** The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify. */
+            /** The name of this `image_button` that's used for accessibility. Default value is provided if this name isn't specified. */
             name?:
                 string;
-            /** The onclick action. */
+            /** The `onclick` action. */
             onClick?:
                 OnClick;
         }
@@ -1051,8 +1055,9 @@ declare namespace gapi.client {
         }
         interface KeyValue {
             /**
-             * The text of the bottom label. Formatted text supported. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in Google Workspace
-             * Add-ons.
+             * The text of the bottom label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat
+             * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
+             * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
              */
             bottomLabel?:
                 string;
@@ -1060,26 +1065,28 @@ declare namespace gapi.client {
             button?:
                 Button;
             /**
-             * The text of the content. Formatted text supported and always required. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in
-             * Google Workspace Add-ons.
+             * The text of the content. Formatted text supported and always required. For more information about formatting text, see [Formatting text in Google Chat
+             * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
+             * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
              */
             content?:
                 string;
             /** If the content should be multiline. */
             contentMultiline?:
                 boolean;
-            /** An enum value that will be replaced by the Chat API with the corresponding icon image. */
+            /** An enum value that's replaced by the Chat API with the corresponding icon image. */
             icon?:
                 string;
             /** The icon specified by a URL. */
             iconUrl?:
                 string;
-            /** The onclick action. Only the top label, bottom label and content region are clickable. */
+            /** The `onclick` action. Only the top label, bottom label, and content region are clickable. */
             onClick?:
                 OnClick;
             /**
-             * The text of the top label. Formatted text supported. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in Google Workspace
-             * Add-ons.
+             * The text of the top label. Formatted text supported. For more information about formatting text, see [Formatting text in Google Chat
+             * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
+             * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
              */
             topLabel?:
                 string;
@@ -1088,7 +1095,7 @@ declare namespace gapi.client {
             /** List of memberships in the requested (or first) page. */
             memberships?:
                 Membership[];
-            /** A token that can be sent as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages. */
+            /** A token that you can send as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages. */
             nextPageToken?:
                 string;
         }
@@ -1096,12 +1103,12 @@ declare namespace gapi.client {
             /** List of messages. */
             messages?:
                 Message[];
-            /** A token that can be sent as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages. */
+            /** You can send a token as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages. */
             nextPageToken?:
                 string;
         }
         interface ListReactionsResponse {
-            /** Continuation token to retrieve the next page of results. It will be empty for the last page of results. */
+            /** Continuation token to retrieve the next page of results. It's empty for the last page of results. */
             nextPageToken?:
                 string;
             /** List of reactions in the requested (or first) page. */
@@ -1109,7 +1116,7 @@ declare namespace gapi.client {
                 Reaction[];
         }
         interface ListSpacesResponse {
-            /** A token that can be sent as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages. */
+            /** You can send a token as `pageToken` to retrieve the next page of results. If empty, there are no subsequent pages. */
             nextPageToken?:
                 string;
             /** List of spaces in the requested (or first) page. */
@@ -1117,7 +1124,7 @@ declare namespace gapi.client {
                 Space[];
         }
         interface MatchedUrl {
-            /** Output only. The url that was matched. */
+            /** Output only. The URL that was matched. */
             url?:
                 string;
         }
@@ -1136,7 +1143,7 @@ declare namespace gapi.client {
              */
             member?:
                 User;
-            /** Resource name of the membership, assigned by the server. Format: spaces/{space}/members/{member} */
+            /** Resource name of the membership, assigned by the server. Format: `spaces/{space}/members/{member}` */
             name?:
                 string;
             /** Output only. User's role within a Chat space, which determines their permitted actions in the space. */
@@ -1160,7 +1167,7 @@ declare namespace gapi.client {
             attachment?:
                 Attachment[];
             /**
-             * Deprecated: Use `cards_v2` instead. Rich, formatted and interactive cards that can be used to display UI elements such as: formatted texts, buttons, clickable images. Cards are
+             * Deprecated: Use `cards_v2` instead. Rich, formatted, and interactive cards that you can use to display UI elements such as: formatted texts, buttons, and clickable images. Cards are
              * normally displayed below the plain-text body of the message. `cards` and `cards_v2` can have a maximum size of 32 KB.
              */
             cards?:
@@ -1181,7 +1188,7 @@ declare namespace gapi.client {
              */
             clientAssignedMessageId?:
                 string;
-            /** Output only. The time at which the message was created in Google Chat server. */
+            /** Output only. The time at which the message was created in Google Chat. */
             createTime?:
                 string;
             /**
@@ -1196,14 +1203,14 @@ declare namespace gapi.client {
             /** Output only. The list of emoji reaction summaries on the message. [Developer Preview](https://developers.google.com/workspace/preview). */
             emojiReactionSummaries?:
                 EmojiReactionSummary[];
-            /** A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications). */
+            /** A plain-text description of the message's cards, used when the actual cards can't be displayed—for example, mobile notifications. */
             fallbackText?:
                 string;
             /** Output only. The time at which the message was last edited by a user. If the message has never been edited, this field is empty. */
             lastUpdateTime?:
                 string;
             /**
-             * Output only. A URL in `spaces.messages.text` that matches a link preview pattern. For more information, refer to [Preview
+             * Output only. A URL in `spaces.messages.text` that matches a link preview pattern. For more information, see [Preview
              * links](https://developers.google.com/chat/how-tos/preview-links).
              */
             matchedUrl?:
@@ -1243,10 +1250,10 @@ declare namespace gapi.client {
                 boolean;
         }
         interface OnClick {
-            /** A form action will be triggered by this onclick if specified. */
+            /** A form action is triggered by this `onclick` action if specified. */
             action?:
                 FormAction;
-            /** This onclick triggers an open link action if specified. */
+            /** This `onclick` action triggers an open link action if specified. */
             openLink?:
                 OpenLink;
         }
@@ -1259,7 +1266,7 @@ declare namespace gapi.client {
             /** The emoji used in the reaction. */
             emoji?:
                 Emoji;
-            /** The resource name of the reaction. Format: spaces/{space}/messages/{message}/reactions/{reaction} */
+            /** The resource name of the reaction. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` */
             name?:
                 string;
             /** Output only. The user who created the reaction. */
@@ -1268,12 +1275,13 @@ declare namespace gapi.client {
         }
         interface Section {
             /**
-             * The header of the section. Formatted text is supported. For more information about formatting text, see Formatting text in Google Chat apps and Formatting text in Google Workspace
-             * Add-ons.
+             * The header of the section. Formatted text is supported. For more information about formatting text, see [Formatting text in Google Chat
+             * apps](https://developers.google.com/chat/api/guides/message-formats/cards#card_text_formatting) and [Formatting text in Google Workspace
+             * Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
              */
             header?:
                 string;
-            /** A section must contain at least 1 widget. */
+            /** A section must contain at least one widget. */
             widgets?:
                 WidgetMarkup[];
         }
@@ -1304,7 +1312,7 @@ declare namespace gapi.client {
                 Space;
         }
         interface SlashCommand {
-            /** The id of the slash command invoked. */
+            /** The ID of the slash command invoked. */
             commandId?:
                 string;
         }
@@ -1312,13 +1320,13 @@ declare namespace gapi.client {
             /** The Chat app whose command was invoked. */
             bot?:
                 User;
-            /** The command id of the invoked slash command. */
+            /** The command ID of the invoked slash command. */
             commandId?:
                 string;
             /** The name of the invoked slash command. */
             commandName?:
                 string;
-            /** Indicating whether the slash command is for a dialog. */
+            /** Indicates whether the slash command is for a dialog. */
             triggersDialog?:
                 boolean;
             /** The type of slash command. */
@@ -1333,12 +1341,12 @@ declare namespace gapi.client {
             adminInstalled?:
                 boolean;
             /**
-             * The space's display name. Required when [creating a space](https://developers.google.com/chat/api/reference/rest/v1/spaces/create). For direct messages, this field may be empty.
+             * The space's display name. Required when [creating a space](https://developers.google.com/chat/api/reference/rest/v1/spaces/create). For direct messages, this field might be empty.
              * Supports up to 128 characters.
              */
             displayName?:
                 string;
-            /** Resource name of the space. Format: spaces/{space} */
+            /** Resource name of the space. Format: `spaces/{space}` */
             name?:
                 string;
             /** Optional. Whether the space is a DM between a Chat app and a single human. */
@@ -1364,7 +1372,7 @@ declare namespace gapi.client {
                 string;
         }
         interface SpaceDetails {
-            /** Optional. A description of the space. It could describe the space's discussion topic, functional purpose, or participants. Supports up to 150 characters. */
+            /** Optional. A description of the space. For example, describe the space's discussion topic, functional purpose, or participants. Supports up to 150 characters. */
             description?:
                 string;
             /** Optional. The space's rules, expectations, and etiquette. Supports up to 5,000 characters. */
@@ -1391,7 +1399,7 @@ declare namespace gapi.client {
                 string[];
         }
         interface TextButton {
-            /** The onclick action of the button. */
+            /** The `onclick` action of the button. */
             onClick?:
                 OnClick;
             /** The text of the button. */
@@ -1403,7 +1411,7 @@ declare namespace gapi.client {
                 string;
         }
         interface Thread {
-            /** Resource name of the thread. Example: spaces/{space}/threads/{thread} */
+            /** Resource name of the thread. Example: `spaces/{space}/threads/{thread}` */
             name?:
                 string;
             /**
@@ -1611,12 +1619,12 @@ declare namespace gapi.client {
         }
         interface MembersResource {
             /**
-             * [Developer Preview](https://developers.google.com/workspace/preview): Creates a human membership or app membership for the calling app. Creating memberships for other apps is not
+             * [Developer Preview](https://developers.google.com/workspace/preview): Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't
              * supported. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.memberships` (for human membership) or `chat.memberships.app` (for
              * app membership) scope. To specify the member to add, set the `membership.member.name` in the `CreateMembershipRequest`: - To add the calling app to the space, use `users/app`. - To
              * add a human user, use `users/{user}`, where `{user}` is either the `{person_id}` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or
-             * the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. For example, if the People API `Person`
-             * `resourceName` is `people/123456789`, the user can be added to the space by setting the `membership.member.name` to `users/123456789`.
+             * the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Directory API. For example, if the People API `Person` `resourceName` is
+             * `people/123456789`, you can add the user to the space by setting the `membership.member.name` to `users/123456789`.
              */
             create(request: {
                 /** V1 error format. */
@@ -1724,7 +1732,7 @@ declare namespace gapi.client {
                 /**
                  * Required. Resource name of the membership to delete. Chat apps can delete human users' or their own memberships. Chat apps can't delete other apps' memberships. When deleting a
                  * human membership, requires the `chat.memberships` scope and `spaces/{space}/members/{member}` format. When deleting an app membership, requires the `chat.memberships.app` scope
-                 * and `spaces/{space}/members/app` format. Format: spaces/{space}/members/{member} or spaces/{space}/members/app
+                 * and `spaces/{space}/members/app` format. Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
                  */
                 name:
                     string;
@@ -1769,7 +1777,7 @@ declare namespace gapi.client {
                 /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
                 key?:
                     string;
-                /** Required. Resource name of the membership to retrieve. Format: spaces/{space}/members/{member} */
+                /** Required. Resource name of the membership to retrieve. Format: `spaces/{space}/members/{member}` */
                 name:
                     string;
                 /** OAuth 2.0 token for the current user. */
@@ -1826,14 +1834,14 @@ declare namespace gapi.client {
                 oauth_token?:
                     string;
                 /**
-                 * The maximum number of memberships to return. The service may return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1000;
-                 * values above 1000 are coerced to 1000. Negative values return an INVALID_ARGUMENT error.
+                 * The maximum number of memberships to return. The service might return fewer than this value. If unspecified, at most 100 memberships are returned. The maximum value is 1,000. If
+                 * you use a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.
                  */
                 pageSize?:
                     number;
                 /**
-                 * A page token, received from a previous call to list memberships. Provide this to retrieve the subsequent page. When paginating, all other parameters provided should match the
-                 * call that provided the page token. Passing different values to the other parameters may lead to unexpected results.
+                 * A page token, received from a previous call to list memberships. Provide this parameter to retrieve the subsequent page. When paginating, all other parameters provided should
+                 * match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.
                  */
                 pageToken?:
                     string;
@@ -1884,7 +1892,7 @@ declare namespace gapi.client {
                 /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
                 key?:
                     string;
-                /** Required. Resource name of the attachment, in the form "spaces/*‍/messages/*‍/attachments/*". */
+                /** Required. Resource name of the attachment, in the form `spaces/*‍/messages/*‍/attachments/*`. */
                 name:
                     string;
                 /** OAuth 2.0 token for the current user. */
@@ -1932,7 +1940,7 @@ declare namespace gapi.client {
                 /** OAuth 2.0 token for the current user. */
                 oauth_token?:
                     string;
-                /** Required. The message where the reaction is created. Format: spaces/{space}/messages/{message} */
+                /** Required. The message where the reaction is created. Format: `spaces/{space}/messages/{message}` */
                 parent:
                     string;
                 /** Returns response with indentations and line breaks. */
@@ -1973,7 +1981,7 @@ declare namespace gapi.client {
                 /** OAuth 2.0 token for the current user. */
                 oauth_token?:
                     string;
-                /** Required. The message where the reaction is created. Format: spaces/{space}/messages/{message} */
+                /** Required. The message where the reaction is created. Format: `spaces/{space}/messages/{message}` */
                 parent:
                     string;
                 /** Returns response with indentations and line breaks. */
@@ -2013,7 +2021,7 @@ declare namespace gapi.client {
                 /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
                 key?:
                     string;
-                /** Required. Name of the reaction to delete. Format: spaces/{space}/messages/{message}/reactions/{reaction} */
+                /** Required. Name of the reaction to delete. Format: `spaces/{space}/messages/{message}/reactions/{reaction}` */
                 name:
                     string;
                 /** OAuth 2.0 token for the current user. */
@@ -2073,18 +2081,18 @@ declare namespace gapi.client {
                 oauth_token?:
                     string;
                 /**
-                 * Optional. The maximum number of reactions returned. The service may return fewer reactions than this value. If unspecified, the default value is 25. The maximum value is 200;
+                 * Optional. The maximum number of reactions returned. The service can return fewer reactions than this value. If unspecified, the default value is 25. The maximum value is 200;
                  * values above 200 are changed to 200.
                  */
                 pageSize?:
                     number;
                 /**
                  * Optional. (If resuming from a previous query.) A page token received from a previous list reactions call. Provide this to retrieve the subsequent page. When paginating, the
-                 * filter value should match the call that provided the page token. Passing a different value may lead to unexpected results.
+                 * filter value should match the call that provided the page token. Passing a different value might lead to unexpected results.
                  */
                 pageToken?:
                     string;
-                /** Required. The message users reacted to. Format: spaces/{space}/messages/{message} */
+                /** Required. The message users reacted to. Format: `spaces/{space}/messages/{message}` */
                 parent:
                     string;
                 /** Returns response with indentations and line breaks. */
@@ -2143,7 +2151,7 @@ declare namespace gapi.client {
                 /** OAuth 2.0 token for the current user. */
                 oauth_token?:
                     string;
-                /** Required. The resource name of the space in which to create a message. Format: spaces/{space} */
+                /** Required. The resource name of the space in which to create a message. Format: `spaces/{space}` */
                 parent:
                     string;
                 /** Returns response with indentations and line breaks. */
@@ -2203,7 +2211,7 @@ declare namespace gapi.client {
                 /** OAuth 2.0 token for the current user. */
                 oauth_token?:
                     string;
-                /** Required. The resource name of the space in which to create a message. Format: spaces/{space} */
+                /** Required. The resource name of the space in which to create a message. Format: `spaces/{space}` */
                 parent:
                     string;
                 /** Returns response with indentations and line breaks. */
@@ -2262,7 +2270,7 @@ declare namespace gapi.client {
                 /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
                 key?:
                     string;
-                /** Required. Resource name of the message to be deleted, in the form "spaces/*‍/messages/*" Example: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB */
+                /** Required. Resource name of the message that you want to delete, in the form `spaces/*‍/messages/*` Example: `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB` */
                 name:
                     string;
                 /** OAuth 2.0 token for the current user. */
@@ -2309,9 +2317,9 @@ declare namespace gapi.client {
                 key?:
                     string;
                 /**
-                 * Required. Resource name of the message to retrieve. Format: spaces/{space}/messages/{message} If the message begins with `client-`, then it has a custom name assigned by a Chat
-                 * app that created it with the Chat REST API. That Chat app (but not others) can pass the custom name to get, update, or delete the message. To learn more, see [create and name a
-                 * message] (https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message).
+                 * Required. Resource name of the message to retrieve. Format: `spaces/{space}/messages/{message}` If the message begins with `client-`, then it has a custom name assigned by a
+                 * Chat app that created it with the Chat REST API. That Chat app (but not others) can pass the custom name to get, update, or delete the message. To learn more, see [create and
+                 * name a message] (https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message).
                  */
                 name:
                     string;
@@ -2371,24 +2379,24 @@ declare namespace gapi.client {
                 oauth_token?:
                     string;
                 /**
-                 * Optional, if resuming from a previous query. How the list of messages is ordered. Specify a value to order by and an ordering operation. Valid ordering operation values are: -
-                 * `ASC` for ascending. - `DESC` for descending. The default ordering is `create_time ASC`.
+                 * Optional, if resuming from a previous query. How the list of messages is ordered. Specify a value to order by an ordering operation. Valid ordering operation values are as
+                 * follows: - `ASC` for ascending. - `DESC` for descending. The default ordering is `create_time ASC`.
                  */
                 orderBy?:
                     string;
                 /**
-                 * The maximum number of messages returned. The service may return fewer messages than this value. If unspecified, at most 25 are returned. The maximum value is 1000; values above
-                 * 1000 are coerced to 1000. Negative values return an `INVALID_ARGUMENT` error.
+                 * The maximum number of messages returned. The service might return fewer messages than this value. If unspecified, at most 25 are returned. The maximum value is 1,000. If you use
+                 * a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.
                  */
                 pageSize?:
                     number;
                 /**
-                 * Optional, if resuming from a previous query. A page token received from a previous list messages call. Provide this to retrieve the subsequent page. When paginating, all other
-                 * parameters provided should match the call that provided the page token. Passing different values to the other parameters may lead to unexpected results.
+                 * Optional, if resuming from a previous query. A page token received from a previous list messages call. Provide this parameter to retrieve the subsequent page. When paginating,
+                 * all other parameters provided should match the call that provided the page token. Passing different values to the other parameters might lead to unexpected results.
                  */
                 pageToken?:
                     string;
-                /** Required. The resource name of the space to list messages from. Format: spaces/{space} */
+                /** Required. The resource name of the space to list messages from. Format: `spaces/{space}` */
                 parent:
                     string;
                 /** Returns response with indentations and line breaks. */
@@ -2423,7 +2431,7 @@ declare namespace gapi.client {
                 access_token?:
                     string;
                 /**
-                 * Optional. If `true` and the message is not found, a new message is created and `updateMask` is ignored. The specified message ID must be
+                 * Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be
                  * [client-assigned](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message) or the request fails.
                  */
                 allowMissing?:
@@ -2453,8 +2461,8 @@ declare namespace gapi.client {
                 quotaUser?:
                     string;
                 /**
-                 * Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - text - cards (Requires [service account
-                 * authentication](/chat/api/guides/auth/service-accounts).) - cards_v2
+                 * Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `cards` (Requires [service account
+                 * authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2`
                  */
                 updateMask?:
                     string;
@@ -2476,7 +2484,7 @@ declare namespace gapi.client {
                 access_token?:
                     string;
                 /**
-                 * Optional. If `true` and the message is not found, a new message is created and `updateMask` is ignored. The specified message ID must be
+                 * Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be
                  * [client-assigned](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message) or the request fails.
                  */
                 allowMissing?:
@@ -2506,8 +2514,8 @@ declare namespace gapi.client {
                 quotaUser?:
                     string;
                 /**
-                 * Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - text - cards (Requires [service account
-                 * authentication](/chat/api/guides/auth/service-accounts).) - cards_v2
+                 * Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `cards` (Requires [service account
+                 * authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2`
                  */
                 updateMask?:
                     string;
@@ -2535,7 +2543,7 @@ declare namespace gapi.client {
                 access_token?:
                     string;
                 /**
-                 * Optional. If `true` and the message is not found, a new message is created and `updateMask` is ignored. The specified message ID must be
+                 * Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be
                  * [client-assigned](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message) or the request fails.
                  */
                 allowMissing?:
@@ -2565,8 +2573,8 @@ declare namespace gapi.client {
                 quotaUser?:
                     string;
                 /**
-                 * Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - text - cards (Requires [service account
-                 * authentication](/chat/api/guides/auth/service-accounts).) - cards_v2
+                 * Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `cards` (Requires [service account
+                 * authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2`
                  */
                 updateMask?:
                     string;
@@ -2588,7 +2596,7 @@ declare namespace gapi.client {
                 access_token?:
                     string;
                 /**
-                 * Optional. If `true` and the message is not found, a new message is created and `updateMask` is ignored. The specified message ID must be
+                 * Optional. If `true` and the message isn't found, a new message is created and `updateMask` is ignored. The specified message ID must be
                  * [client-assigned](https://developers.google.com/chat/api/guides/crudl/messages#name_a_created_message) or the request fails.
                  */
                 allowMissing?:
@@ -2618,8 +2626,8 @@ declare namespace gapi.client {
                 quotaUser?:
                     string;
                 /**
-                 * Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - text - cards (Requires [service account
-                 * authentication](/chat/api/guides/auth/service-accounts).) - cards_v2
+                 * Required. The field paths to update. Separate multiple values with commas. Currently supported field paths: - `text` - `cards` (Requires [service account
+                 * authentication](/chat/api/guides/auth/service-accounts).) - `cards_v2`
                  */
                 updateMask?:
                     string;
@@ -2638,7 +2646,7 @@ declare namespace gapi.client {
         }
         interface SpacesResource {
             /**
-             * [Developer Preview](https://developers.google.com/workspace/preview): Creates a named space. Spaces grouped by topics or that have guest access are not supported. Requires [user
+             * [Developer Preview](https://developers.google.com/workspace/preview): Creates a named space. Spaces grouped by topics or that have guest access aren't supported. Requires [user
              * authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
              */
             create(request: {
@@ -2728,9 +2736,9 @@ declare namespace gapi.client {
             },
             body: Space): Request<Space>;
             /**
-             * [Developer Preview](https://developers.google.com/workspace/preview): Deletes a named space. Always performs a cascading delete, which means that the space's child resources - like
-             * messages posted in the space and memberships in the space - are also deleted. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) from a user
-             * who has permission to delete the space, and the `chat.delete` scope.
+             * [Developer Preview](https://developers.google.com/workspace/preview): Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like
+             * messages posted in the space and memberships in the space—are also deleted. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) from a user who
+             * has permission to delete the space, and the `chat.delete` scope.
              */
             delete(request?: {
                 /** V1 error format. */
@@ -2751,7 +2759,7 @@ declare namespace gapi.client {
                 /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
                 key?:
                     string;
-                /** Required. Resource name of the space to delete. Format: spaces/{space} */
+                /** Required. Resource name of the space to delete. Format: `spaces/{space}` */
                 name:
                     string;
                 /** OAuth 2.0 token for the current user. */
@@ -2797,9 +2805,9 @@ declare namespace gapi.client {
                 key?:
                     string;
                 /**
-                 * Required. Resource name of the user to find direct message with. Format: users/{user}, where `{user}` is either the `{person_id}` for the
+                 * Required. Resource name of the user to find direct message with. Format: `users/{user}`, where `{user}` is either the `{person_id}` for the
                  * [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for the
-                 * [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. For example, if the People API `Person.resourceName` is
+                 * [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Directory API. For example, if the People API `Person.resourceName` is
                  * `people/123456789`, you can find a direct message with that person by using `users/123456789` as the `name`.
                  */
                 name?:
@@ -2845,7 +2853,7 @@ declare namespace gapi.client {
                 /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
                 key?:
                     string;
-                /** Required. Resource name of the space, in the form "spaces/*". Format: spaces/{space} */
+                /** Required. Resource name of the space, in the form "spaces/*". Format: `spaces/{space}` */
                 name:
                     string;
                 /** OAuth 2.0 token for the current user. */
@@ -2889,11 +2897,11 @@ declare namespace gapi.client {
                     string;
                 /**
                  * Optional. A query filter. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users). You can filter spaces by the space type
-                 * ([`space_type`](https://developers.google.com/chat/api/reference/rest/v1/spaces#spacetype)). To filter by space type, you must specify valid `enum` value, such as `SPACE` or
-                 * `GROUP_CHAT` (the `space_type` cannot be `SPACE_TYPE_UNSPECIFIED`). To query for multiple space types, use the `OR` operator. For example, the following queries are valid: ```
+                 * ([`space_type`](https://developers.google.com/chat/api/reference/rest/v1/spaces#spacetype)). To filter by space type, you must specify valid enum value, such as `SPACE` or
+                 * `GROUP_CHAT` (the `space_type` can't be `SPACE_TYPE_UNSPECIFIED`). To query for multiple space types, use the `OR` operator. For example, the following queries are valid: ```
                  * space_type = "SPACE" spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE" ``` Invalid queries are rejected by the server with an `INVALID_ARGUMENT` error. With [service
-                 * account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts), this field is ignored and the query always returns all spaces. But Chat API still
-                 * validates the query syntax with service accounts, so invalid queries are still rejected. [Developer Preview](https://developers.google.com/workspace/preview).
+                 * account authentication](https://developers.google.com/chat/api/guides/auth/service-accounts), this field is ignored and the query always returns all spaces. But the Chat API
+                 * still validates the query syntax with service accounts, so invalid queries are still rejected. [Developer Preview](https://developers.google.com/workspace/preview).
                  */
                 filter?:
                     string;
@@ -2904,14 +2912,14 @@ declare namespace gapi.client {
                 oauth_token?:
                     string;
                 /**
-                 * Optional. The maximum number of spaces to return. The service may return fewer than this value. If unspecified, at most 100 spaces are returned. The maximum value is 1000;
-                 * values above 1000 are coerced to 1000. Negative values return an `INVALID_ARGUMENT` error.
+                 * Optional. The maximum number of spaces to return. The service might return fewer than this value. If unspecified, at most 100 spaces are returned. The maximum value is 1,000. If
+                 * you use a value more than 1,000, it's automatically changed to 1,000. Negative values return an `INVALID_ARGUMENT` error.
                  */
                 pageSize?:
                     number;
                 /**
-                 * Optional. A page token, received from a previous list spaces call. Provide this to retrieve the subsequent page. When paginating, the filter value should match the call that
-                 * provided the page token. Passing a different value may lead to unexpected results.
+                 * Optional. A page token, received from a previous list spaces call. Provide this parameter to retrieve the subsequent page. When paginating, the filter value should match the
+                 * call that provided the page token. Passing a different value may lead to unexpected results.
                  */
                 pageToken?:
                     string;
@@ -2951,7 +2959,7 @@ declare namespace gapi.client {
                 /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
                 key?:
                     string;
-                /** Resource name of the space. Format: spaces/{space} */
+                /** Resource name of the space. Format: `spaces/{space}` */
                 name:
                     string;
                 /** OAuth 2.0 token for the current user. */
@@ -2964,12 +2972,12 @@ declare namespace gapi.client {
                 quotaUser?:
                     string;
                 /**
-                 * Required. The field paths to be updated, comma separated if there are multiple. Currently supported field paths: - display_name (Only supports changing the display name of a
-                 * space with the SPACE type, or when also including the `space_type` mask to change a GROUP_CHAT space type to SPACE. Trying to update the display name of a GROUP_CHAT or a
-                 * DIRECT_MESSAGE space results in an invalid argument error.) - space_type (Only supports changing a GROUP_CHAT space type to SPACE. Include `display_name` together with
-                 * `space_type` in the update mask and ensure that the specified space has a non-empty display name and the SPACE space type. Including the `space_type` mask and the SPACE type in
-                 * the specified space when updating the display name is optional if the existing space already has the SPACE type. Trying to update the space type in other ways results in an
-                 * invalid argument error). - space_details - space_history_state (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the
+                 * Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space
+                 * with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a
+                 * `DIRECT_MESSAGE` space results in an invalid argument error.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with
+                 * `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type
+                 * in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an
+                 * invalid argument error). - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the
                  * organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.)
                  */
                 updateMask?:
@@ -3003,7 +3011,7 @@ declare namespace gapi.client {
                 /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
                 key?:
                     string;
-                /** Resource name of the space. Format: spaces/{space} */
+                /** Resource name of the space. Format: `spaces/{space}` */
                 name:
                     string;
                 /** OAuth 2.0 token for the current user. */
@@ -3016,12 +3024,12 @@ declare namespace gapi.client {
                 quotaUser?:
                     string;
                 /**
-                 * Required. The field paths to be updated, comma separated if there are multiple. Currently supported field paths: - display_name (Only supports changing the display name of a
-                 * space with the SPACE type, or when also including the `space_type` mask to change a GROUP_CHAT space type to SPACE. Trying to update the display name of a GROUP_CHAT or a
-                 * DIRECT_MESSAGE space results in an invalid argument error.) - space_type (Only supports changing a GROUP_CHAT space type to SPACE. Include `display_name` together with
-                 * `space_type` in the update mask and ensure that the specified space has a non-empty display name and the SPACE space type. Including the `space_type` mask and the SPACE type in
-                 * the specified space when updating the display name is optional if the existing space already has the SPACE type. Trying to update the space type in other ways results in an
-                 * invalid argument error). - space_details - space_history_state (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the
+                 * Required. The updated field paths, comma separated if there are multiple. Currently supported field paths: - `display_name` (Only supports changing the display name of a space
+                 * with the `SPACE` type, or when also including the `space_type` mask to change a `GROUP_CHAT` space type to `SPACE`. Trying to update the display name of a `GROUP_CHAT` or a
+                 * `DIRECT_MESSAGE` space results in an invalid argument error.) - `space_type` (Only supports changing a `GROUP_CHAT` space type to `SPACE`. Include `display_name` together with
+                 * `space_type` in the update mask and ensure that the specified space has a non-empty display name and the `SPACE` space type. Including the `space_type` mask and the `SPACE` type
+                 * in the specified space when updating the display name is optional if the existing space already has the `SPACE` type. Trying to update the space type in other ways results in an
+                 * invalid argument error). - `space_details` - `space_history_state` (Supports [turning history on or off for the space](https://support.google.com/chat/answer/7664687) if [the
                  * organization allows users to change their history setting](https://support.google.com/a/answer/7664184). Warning: mutually exclusive with all other field paths.)
                  */
                 updateMask?:
@@ -3044,7 +3052,7 @@ declare namespace gapi.client {
              * membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set
              * `Space.singleUserBotDm` to true and don't specify any memberships. You can only use this method to add app memberships to DMs. To add the calling app as a member of other space
              * types, use [create membership](https://developers.google.com/chat/api/reference/rest/v1/spaces.members/create) If a DM already exists between two users, even when one user blocks
-             * the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies or guest access are not supported. Requires [user
+             * the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies or guest access aren't supported. Requires [user
              * authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
              */
             setup(request: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.chat-v1",
-  "version": "0.0.20230514",
+  "version": "0.0.20230516",
   "description": "TypeScript typings for Google Chat API v1",
   "license": "MIT",
   "author": {

package/readme.md

@@ -116,12 +116,12 @@ await gapi.client.chat.media.download({ resourceName: "resourceName",  });
 await gapi.client.chat.media.upload({ parent: "parent",  });
 
 /*
-[Developer Preview](https://developers.google.com/workspace/preview): Creates a named space. Spaces grouped by topics or that have guest access are not supported. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
+[Developer Preview](https://developers.google.com/workspace/preview): Creates a named space. Spaces grouped by topics or that have guest access aren't supported. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
 */
 await gapi.client.chat.spaces.create({  });
 
 /*
-[Developer Preview](https://developers.google.com/workspace/preview): Deletes a named space. Always performs a cascading delete, which means that the space's child resources - like messages posted in the space and memberships in the space - are also deleted. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) from a user who has permission to delete the space, and the `chat.delete` scope.
+[Developer Preview](https://developers.google.com/workspace/preview): Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like messages posted in the space and memberships in the space—are also deleted. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) from a user who has permission to delete the space, and the `chat.delete` scope.
 */
 await gapi.client.chat.spaces.delete({ name: "name",  });
 
@@ -146,7 +146,7 @@ await gapi.client.chat.spaces.list({  });
 await gapi.client.chat.spaces.patch({ name: "name",  });
 
 /*
-[Developer Preview](https://developers.google.com/workspace/preview): Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. To specify the human members to add, add memberships with the appropriate `member.name` in the `SetUpSpaceRequest`. To add a human user, use `users/{user}`, where `{user}` is either the `{person_id}` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. For example, if the People API `Person` `resourceName` is `people/123456789`, you can add the user to the space by including a membership with `users/123456789` as the `member.name`. For a space or group chat, if the caller blocks or is blocked by some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to true and don't specify any memberships. You can only use this method to add app memberships to DMs. To add the calling app as a member of other space types, use [create membership](https://developers.google.com/chat/api/reference/rest/v1/spaces.members/create) If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies or guest access are not supported. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
+[Developer Preview](https://developers.google.com/workspace/preview): Creates a space and adds specified users to it. The calling user is automatically added to the space, and shouldn't be specified as a membership in the request. To specify the human members to add, add memberships with the appropriate `member.name` in the `SetUpSpaceRequest`. To add a human user, use `users/{user}`, where `{user}` is either the `{person_id}` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. For example, if the People API `Person` `resourceName` is `people/123456789`, you can add the user to the space by including a membership with `users/123456789` as the `member.name`. For a space or group chat, if the caller blocks or is blocked by some members, then those members aren't added to the created space. To create a direct message (DM) between the calling user and another human user, specify exactly one membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set `Space.singleUserBotDm` to true and don't specify any memberships. You can only use this method to add app memberships to DMs. To add the calling app as a member of other space types, use [create membership](https://developers.google.com/chat/api/reference/rest/v1/spaces.members/create) If a DM already exists between two users, even when one user blocks the other at the time a request is made, then the existing DM is returned. Spaces with threaded replies or guest access aren't supported. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
 */
 await gapi.client.chat.spaces.setup({  });
 ```

package/tests.ts

@@ -3,7 +3,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 
-// Revision: 20230514
+// Revision: 20230516
 
 gapi.load('client', async () => {
     /** now we can use gapi.client */
@@ -70,7 +70,7 @@ gapi.load('client', async () => {
             filename: "Test string",
         });
         /**
-         * [Developer Preview](https://developers.google.com/workspace/preview): Creates a named space. Spaces grouped by topics or that have guest access are not supported. Requires [user
+         * [Developer Preview](https://developers.google.com/workspace/preview): Creates a named space. Spaces grouped by topics or that have guest access aren't supported. Requires [user
          * authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
          */
         await gapi.client.chat.spaces.create({
@@ -91,9 +91,9 @@ gapi.load('client', async () => {
             type: "Test string",
         });
         /**
-         * [Developer Preview](https://developers.google.com/workspace/preview): Deletes a named space. Always performs a cascading delete, which means that the space's child resources - like
-         * messages posted in the space and memberships in the space - are also deleted. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) from a user who
-         * has permission to delete the space, and the `chat.delete` scope.
+         * [Developer Preview](https://developers.google.com/workspace/preview): Deletes a named space. Always performs a cascading delete, which means that the space's child resources—like
+         * messages posted in the space and memberships in the space—are also deleted. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) from a user who has
+         * permission to delete the space, and the `chat.delete` scope.
          */
         await gapi.client.chat.spaces.delete({
             name: "Test string",
@@ -161,7 +161,7 @@ gapi.load('client', async () => {
          * membership to represent the human user. If one user blocks the other, the request fails and the DM isn't created. To create a DM between the calling user and the calling app, set
          * `Space.singleUserBotDm` to true and don't specify any memberships. You can only use this method to add app memberships to DMs. To add the calling app as a member of other space types,
          * use [create membership](https://developers.google.com/chat/api/reference/rest/v1/spaces.members/create) If a DM already exists between two users, even when one user blocks the other at
-         * the time a request is made, then the existing DM is returned. Spaces with threaded replies or guest access are not supported. Requires [user
+         * the time a request is made, then the existing DM is returned. Spaces with threaded replies or guest access aren't supported. Requires [user
          * authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.spaces.create` or `chat.spaces` scope.
          */
         await gapi.client.chat.spaces.setup({
@@ -199,12 +199,12 @@ gapi.load('client', async () => {
             },
         });
         /**
-         * [Developer Preview](https://developers.google.com/workspace/preview): Creates a human membership or app membership for the calling app. Creating memberships for other apps is not
+         * [Developer Preview](https://developers.google.com/workspace/preview): Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't
          * supported. Requires [user authentication](https://developers.google.com/chat/api/guides/auth/users) and the `chat.memberships` (for human membership) or `chat.memberships.app` (for app
          * membership) scope. To specify the member to add, set the `membership.member.name` in the `CreateMembershipRequest`: - To add the calling app to the space, use `users/app`. - To add a
          * human user, use `users/{user}`, where `{user}` is either the `{person_id}` for the [person](https://developers.google.com/people/api/rest/v1/people) from the People API, or the `id` for
-         * the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Admin SDK Directory API. For example, if the People API `Person` `resourceName` is
-         * `people/123456789`, the user can be added to the space by setting the `membership.member.name` to `users/123456789`.
+         * the [user](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users) in the Directory API. For example, if the People API `Person` `resourceName` is `people/123456789`,
+         * you can add the user to the space by setting the `membership.member.name` to `users/123456789`.
          */
         await gapi.client.chat.spaces.members.create({
             parent: "Test string",