|
436 | 436 | ],
|
437 | 437 | "parameters": {
|
438 | 438 | "name": {
|
439 |
| - "description": "Resource name of the space. Format: `spaces/{space}`", |
| 439 | + "description": "Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.", |
440 | 440 | "location": "path",
|
441 | 441 | "pattern": "^spaces/[^/]+$",
|
442 | 442 | "required": true,
|
|
743 | 743 | "messages": {
|
744 | 744 | "methods": {
|
745 | 745 | "create": {
|
746 |
| - "description": "Creates a message in a Google Chat space. The maximum message size, including text and cards, is 32,000 bytes. For an example, see [Send a message](https://developers.google.com/workspace/chat/create-messages). Calling this method requires [authentication](https://developers.google.com/workspace/chat/authenticate-authorize) and supports the following authentication types: - For text messages, user authentication or app authentication are supported. - For card messages, only app authentication is supported. (Only Chat apps can create card messages.)", |
| 746 | + "description": "Creates a message in a Google Chat space. For an example, see [Send a message](https://developers.google.com/workspace/chat/create-messages). The `create()` method requires either user or app authentication. Chat attributes the message sender differently depending on the type of authentication that you use in your request. The following image shows how Chat attributes a message when you use app authentication. Chat displays the Chat app as the message sender. The content of the message can contain text (`text`), cards (`cardsV2`), and accessory widgets (`accessoryWidgets`).  The following image shows how Chat attributes a message when you use user authentication. Chat displays the user as the message sender and attributes the Chat app to the message by displaying its name. The content of message can only contain text (`text`).  The maximum message size, including the message contents, is 32,000 bytes.", |
747 | 747 | "flatPath": "v1/spaces/{spacesId}/messages",
|
748 | 748 | "httpMethod": "POST",
|
749 | 749 | "id": "chat.spaces.messages.create",
|
|
1324 | 1324 | }
|
1325 | 1325 | }
|
1326 | 1326 | },
|
1327 |
| - "revision": "20240818", |
| 1327 | + "revision": "20240825", |
1328 | 1328 | "rootUrl": "https://chat.googleapis.com/",
|
1329 | 1329 | "schemas": {
|
1330 | 1330 | "AccessSettings": {
|
|
2196 | 2196 | },
|
2197 | 2197 | "strokeColor": {
|
2198 | 2198 | "$ref": "Color",
|
2199 |
| - "description": "The colors to use when the type is `BORDER_TYPE_STROKE`." |
| 2199 | + "description": "The colors to use when the type is `BORDER_TYPE_STROKE`. To set the stroke color, specify a value for the `red`, `green`, and `blue` fields. The value must be a float number between 0 and 1 based on the RGB color value, where `0` (0/255) represents the absence of color and `1` (255/255) represents the maximum intensity of the color. For example, the following sets the color to red at its maximum intensity: ``` \"color\": { \"red\": 1, \"green\": 0, \"blue\": 0, } ``` The `alpha` field is unavailable for stroke color. If specified, this field is ignored." |
2200 | 2200 | },
|
2201 | 2201 | "type": {
|
2202 | 2202 | "description": "The border type.",
|
|
2225 | 2225 | },
|
2226 | 2226 | "color": {
|
2227 | 2227 | "$ref": "Color",
|
2228 |
| - "description": "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 } ```" |
| 2228 | + "description": "Optional. The color of the button. If set, the button `type` is set to `FILLED` and the color of `text` and `icon` fields are set to a contrasting color for readability. For example, if the button color is set to blue, any text or icons in the button are set to white. To set the button color, specify a value for the `red`, `green`, and `blue` fields. The value must be a float number between 0 and 1 based on the RGB color value, where `0` (0/255) represents the absence of color and `1` (255/255) represents the maximum intensity of the color. For example, the following sets the color to red at its maximum intensity: ``` \"color\": { \"red\": 1, \"green\": 0, \"blue\": 0, } ``` The `alpha` field is unavailable for button color. If specified, this field is ignored." |
2229 | 2229 | },
|
2230 | 2230 | "disabled": {
|
2231 | 2231 | "description": "If `true`, the button is displayed in an inactive state and doesn't respond to user actions.",
|
2232 | 2232 | "type": "boolean"
|
2233 | 2233 | },
|
2234 | 2234 | "icon": {
|
2235 | 2235 | "$ref": "GoogleAppsCardV1Icon",
|
2236 |
| - "description": "The icon image. If both `icon` and `text` are set, then the icon appears before the text." |
| 2236 | + "description": "An icon displayed inside the button. If both `icon` and `text` are set, then the icon appears before the text." |
2237 | 2237 | },
|
2238 | 2238 | "onClick": {
|
2239 | 2239 | "$ref": "GoogleAppsCardV1OnClick",
|
|
3088 | 3088 | "properties": {
|
3089 | 3089 | "buttonList": {
|
3090 | 3090 | "$ref": "GoogleAppsCardV1ButtonList",
|
3091 |
| - "description": "A list of buttons. For example, the following JSON creates two buttons. The first is a blue text button and the second is an image button that opens a link: ``` \"buttonList\": { \"buttons\": [ { \"text\": \"Edit\", \"color\": { \"red\": 0, \"green\": 0, \"blue\": 1, \"alpha\": 1 }, \"disabled\": true, }, { \"icon\": { \"knownIcon\": \"INVITE\", \"altText\": \"check calendar\" }, \"onClick\": { \"openLink\": { \"url\": \"https://example.com/calendar\" } } } ] } ```" |
| 3091 | + "description": "A list of buttons. For example, the following JSON creates two buttons. The first is a blue text button and the second is an image button that opens a link: ``` \"buttonList\": { \"buttons\": [ { \"text\": \"Edit\", \"color\": { \"red\": 0, \"green\": 0, \"blue\": 1, }, \"disabled\": true, }, { \"icon\": { \"knownIcon\": \"INVITE\", \"altText\": \"check calendar\" }, \"onClick\": { \"openLink\": { \"url\": \"https://example.com/calendar\" } } } ] } ```" |
3092 | 3092 | },
|
3093 | 3093 | "columns": {
|
3094 | 3094 | "$ref": "GoogleAppsCardV1Columns",
|
|
3756 | 3756 | "type": "array"
|
3757 | 3757 | },
|
3758 | 3758 | "cardsV2": {
|
3759 |
| - "description": "An array of [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards). Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the messages can't contain cards. To learn about cards and how to create them, see [Send card messages](https://developers.google.com/workspace/chat/create-messages#create). [Card builder](https://addons.gsuite.google.com/uikit/builder)", |
| 3759 | + "description": "An array of [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards). Only Chat apps can create cards. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the messages can't contain cards. To learn how to create a message that contains cards, see [Send a message](https://developers.google.com/workspace/chat/create-messages). [Card builder](https://addons.gsuite.google.com/uikit/builder)", |
3760 | 3760 | "items": {
|
3761 | 3761 | "$ref": "CardWithId"
|
3762 | 3762 | },
|
|
3816 | 3816 | },
|
3817 | 3817 | "privateMessageViewer": {
|
3818 | 3818 | "$ref": "User",
|
3819 |
| - "description": "Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send private messages to Google Chat users](https://developers.google.com/workspace/chat/private-messages)." |
| 3819 | + "description": "Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private)." |
3820 | 3820 | },
|
3821 | 3821 | "quotedMessageMetadata": {
|
3822 | 3822 | "$ref": "QuotedMessageMetadata",
|
|
3838 | 3838 | "description": "If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output populates the [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces) `name`."
|
3839 | 3839 | },
|
3840 | 3840 | "text": {
|
3841 |
| - "description": "Plain-text body of the message. The first link to an image, video, or web page generates a [preview chip](https://developers.google.com/workspace/chat/preview-links). You can also [@mention a Google Chat user](https://developers.google.com/workspace/chat/format-messages#messages-@mention), or everyone in the space. To learn about creating text messages, see [Send a text message](https://developers.google.com/workspace/chat/create-messages#create-text-messages).", |
| 3841 | + "description": "Plain-text body of the message. The first link to an image, video, or web page generates a [preview chip](https://developers.google.com/workspace/chat/preview-links). You can also [@mention a Google Chat user](https://developers.google.com/workspace/chat/format-messages#messages-@mention), or everyone in the space. To learn about creating text messages, see [Send a message](https://developers.google.com/workspace/chat/create-messages).", |
3842 | 3842 | "type": "string"
|
3843 | 3843 | },
|
3844 | 3844 | "thread": {
|
|
4238 | 4238 | "readOnly": true
|
4239 | 4239 | },
|
4240 | 4240 | "name": {
|
4241 |
| - "description": "Resource name of the space. Format: `spaces/{space}`", |
| 4241 | + "description": "Resource name of the space. Format: `spaces/{space}` Where `{space}` represents the system-assigned ID for the space. You can obtain the space ID by calling the [`spaces.list()`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/list) method or from the space URL. For example, if the space URL is `https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA`, the space ID is `AAAAAAAAA`.", |
4242 | 4242 | "type": "string"
|
4243 | 4243 | },
|
4244 | 4244 | "singleUserBotDm": {
|
|
0 commit comments