docs: update generated docs (#1053)
Updates for both discovery docs and epydoc API Documentation
Fixes: #1049
diff --git a/docs/dyn/chat_v1.spaces.messages.html b/docs/dyn/chat_v1.spaces.messages.html
index 45a8ce7..fe5254b 100644
--- a/docs/dyn/chat_v1.spaces.messages.html
+++ b/docs/dyn/chat_v1.spaces.messages.html
@@ -80,6 +80,9 @@
<p class="firstline">Returns the attachments Resource.</p>
<p class="toc_element">
+ <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
<code><a href="#create">create(parent, body=None, threadKey=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a message.</p>
<p class="toc_element">
@@ -93,361 +96,256 @@
<p class="firstline">Updates a message.</p>
<h3>Method Details</h3>
<div class="method">
+ <code class="details" id="close">close()</code>
+ <pre>Close httplib2 connections.</pre>
+</div>
+
+<div class="method">
<code class="details" id="create">create(parent, body=None, threadKey=None, x__xgafv=None)</code>
<pre>Creates a message.
Args:
- parent: string, Required. Space resource name, in the form "spaces/*".
-Example: spaces/AAAAMpdlehY (required)
+ parent: string, Required. Space resource name, in the form "spaces/*". Example: spaces/AAAAMpdlehY (required)
body: object, The request body.
The object takes the form of:
{ # A message in Hangouts Chat.
- "name": "A String", # Resource name, in the form "spaces/*/messages/*".
- #
- # Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
- "annotations": [ # Output only. Annotations associated with the text in this message.
- { # Annotations associated with the plain-text body of the message.
- #
- # Example plain-text message body:
- # ```
- # Hello @FooBot how are you!"
- # ```
- #
- # The corresponding annotations metadata:
- # ```
- # "annotations":[{
- # "type":"USER_MENTION",
- # "startIndex":6,
- # "length":7,
- # "userMention": {
- # "user": {
- # "name":"users/107946847022116401880",
- # "displayName":"FooBot",
- # "avatarUrl":"https://goo.gl/aeDtrS",
- # "type":"BOT"
- # },
- # "type":"MENTION"
- # }
- # }]
- # ```
- "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this
- # annotation corresponds to.
- "type": "A String", # The type of this annotation.
- "length": 42, # Length of the substring in the plain-text message body this annotation
- # corresponds to.
- "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
- "user": { # A user in Hangouts Chat. # The user mentioned.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "type": "A String", # The type of user mention.
- },
+ "sender": { # A user in Hangouts Chat. # The user who created the message.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is posted.
+ "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
+ "type": "A String", # The type of bot response.
+ },
+ "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat server.
+ "attachment": [ # User uploaded attachment.
+ { # An attachment in Hangouts Chat.
+ "source": "A String", # The source of the attachment.
+ "contentType": "A String", # The content type (MIME type) of the file.
+ "name": "A String", # Resource name of the attachment, in the form "spaces/*/messages/*/attachments/*".
+ "contentName": "A String", # The original file name for the content, not the full path.
+ "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
+ "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
},
- ],
- "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is
- # posted.
- "type": "A String", # The type of bot response.
- "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
- },
- "sender": { # A user in Hangouts Chat. # The user who created the message.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat
- # server.
- "text": "A String", # Plain-text body of the message.
- "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the
- # user, but any links to images, web pages, videos, etc. included here will
- # generate preview chips.
- "attachment": [ # User uploaded attachment.
- { # An attachment in Hangouts Chat.
- "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the
- # attachment to a human user. Bots should not use this URL to download
- # attachment content.
- "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
- "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
- },
- "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to
- # download the attachment. Bots should not use this URL to download
- # attachment content.
- "contentType": "A String", # The content type (MIME type) of the file.
- "name": "A String", # Resource name of the attachment, in the form
- # "spaces/*/messages/*/attachments/*".
- "source": "A String", # The source of the attachment.
- "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to
- # download the attachment data.
- "resourceName": "A String", # The resource name of the attachment data. This is used with the media API
- # to download the attachment data.
- },
- "contentName": "A String", # The original file name for the content, not the full path.
+ "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to download the attachment. Bots should not use this URL to download attachment content.
+ "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to download the attachment data.
+ "resourceName": "A String", # The resource name of the attachment data. This is used with the media API to download the attachment data.
},
- ],
- "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
- "cards": [ # Rich, formatted and interactive cards that can be used to display UI
- # elements such as: formatted texts, buttons, clickable images. Cards are
- # normally displayed below the plain-text body of the message.
- { # A card is a UI element that can contain UI widgets such as texts, images.
- "name": "A String", # Name of the card.
- "cardActions": [ # The actions of this card.
- { # A card action is
- # the action associated with the card. For an invoice card, a
- # typical action would be: delete invoice, email invoice or open the
- # invoice in browser.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
+ "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the attachment to a human user. Bots should not use this URL to download attachment content.
+ },
+ ],
+ "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
+ "cards": [ # Rich, formatted and interactive cards that can be used to display UI elements such as: formatted texts, buttons, clickable images. Cards are normally displayed below the plain-text body of the message.
+ { # A card is a UI element that can contain UI widgets such as texts, images.
+ "header": { # The header of the card. A header usually contains a title and an image.
+ "imageStyle": "A String", # The image's type (e.g. square border or circular border).
+ "imageUrl": "A String", # The URL of the image in the card header.
+ "title": "A 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 lines.
+ "subtitle": "A String", # The subtitle of the card header.
+ },
+ "sections": [ # Sections are separated by a line divider.
+ { # A section contains a collection of widgets that are rendered (vertically) in the order that they are specified. Across all platforms, cards have a narrow fixed width, so there is currently no need for layout properties (e.g. float).
+ "widgets": [ # A section must contain at least 1 widget.
+ { # A widget is a UI element that presents texts, images, etc.
+ "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
+ "text": "A String",
},
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
+ "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these fields should be set.
+ { # A button. Can be a text button or an image button.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ ],
+ "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
+ "aspectRatio": 3.14, # 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.
+ "imageUrl": "A String", # The URL of the image.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "keyValue": { # A UI element contains a key (label) and a value (content). And this element may also contain some actions such as onclick button. # Display a key value item in this widget.
+ "icon": "A String", # An enum value that will be replaced by the Chat API with the corresponding icon image.
+ "contentMultiline": True or False, # If the content should be multiline.
+ "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region are clickable.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
+ "content": "A String", # The text of the content. Formatted text supported and always required.
+ "topLabel": "A String", # The text of the top label. Formatted text supported.
+ "iconUrl": "A String", # The icon specified by a URL.
},
},
- "actionLabel": "A String", # The label used to be displayed in the action menu item.
- },
- ],
- "sections": [ # Sections are separated by a line divider.
- { # A section contains a collection of widgets that are rendered
- # (vertically) in the order that they are specified. Across all platforms,
- # cards have a narrow fixed width, so
- # there is currently no need for layout properties (e.g. float).
- "widgets": [ # A section must contain at least 1 widget.
- { # A widget is a UI element that presents texts, images, etc.
- "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
- "text": "A String",
- },
- "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these
- # fields should be set.
- { # A button. Can be a text button or an image button.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- ],
- "keyValue": { # A UI element contains a key (label) and a value (content). And this # Display a key value item in this widget.
- # element may also contain some actions such as onclick button.
- "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- "icon": "A String", # An enum value that will be replaced by the Chat API with the
- # corresponding icon image.
- "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
- "contentMultiline": True or False, # If the content should be multiline.
- "topLabel": "A String", # The text of the top label. Formatted text supported.
- "content": "A String", # The text of the content. Formatted text supported and always required.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region
- # are clickable.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "iconUrl": "A String", # The icon specified by a URL.
- },
- "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "aspectRatio": 3.14, # 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.
- "imageUrl": "A String", # The URL of the image.
- },
- },
- ],
- "header": "A String", # The header of the section, text formatted supported.
- },
- ],
- "header": { # The header of the card. A header usually contains a title and an image.
- "imageUrl": "A String", # The URL of the image in the card header.
- "imageStyle": "A String", # The image's type (e.g. square border or circular border).
- "title": "A 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 lines.
- "subtitle": "A String", # The subtitle of the card header.
+ ],
+ "header": "A String", # The header of the section, text formatted supported.
},
+ ],
+ "cardActions": [ # The actions of this card.
+ { # A card action is the action associated with the card. For an invoice card, a typical action would be: delete invoice, email invoice or open the invoice in browser.
+ "actionLabel": "A String", # The label used to be displayed in the action menu item.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ ],
+ "name": "A String", # Name of the card.
+ },
+ ],
+ "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
+ "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
+ },
+ "annotations": [ # Output only. Annotations associated with the text in this message.
+ { # Annotations associated with the plain-text body of the message. Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/107946847022116401880", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
+ "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command.
+ "bot": { # A user in Hangouts Chat. # The bot whose command was invoked.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "commandId": "A String", # The command id of the invoked slash command.
+ "type": "A String", # The type of slash command.
+ "commandName": "A String", # The name of the invoked slash command.
+ "triggersDialog": True or False, # Indicating whether the slash command is for a dialog.
},
- ],
- "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
- "displayName": "A String", # Output only. The display name (only if the space is a room).
- # Please note that this field might not be populated in direct messages
- # between humans.
- "threaded": True or False, # Whether the messages are threaded in this space.
- "name": "A String", # Resource name of the space, in the form "spaces/*".
- #
- # Example: spaces/AAAAMpdlehYs
- "type": "A String", # Output only. The type of a space.
- # This is deprecated. Use `single_user_bot_dm` instead.
- "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
+ "user": { # A user in Hangouts Chat. # The user mentioned.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "type": "A String", # The type of user mention.
+ },
+ "type": "A String", # The type of this annotation.
+ "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
+ "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this annotation corresponds to.
},
- "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
- "name": "A String", # Resource name, in the form "spaces/*/threads/*".
- #
- # Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
- },
- "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards
- # cannot be displayed (e.g. mobile notifications).
- }
+ ],
+ "slashCommand": { # A Slash Command in Hangouts Chat. # Slash command information, if applicable.
+ "commandId": "A String", # The id of the slash command invoked.
+ },
+ "text": "A String", # Plain-text body of the message.
+ "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the user, but any links to images, web pages, videos, etc. included here will generate preview chips.
+ "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
+ "threaded": True or False, # Whether the messages are threaded in this space.
+ "displayName": "A String", # Output only. The display name (only if the space is a room). Please note that this field might not be populated in direct messages between humans.
+ "type": "A String", # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.
+ "name": "A String", # Resource name of the space, in the form "spaces/*". Example: spaces/AAAAMpdlehYs
+ "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ },
+ "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
+ "name": "A String", # Resource name, in the form "spaces/*/messages/*". Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
+}
- threadKey: string, Opaque thread identifier string that can be specified to group messages
-into a single thread. If this is the first message with a given thread
-identifier, a new thread is created. Subsequent messages with the same
-thread identifier will be posted into the same thread. This relieves bots
-and webhooks from having to store the Hangouts Chat thread ID of a thread (created earlier by them) to post
-further updates to it.
-
-Has no effect if thread field,
-corresponding to an existing thread, is set in message.
+ threadKey: string, Opaque thread identifier string that can be specified to group messages into a single thread. If this is the first message with a given thread identifier, a new thread is created. Subsequent messages with the same thread identifier will be posted into the same thread. This relieves bots and webhooks from having to store the Hangouts Chat thread ID of a thread (created earlier by them) to post further updates to it. Has no effect if thread field, corresponding to an existing thread, is set in message.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -457,341 +355,240 @@
An object of the form:
{ # A message in Hangouts Chat.
- "name": "A String", # Resource name, in the form "spaces/*/messages/*".
- #
- # Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
- "annotations": [ # Output only. Annotations associated with the text in this message.
- { # Annotations associated with the plain-text body of the message.
- #
- # Example plain-text message body:
- # ```
- # Hello @FooBot how are you!"
- # ```
- #
- # The corresponding annotations metadata:
- # ```
- # "annotations":[{
- # "type":"USER_MENTION",
- # "startIndex":6,
- # "length":7,
- # "userMention": {
- # "user": {
- # "name":"users/107946847022116401880",
- # "displayName":"FooBot",
- # "avatarUrl":"https://goo.gl/aeDtrS",
- # "type":"BOT"
- # },
- # "type":"MENTION"
- # }
- # }]
- # ```
- "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this
- # annotation corresponds to.
- "type": "A String", # The type of this annotation.
- "length": 42, # Length of the substring in the plain-text message body this annotation
- # corresponds to.
- "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
- "user": { # A user in Hangouts Chat. # The user mentioned.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "type": "A String", # The type of user mention.
- },
+ "sender": { # A user in Hangouts Chat. # The user who created the message.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is posted.
+ "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
+ "type": "A String", # The type of bot response.
+ },
+ "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat server.
+ "attachment": [ # User uploaded attachment.
+ { # An attachment in Hangouts Chat.
+ "source": "A String", # The source of the attachment.
+ "contentType": "A String", # The content type (MIME type) of the file.
+ "name": "A String", # Resource name of the attachment, in the form "spaces/*/messages/*/attachments/*".
+ "contentName": "A String", # The original file name for the content, not the full path.
+ "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
+ "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
},
- ],
- "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is
- # posted.
- "type": "A String", # The type of bot response.
- "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
- },
- "sender": { # A user in Hangouts Chat. # The user who created the message.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat
- # server.
- "text": "A String", # Plain-text body of the message.
- "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the
- # user, but any links to images, web pages, videos, etc. included here will
- # generate preview chips.
- "attachment": [ # User uploaded attachment.
- { # An attachment in Hangouts Chat.
- "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the
- # attachment to a human user. Bots should not use this URL to download
- # attachment content.
- "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
- "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
- },
- "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to
- # download the attachment. Bots should not use this URL to download
- # attachment content.
- "contentType": "A String", # The content type (MIME type) of the file.
- "name": "A String", # Resource name of the attachment, in the form
- # "spaces/*/messages/*/attachments/*".
- "source": "A String", # The source of the attachment.
- "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to
- # download the attachment data.
- "resourceName": "A String", # The resource name of the attachment data. This is used with the media API
- # to download the attachment data.
- },
- "contentName": "A String", # The original file name for the content, not the full path.
+ "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to download the attachment. Bots should not use this URL to download attachment content.
+ "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to download the attachment data.
+ "resourceName": "A String", # The resource name of the attachment data. This is used with the media API to download the attachment data.
},
- ],
- "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
- "cards": [ # Rich, formatted and interactive cards that can be used to display UI
- # elements such as: formatted texts, buttons, clickable images. Cards are
- # normally displayed below the plain-text body of the message.
- { # A card is a UI element that can contain UI widgets such as texts, images.
- "name": "A String", # Name of the card.
- "cardActions": [ # The actions of this card.
- { # A card action is
- # the action associated with the card. For an invoice card, a
- # typical action would be: delete invoice, email invoice or open the
- # invoice in browser.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
+ "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the attachment to a human user. Bots should not use this URL to download attachment content.
+ },
+ ],
+ "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
+ "cards": [ # Rich, formatted and interactive cards that can be used to display UI elements such as: formatted texts, buttons, clickable images. Cards are normally displayed below the plain-text body of the message.
+ { # A card is a UI element that can contain UI widgets such as texts, images.
+ "header": { # The header of the card. A header usually contains a title and an image.
+ "imageStyle": "A String", # The image's type (e.g. square border or circular border).
+ "imageUrl": "A String", # The URL of the image in the card header.
+ "title": "A 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 lines.
+ "subtitle": "A String", # The subtitle of the card header.
+ },
+ "sections": [ # Sections are separated by a line divider.
+ { # A section contains a collection of widgets that are rendered (vertically) in the order that they are specified. Across all platforms, cards have a narrow fixed width, so there is currently no need for layout properties (e.g. float).
+ "widgets": [ # A section must contain at least 1 widget.
+ { # A widget is a UI element that presents texts, images, etc.
+ "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
+ "text": "A String",
},
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
+ "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these fields should be set.
+ { # A button. Can be a text button or an image button.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ ],
+ "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
+ "aspectRatio": 3.14, # 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.
+ "imageUrl": "A String", # The URL of the image.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "keyValue": { # A UI element contains a key (label) and a value (content). And this element may also contain some actions such as onclick button. # Display a key value item in this widget.
+ "icon": "A String", # An enum value that will be replaced by the Chat API with the corresponding icon image.
+ "contentMultiline": True or False, # If the content should be multiline.
+ "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region are clickable.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
+ "content": "A String", # The text of the content. Formatted text supported and always required.
+ "topLabel": "A String", # The text of the top label. Formatted text supported.
+ "iconUrl": "A String", # The icon specified by a URL.
},
},
- "actionLabel": "A String", # The label used to be displayed in the action menu item.
- },
- ],
- "sections": [ # Sections are separated by a line divider.
- { # A section contains a collection of widgets that are rendered
- # (vertically) in the order that they are specified. Across all platforms,
- # cards have a narrow fixed width, so
- # there is currently no need for layout properties (e.g. float).
- "widgets": [ # A section must contain at least 1 widget.
- { # A widget is a UI element that presents texts, images, etc.
- "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
- "text": "A String",
- },
- "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these
- # fields should be set.
- { # A button. Can be a text button or an image button.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- ],
- "keyValue": { # A UI element contains a key (label) and a value (content). And this # Display a key value item in this widget.
- # element may also contain some actions such as onclick button.
- "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- "icon": "A String", # An enum value that will be replaced by the Chat API with the
- # corresponding icon image.
- "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
- "contentMultiline": True or False, # If the content should be multiline.
- "topLabel": "A String", # The text of the top label. Formatted text supported.
- "content": "A String", # The text of the content. Formatted text supported and always required.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region
- # are clickable.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "iconUrl": "A String", # The icon specified by a URL.
- },
- "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "aspectRatio": 3.14, # 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.
- "imageUrl": "A String", # The URL of the image.
- },
- },
- ],
- "header": "A String", # The header of the section, text formatted supported.
- },
- ],
- "header": { # The header of the card. A header usually contains a title and an image.
- "imageUrl": "A String", # The URL of the image in the card header.
- "imageStyle": "A String", # The image's type (e.g. square border or circular border).
- "title": "A 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 lines.
- "subtitle": "A String", # The subtitle of the card header.
+ ],
+ "header": "A String", # The header of the section, text formatted supported.
},
+ ],
+ "cardActions": [ # The actions of this card.
+ { # A card action is the action associated with the card. For an invoice card, a typical action would be: delete invoice, email invoice or open the invoice in browser.
+ "actionLabel": "A String", # The label used to be displayed in the action menu item.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ ],
+ "name": "A String", # Name of the card.
+ },
+ ],
+ "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
+ "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
+ },
+ "annotations": [ # Output only. Annotations associated with the text in this message.
+ { # Annotations associated with the plain-text body of the message. Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/107946847022116401880", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
+ "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command.
+ "bot": { # A user in Hangouts Chat. # The bot whose command was invoked.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "commandId": "A String", # The command id of the invoked slash command.
+ "type": "A String", # The type of slash command.
+ "commandName": "A String", # The name of the invoked slash command.
+ "triggersDialog": True or False, # Indicating whether the slash command is for a dialog.
},
- ],
- "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
- "displayName": "A String", # Output only. The display name (only if the space is a room).
- # Please note that this field might not be populated in direct messages
- # between humans.
- "threaded": True or False, # Whether the messages are threaded in this space.
- "name": "A String", # Resource name of the space, in the form "spaces/*".
- #
- # Example: spaces/AAAAMpdlehYs
- "type": "A String", # Output only. The type of a space.
- # This is deprecated. Use `single_user_bot_dm` instead.
- "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
+ "user": { # A user in Hangouts Chat. # The user mentioned.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "type": "A String", # The type of user mention.
+ },
+ "type": "A String", # The type of this annotation.
+ "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
+ "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this annotation corresponds to.
},
- "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
- "name": "A String", # Resource name, in the form "spaces/*/threads/*".
- #
- # Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
- },
- "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards
- # cannot be displayed (e.g. mobile notifications).
- }</pre>
+ ],
+ "slashCommand": { # A Slash Command in Hangouts Chat. # Slash command information, if applicable.
+ "commandId": "A String", # The id of the slash command invoked.
+ },
+ "text": "A String", # Plain-text body of the message.
+ "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the user, but any links to images, web pages, videos, etc. included here will generate preview chips.
+ "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
+ "threaded": True or False, # Whether the messages are threaded in this space.
+ "displayName": "A String", # Output only. The display name (only if the space is a room). Please note that this field might not be populated in direct messages between humans.
+ "type": "A String", # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.
+ "name": "A String", # Resource name of the space, in the form "spaces/*". Example: spaces/AAAAMpdlehYs
+ "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ },
+ "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
+ "name": "A String", # Resource name, in the form "spaces/*/messages/*". Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
+ }</pre>
</div>
<div class="method">
@@ -799,10 +596,7 @@
<pre>Deletes a message.
Args:
- name: string, Required. Resource name of the message to be deleted, in the form
-"spaces/*/messages/*"
-
-Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4 (required)
+ name: string, Required. Resource name of the message to be deleted, in the form "spaces/*/messages/*" Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4 (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -811,15 +605,7 @@
Returns:
An object of the form:
- { # A generic empty message that you can re-use to avoid defining duplicated
- # empty messages in your APIs. A typical example is to use it as the request
- # or the response type of an API method. For instance:
- #
- # service Foo {
- # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
- # }
- #
- # The JSON representation for `Empty` is empty JSON object `{}`.
+ { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
}</pre>
</div>
@@ -828,10 +614,7 @@
<pre>Returns a message.
Args:
- name: string, Required. Resource name of the message to be retrieved, in the form
-"spaces/*/messages/*".
-
-Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4 (required)
+ name: string, Required. Resource name of the message to be retrieved, in the form "spaces/*/messages/*". Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4 (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -841,341 +624,240 @@
An object of the form:
{ # A message in Hangouts Chat.
- "name": "A String", # Resource name, in the form "spaces/*/messages/*".
- #
- # Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
- "annotations": [ # Output only. Annotations associated with the text in this message.
- { # Annotations associated with the plain-text body of the message.
- #
- # Example plain-text message body:
- # ```
- # Hello @FooBot how are you!"
- # ```
- #
- # The corresponding annotations metadata:
- # ```
- # "annotations":[{
- # "type":"USER_MENTION",
- # "startIndex":6,
- # "length":7,
- # "userMention": {
- # "user": {
- # "name":"users/107946847022116401880",
- # "displayName":"FooBot",
- # "avatarUrl":"https://goo.gl/aeDtrS",
- # "type":"BOT"
- # },
- # "type":"MENTION"
- # }
- # }]
- # ```
- "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this
- # annotation corresponds to.
- "type": "A String", # The type of this annotation.
- "length": 42, # Length of the substring in the plain-text message body this annotation
- # corresponds to.
- "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
- "user": { # A user in Hangouts Chat. # The user mentioned.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "type": "A String", # The type of user mention.
- },
+ "sender": { # A user in Hangouts Chat. # The user who created the message.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is posted.
+ "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
+ "type": "A String", # The type of bot response.
+ },
+ "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat server.
+ "attachment": [ # User uploaded attachment.
+ { # An attachment in Hangouts Chat.
+ "source": "A String", # The source of the attachment.
+ "contentType": "A String", # The content type (MIME type) of the file.
+ "name": "A String", # Resource name of the attachment, in the form "spaces/*/messages/*/attachments/*".
+ "contentName": "A String", # The original file name for the content, not the full path.
+ "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
+ "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
},
- ],
- "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is
- # posted.
- "type": "A String", # The type of bot response.
- "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
- },
- "sender": { # A user in Hangouts Chat. # The user who created the message.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat
- # server.
- "text": "A String", # Plain-text body of the message.
- "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the
- # user, but any links to images, web pages, videos, etc. included here will
- # generate preview chips.
- "attachment": [ # User uploaded attachment.
- { # An attachment in Hangouts Chat.
- "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the
- # attachment to a human user. Bots should not use this URL to download
- # attachment content.
- "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
- "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
- },
- "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to
- # download the attachment. Bots should not use this URL to download
- # attachment content.
- "contentType": "A String", # The content type (MIME type) of the file.
- "name": "A String", # Resource name of the attachment, in the form
- # "spaces/*/messages/*/attachments/*".
- "source": "A String", # The source of the attachment.
- "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to
- # download the attachment data.
- "resourceName": "A String", # The resource name of the attachment data. This is used with the media API
- # to download the attachment data.
- },
- "contentName": "A String", # The original file name for the content, not the full path.
+ "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to download the attachment. Bots should not use this URL to download attachment content.
+ "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to download the attachment data.
+ "resourceName": "A String", # The resource name of the attachment data. This is used with the media API to download the attachment data.
},
- ],
- "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
- "cards": [ # Rich, formatted and interactive cards that can be used to display UI
- # elements such as: formatted texts, buttons, clickable images. Cards are
- # normally displayed below the plain-text body of the message.
- { # A card is a UI element that can contain UI widgets such as texts, images.
- "name": "A String", # Name of the card.
- "cardActions": [ # The actions of this card.
- { # A card action is
- # the action associated with the card. For an invoice card, a
- # typical action would be: delete invoice, email invoice or open the
- # invoice in browser.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
+ "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the attachment to a human user. Bots should not use this URL to download attachment content.
+ },
+ ],
+ "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
+ "cards": [ # Rich, formatted and interactive cards that can be used to display UI elements such as: formatted texts, buttons, clickable images. Cards are normally displayed below the plain-text body of the message.
+ { # A card is a UI element that can contain UI widgets such as texts, images.
+ "header": { # The header of the card. A header usually contains a title and an image.
+ "imageStyle": "A String", # The image's type (e.g. square border or circular border).
+ "imageUrl": "A String", # The URL of the image in the card header.
+ "title": "A 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 lines.
+ "subtitle": "A String", # The subtitle of the card header.
+ },
+ "sections": [ # Sections are separated by a line divider.
+ { # A section contains a collection of widgets that are rendered (vertically) in the order that they are specified. Across all platforms, cards have a narrow fixed width, so there is currently no need for layout properties (e.g. float).
+ "widgets": [ # A section must contain at least 1 widget.
+ { # A widget is a UI element that presents texts, images, etc.
+ "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
+ "text": "A String",
},
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
+ "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these fields should be set.
+ { # A button. Can be a text button or an image button.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ ],
+ "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
+ "aspectRatio": 3.14, # 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.
+ "imageUrl": "A String", # The URL of the image.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "keyValue": { # A UI element contains a key (label) and a value (content). And this element may also contain some actions such as onclick button. # Display a key value item in this widget.
+ "icon": "A String", # An enum value that will be replaced by the Chat API with the corresponding icon image.
+ "contentMultiline": True or False, # If the content should be multiline.
+ "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region are clickable.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
+ "content": "A String", # The text of the content. Formatted text supported and always required.
+ "topLabel": "A String", # The text of the top label. Formatted text supported.
+ "iconUrl": "A String", # The icon specified by a URL.
},
},
- "actionLabel": "A String", # The label used to be displayed in the action menu item.
- },
- ],
- "sections": [ # Sections are separated by a line divider.
- { # A section contains a collection of widgets that are rendered
- # (vertically) in the order that they are specified. Across all platforms,
- # cards have a narrow fixed width, so
- # there is currently no need for layout properties (e.g. float).
- "widgets": [ # A section must contain at least 1 widget.
- { # A widget is a UI element that presents texts, images, etc.
- "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
- "text": "A String",
- },
- "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these
- # fields should be set.
- { # A button. Can be a text button or an image button.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- ],
- "keyValue": { # A UI element contains a key (label) and a value (content). And this # Display a key value item in this widget.
- # element may also contain some actions such as onclick button.
- "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- "icon": "A String", # An enum value that will be replaced by the Chat API with the
- # corresponding icon image.
- "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
- "contentMultiline": True or False, # If the content should be multiline.
- "topLabel": "A String", # The text of the top label. Formatted text supported.
- "content": "A String", # The text of the content. Formatted text supported and always required.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region
- # are clickable.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "iconUrl": "A String", # The icon specified by a URL.
- },
- "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "aspectRatio": 3.14, # 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.
- "imageUrl": "A String", # The URL of the image.
- },
- },
- ],
- "header": "A String", # The header of the section, text formatted supported.
- },
- ],
- "header": { # The header of the card. A header usually contains a title and an image.
- "imageUrl": "A String", # The URL of the image in the card header.
- "imageStyle": "A String", # The image's type (e.g. square border or circular border).
- "title": "A 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 lines.
- "subtitle": "A String", # The subtitle of the card header.
+ ],
+ "header": "A String", # The header of the section, text formatted supported.
},
+ ],
+ "cardActions": [ # The actions of this card.
+ { # A card action is the action associated with the card. For an invoice card, a typical action would be: delete invoice, email invoice or open the invoice in browser.
+ "actionLabel": "A String", # The label used to be displayed in the action menu item.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ ],
+ "name": "A String", # Name of the card.
+ },
+ ],
+ "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
+ "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
+ },
+ "annotations": [ # Output only. Annotations associated with the text in this message.
+ { # Annotations associated with the plain-text body of the message. Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/107946847022116401880", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
+ "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command.
+ "bot": { # A user in Hangouts Chat. # The bot whose command was invoked.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "commandId": "A String", # The command id of the invoked slash command.
+ "type": "A String", # The type of slash command.
+ "commandName": "A String", # The name of the invoked slash command.
+ "triggersDialog": True or False, # Indicating whether the slash command is for a dialog.
},
- ],
- "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
- "displayName": "A String", # Output only. The display name (only if the space is a room).
- # Please note that this field might not be populated in direct messages
- # between humans.
- "threaded": True or False, # Whether the messages are threaded in this space.
- "name": "A String", # Resource name of the space, in the form "spaces/*".
- #
- # Example: spaces/AAAAMpdlehYs
- "type": "A String", # Output only. The type of a space.
- # This is deprecated. Use `single_user_bot_dm` instead.
- "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
+ "user": { # A user in Hangouts Chat. # The user mentioned.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "type": "A String", # The type of user mention.
+ },
+ "type": "A String", # The type of this annotation.
+ "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
+ "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this annotation corresponds to.
},
- "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
- "name": "A String", # Resource name, in the form "spaces/*/threads/*".
- #
- # Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
- },
- "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards
- # cannot be displayed (e.g. mobile notifications).
- }</pre>
+ ],
+ "slashCommand": { # A Slash Command in Hangouts Chat. # Slash command information, if applicable.
+ "commandId": "A String", # The id of the slash command invoked.
+ },
+ "text": "A String", # Plain-text body of the message.
+ "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the user, but any links to images, web pages, videos, etc. included here will generate preview chips.
+ "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
+ "threaded": True or False, # Whether the messages are threaded in this space.
+ "displayName": "A String", # Output only. The display name (only if the space is a room). Please note that this field might not be populated in direct messages between humans.
+ "type": "A String", # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.
+ "name": "A String", # Resource name of the space, in the form "spaces/*". Example: spaces/AAAAMpdlehYs
+ "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ },
+ "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
+ "name": "A String", # Resource name, in the form "spaces/*/messages/*". Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
+ }</pre>
</div>
<div class="method">
@@ -1183,355 +865,247 @@
<pre>Updates a message.
Args:
- name: string, Resource name, in the form "spaces/*/messages/*".
-
-Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4 (required)
+ name: string, Resource name, in the form "spaces/*/messages/*". Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4 (required)
body: object, The request body.
The object takes the form of:
{ # A message in Hangouts Chat.
- "name": "A String", # Resource name, in the form "spaces/*/messages/*".
- #
- # Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
- "annotations": [ # Output only. Annotations associated with the text in this message.
- { # Annotations associated with the plain-text body of the message.
- #
- # Example plain-text message body:
- # ```
- # Hello @FooBot how are you!"
- # ```
- #
- # The corresponding annotations metadata:
- # ```
- # "annotations":[{
- # "type":"USER_MENTION",
- # "startIndex":6,
- # "length":7,
- # "userMention": {
- # "user": {
- # "name":"users/107946847022116401880",
- # "displayName":"FooBot",
- # "avatarUrl":"https://goo.gl/aeDtrS",
- # "type":"BOT"
- # },
- # "type":"MENTION"
- # }
- # }]
- # ```
- "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this
- # annotation corresponds to.
- "type": "A String", # The type of this annotation.
- "length": 42, # Length of the substring in the plain-text message body this annotation
- # corresponds to.
- "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
- "user": { # A user in Hangouts Chat. # The user mentioned.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "type": "A String", # The type of user mention.
- },
+ "sender": { # A user in Hangouts Chat. # The user who created the message.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is posted.
+ "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
+ "type": "A String", # The type of bot response.
+ },
+ "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat server.
+ "attachment": [ # User uploaded attachment.
+ { # An attachment in Hangouts Chat.
+ "source": "A String", # The source of the attachment.
+ "contentType": "A String", # The content type (MIME type) of the file.
+ "name": "A String", # Resource name of the attachment, in the form "spaces/*/messages/*/attachments/*".
+ "contentName": "A String", # The original file name for the content, not the full path.
+ "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
+ "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
},
- ],
- "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is
- # posted.
- "type": "A String", # The type of bot response.
- "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
- },
- "sender": { # A user in Hangouts Chat. # The user who created the message.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat
- # server.
- "text": "A String", # Plain-text body of the message.
- "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the
- # user, but any links to images, web pages, videos, etc. included here will
- # generate preview chips.
- "attachment": [ # User uploaded attachment.
- { # An attachment in Hangouts Chat.
- "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the
- # attachment to a human user. Bots should not use this URL to download
- # attachment content.
- "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
- "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
- },
- "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to
- # download the attachment. Bots should not use this URL to download
- # attachment content.
- "contentType": "A String", # The content type (MIME type) of the file.
- "name": "A String", # Resource name of the attachment, in the form
- # "spaces/*/messages/*/attachments/*".
- "source": "A String", # The source of the attachment.
- "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to
- # download the attachment data.
- "resourceName": "A String", # The resource name of the attachment data. This is used with the media API
- # to download the attachment data.
- },
- "contentName": "A String", # The original file name for the content, not the full path.
+ "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to download the attachment. Bots should not use this URL to download attachment content.
+ "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to download the attachment data.
+ "resourceName": "A String", # The resource name of the attachment data. This is used with the media API to download the attachment data.
},
- ],
- "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
- "cards": [ # Rich, formatted and interactive cards that can be used to display UI
- # elements such as: formatted texts, buttons, clickable images. Cards are
- # normally displayed below the plain-text body of the message.
- { # A card is a UI element that can contain UI widgets such as texts, images.
- "name": "A String", # Name of the card.
- "cardActions": [ # The actions of this card.
- { # A card action is
- # the action associated with the card. For an invoice card, a
- # typical action would be: delete invoice, email invoice or open the
- # invoice in browser.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
+ "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the attachment to a human user. Bots should not use this URL to download attachment content.
+ },
+ ],
+ "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
+ "cards": [ # Rich, formatted and interactive cards that can be used to display UI elements such as: formatted texts, buttons, clickable images. Cards are normally displayed below the plain-text body of the message.
+ { # A card is a UI element that can contain UI widgets such as texts, images.
+ "header": { # The header of the card. A header usually contains a title and an image.
+ "imageStyle": "A String", # The image's type (e.g. square border or circular border).
+ "imageUrl": "A String", # The URL of the image in the card header.
+ "title": "A 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 lines.
+ "subtitle": "A String", # The subtitle of the card header.
+ },
+ "sections": [ # Sections are separated by a line divider.
+ { # A section contains a collection of widgets that are rendered (vertically) in the order that they are specified. Across all platforms, cards have a narrow fixed width, so there is currently no need for layout properties (e.g. float).
+ "widgets": [ # A section must contain at least 1 widget.
+ { # A widget is a UI element that presents texts, images, etc.
+ "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
+ "text": "A String",
},
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
+ "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these fields should be set.
+ { # A button. Can be a text button or an image button.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ ],
+ "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
+ "aspectRatio": 3.14, # 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.
+ "imageUrl": "A String", # The URL of the image.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "keyValue": { # A UI element contains a key (label) and a value (content). And this element may also contain some actions such as onclick button. # Display a key value item in this widget.
+ "icon": "A String", # An enum value that will be replaced by the Chat API with the corresponding icon image.
+ "contentMultiline": True or False, # If the content should be multiline.
+ "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region are clickable.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
+ "content": "A String", # The text of the content. Formatted text supported and always required.
+ "topLabel": "A String", # The text of the top label. Formatted text supported.
+ "iconUrl": "A String", # The icon specified by a URL.
},
},
- "actionLabel": "A String", # The label used to be displayed in the action menu item.
- },
- ],
- "sections": [ # Sections are separated by a line divider.
- { # A section contains a collection of widgets that are rendered
- # (vertically) in the order that they are specified. Across all platforms,
- # cards have a narrow fixed width, so
- # there is currently no need for layout properties (e.g. float).
- "widgets": [ # A section must contain at least 1 widget.
- { # A widget is a UI element that presents texts, images, etc.
- "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
- "text": "A String",
- },
- "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these
- # fields should be set.
- { # A button. Can be a text button or an image button.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- ],
- "keyValue": { # A UI element contains a key (label) and a value (content). And this # Display a key value item in this widget.
- # element may also contain some actions such as onclick button.
- "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- "icon": "A String", # An enum value that will be replaced by the Chat API with the
- # corresponding icon image.
- "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
- "contentMultiline": True or False, # If the content should be multiline.
- "topLabel": "A String", # The text of the top label. Formatted text supported.
- "content": "A String", # The text of the content. Formatted text supported and always required.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region
- # are clickable.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "iconUrl": "A String", # The icon specified by a URL.
- },
- "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "aspectRatio": 3.14, # 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.
- "imageUrl": "A String", # The URL of the image.
- },
- },
- ],
- "header": "A String", # The header of the section, text formatted supported.
- },
- ],
- "header": { # The header of the card. A header usually contains a title and an image.
- "imageUrl": "A String", # The URL of the image in the card header.
- "imageStyle": "A String", # The image's type (e.g. square border or circular border).
- "title": "A 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 lines.
- "subtitle": "A String", # The subtitle of the card header.
+ ],
+ "header": "A String", # The header of the section, text formatted supported.
},
+ ],
+ "cardActions": [ # The actions of this card.
+ { # A card action is the action associated with the card. For an invoice card, a typical action would be: delete invoice, email invoice or open the invoice in browser.
+ "actionLabel": "A String", # The label used to be displayed in the action menu item.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ ],
+ "name": "A String", # Name of the card.
+ },
+ ],
+ "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
+ "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
+ },
+ "annotations": [ # Output only. Annotations associated with the text in this message.
+ { # Annotations associated with the plain-text body of the message. Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/107946847022116401880", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
+ "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command.
+ "bot": { # A user in Hangouts Chat. # The bot whose command was invoked.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "commandId": "A String", # The command id of the invoked slash command.
+ "type": "A String", # The type of slash command.
+ "commandName": "A String", # The name of the invoked slash command.
+ "triggersDialog": True or False, # Indicating whether the slash command is for a dialog.
},
- ],
- "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
- "displayName": "A String", # Output only. The display name (only if the space is a room).
- # Please note that this field might not be populated in direct messages
- # between humans.
- "threaded": True or False, # Whether the messages are threaded in this space.
- "name": "A String", # Resource name of the space, in the form "spaces/*".
- #
- # Example: spaces/AAAAMpdlehYs
- "type": "A String", # Output only. The type of a space.
- # This is deprecated. Use `single_user_bot_dm` instead.
- "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
+ "user": { # A user in Hangouts Chat. # The user mentioned.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "type": "A String", # The type of user mention.
+ },
+ "type": "A String", # The type of this annotation.
+ "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
+ "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this annotation corresponds to.
},
- "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
- "name": "A String", # Resource name, in the form "spaces/*/threads/*".
- #
- # Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
- },
- "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards
- # cannot be displayed (e.g. mobile notifications).
- }
+ ],
+ "slashCommand": { # A Slash Command in Hangouts Chat. # Slash command information, if applicable.
+ "commandId": "A String", # The id of the slash command invoked.
+ },
+ "text": "A String", # Plain-text body of the message.
+ "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the user, but any links to images, web pages, videos, etc. included here will generate preview chips.
+ "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
+ "threaded": True or False, # Whether the messages are threaded in this space.
+ "displayName": "A String", # Output only. The display name (only if the space is a room). Please note that this field might not be populated in direct messages between humans.
+ "type": "A String", # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.
+ "name": "A String", # Resource name of the space, in the form "spaces/*". Example: spaces/AAAAMpdlehYs
+ "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ },
+ "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
+ "name": "A String", # Resource name, in the form "spaces/*/messages/*". Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
+}
- updateMask: string, Required. The field paths to be updated, comma separated if there are
-multiple.
-
-Currently supported field paths:
-* text
-* cards
+ updateMask: string, Required. The field paths to be updated, comma separated if there are multiple. Currently supported field paths: * text * cards
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -1541,341 +1115,240 @@
An object of the form:
{ # A message in Hangouts Chat.
- "name": "A String", # Resource name, in the form "spaces/*/messages/*".
- #
- # Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
- "annotations": [ # Output only. Annotations associated with the text in this message.
- { # Annotations associated with the plain-text body of the message.
- #
- # Example plain-text message body:
- # ```
- # Hello @FooBot how are you!"
- # ```
- #
- # The corresponding annotations metadata:
- # ```
- # "annotations":[{
- # "type":"USER_MENTION",
- # "startIndex":6,
- # "length":7,
- # "userMention": {
- # "user": {
- # "name":"users/107946847022116401880",
- # "displayName":"FooBot",
- # "avatarUrl":"https://goo.gl/aeDtrS",
- # "type":"BOT"
- # },
- # "type":"MENTION"
- # }
- # }]
- # ```
- "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this
- # annotation corresponds to.
- "type": "A String", # The type of this annotation.
- "length": 42, # Length of the substring in the plain-text message body this annotation
- # corresponds to.
- "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
- "user": { # A user in Hangouts Chat. # The user mentioned.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "type": "A String", # The type of user mention.
- },
+ "sender": { # A user in Hangouts Chat. # The user who created the message.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is posted.
+ "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
+ "type": "A String", # The type of bot response.
+ },
+ "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat server.
+ "attachment": [ # User uploaded attachment.
+ { # An attachment in Hangouts Chat.
+ "source": "A String", # The source of the attachment.
+ "contentType": "A String", # The content type (MIME type) of the file.
+ "name": "A String", # Resource name of the attachment, in the form "spaces/*/messages/*/attachments/*".
+ "contentName": "A String", # The original file name for the content, not the full path.
+ "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
+ "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
},
- ],
- "actionResponse": { # Parameters that a bot can use to configure how it's response is posted. # Input only. Parameters that a bot can use to configure how its response is
- # posted.
- "type": "A String", # The type of bot response.
- "url": "A String", # URL for users to auth or config. (Only for REQUEST_CONFIG response types.)
- },
- "sender": { # A user in Hangouts Chat. # The user who created the message.
- "name": "A String", # Resource name, in the format "users/*".
- "type": "A String", # User type.
- "displayName": "A String", # The user's display name.
- "domainId": "A String", # Obfuscated domain information.
- },
- "createTime": "A String", # Output only. The time at which the message was created in Hangouts Chat
- # server.
- "text": "A String", # Plain-text body of the message.
- "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the
- # user, but any links to images, web pages, videos, etc. included here will
- # generate preview chips.
- "attachment": [ # User uploaded attachment.
- { # An attachment in Hangouts Chat.
- "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the
- # attachment to a human user. Bots should not use this URL to download
- # attachment content.
- "driveDataRef": { # A reference to the data of a drive attachment. # A reference to the drive attachment. This is used with the Drive API.
- "driveFileId": "A String", # The id for the drive file, for use with the Drive API.
- },
- "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to
- # download the attachment. Bots should not use this URL to download
- # attachment content.
- "contentType": "A String", # The content type (MIME type) of the file.
- "name": "A String", # Resource name of the attachment, in the form
- # "spaces/*/messages/*/attachments/*".
- "source": "A String", # The source of the attachment.
- "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to
- # download the attachment data.
- "resourceName": "A String", # The resource name of the attachment data. This is used with the media API
- # to download the attachment data.
- },
- "contentName": "A String", # The original file name for the content, not the full path.
+ "downloadUri": "A String", # Output only. The download URL which should be used to allow a human user to download the attachment. Bots should not use this URL to download attachment content.
+ "attachmentDataRef": { # A reference to the data of an attachment. # A reference to the attachment data. This is used with the media API to download the attachment data.
+ "resourceName": "A String", # The resource name of the attachment data. This is used with the media API to download the attachment data.
},
- ],
- "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
- "cards": [ # Rich, formatted and interactive cards that can be used to display UI
- # elements such as: formatted texts, buttons, clickable images. Cards are
- # normally displayed below the plain-text body of the message.
- { # A card is a UI element that can contain UI widgets such as texts, images.
- "name": "A String", # Name of the card.
- "cardActions": [ # The actions of this card.
- { # A card action is
- # the action associated with the card. For an invoice card, a
- # typical action would be: delete invoice, email invoice or open the
- # invoice in browser.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
+ "thumbnailUri": "A String", # Output only. The thumbnail URL which should be used to preview the attachment to a human user. Bots should not use this URL to download attachment content.
+ },
+ ],
+ "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
+ "cards": [ # Rich, formatted and interactive cards that can be used to display UI elements such as: formatted texts, buttons, clickable images. Cards are normally displayed below the plain-text body of the message.
+ { # A card is a UI element that can contain UI widgets such as texts, images.
+ "header": { # The header of the card. A header usually contains a title and an image.
+ "imageStyle": "A String", # The image's type (e.g. square border or circular border).
+ "imageUrl": "A String", # The URL of the image in the card header.
+ "title": "A 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 lines.
+ "subtitle": "A String", # The subtitle of the card header.
+ },
+ "sections": [ # Sections are separated by a line divider.
+ { # A section contains a collection of widgets that are rendered (vertically) in the order that they are specified. Across all platforms, cards have a narrow fixed width, so there is currently no need for layout properties (e.g. float).
+ "widgets": [ # A section must contain at least 1 widget.
+ { # A widget is a UI element that presents texts, images, etc.
+ "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
+ "text": "A String",
},
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
+ "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these fields should be set.
+ { # A button. Can be a text button or an image button.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ ],
+ "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
+ "aspectRatio": 3.14, # 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.
+ "imageUrl": "A String", # The URL of the image.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "keyValue": { # A UI element contains a key (label) and a value (content). And this element may also contain some actions such as onclick button. # Display a key value item in this widget.
+ "icon": "A String", # An enum value that will be replaced by the Chat API with the corresponding icon image.
+ "contentMultiline": True or False, # If the content should be multiline.
+ "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
+ "textButton": { # A button with text and onclick action. # A button with text and onclick action.
+ "text": "A String", # The text of the button.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "iconUrl": "A String", # The icon specified by a URL.
+ "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat API.
+ "name": "A String", # The name of this image_button which will be used for accessibility. Default value will be provided if developers don't specify.
+ },
+ },
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region are clickable.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
+ "content": "A String", # The text of the content. Formatted text supported and always required.
+ "topLabel": "A String", # The text of the top label. Formatted text supported.
+ "iconUrl": "A String", # The icon specified by a URL.
},
},
- "actionLabel": "A String", # The label used to be displayed in the action menu item.
- },
- ],
- "sections": [ # Sections are separated by a line divider.
- { # A section contains a collection of widgets that are rendered
- # (vertically) in the order that they are specified. Across all platforms,
- # cards have a narrow fixed width, so
- # there is currently no need for layout properties (e.g. float).
- "widgets": [ # A section must contain at least 1 widget.
- { # A widget is a UI element that presents texts, images, etc.
- "textParagraph": { # A paragraph of text. Formatted text supported. # Display a text paragraph in this widget.
- "text": "A String",
- },
- "buttons": [ # A list of buttons. Buttons is also oneof data and only one of these
- # fields should be set.
- { # A button. Can be a text button or an image button.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- ],
- "keyValue": { # A UI element contains a key (label) and a value (content). And this # Display a key value item in this widget.
- # element may also contain some actions such as onclick button.
- "button": { # A button. Can be a text button or an image button. # A button that can be clicked to trigger an action.
- "imageButton": { # An image button with an onclick action. # A button with image and onclick action.
- "iconUrl": "A String", # The icon specified by a URL.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "name": "A String", # The name of this image_button which will be used for accessibility.
- # Default value will be provided if developers don't specify.
- "icon": "A String", # The icon specified by an enum that indices to an icon provided by Chat
- # API.
- },
- "textButton": { # A button with text and onclick action. # A button with text and onclick action.
- "text": "A String", # The text of the button.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action of the button.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- },
- },
- "icon": "A String", # An enum value that will be replaced by the Chat API with the
- # corresponding icon image.
- "bottomLabel": "A String", # The text of the bottom label. Formatted text supported.
- "contentMultiline": True or False, # If the content should be multiline.
- "topLabel": "A String", # The text of the top label. Formatted text supported.
- "content": "A String", # The text of the content. Formatted text supported and always required.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action. Only the top label, bottom label and content region
- # are clickable.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "iconUrl": "A String", # The icon specified by a URL.
- },
- "image": { # An image that is specified by a URL and can have an onclick action. # Display an image in this widget.
- "onClick": { # An onclick action (e.g. open a link). # The onclick action.
- "action": { # A form action describes the behavior when the form is submitted. # A form action will be trigger by this onclick if specified.
- # For example, an Apps Script can be invoked to handle the form.
- "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the
- # form submission. This information is echoed back to the bot as part of
- # the card click event. The same method name can be used for several
- # elements that trigger a common behavior if desired.
- "parameters": [ # List of action parameters.
- { # List of string parameters to supply when the action method is invoked.
- # For example, consider three snooze buttons: snooze now, snooze 1 day,
- # snooze next week. You might use action method = snooze(), passing the
- # snooze type and snooze time in the list of string parameters.
- "value": "A String", # The value of the parameter.
- "key": "A String", # The name of the parameter for the action script.
- },
- ],
- },
- "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
- "url": "A String", # The URL to open.
- },
- },
- "aspectRatio": 3.14, # 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.
- "imageUrl": "A String", # The URL of the image.
- },
- },
- ],
- "header": "A String", # The header of the section, text formatted supported.
- },
- ],
- "header": { # The header of the card. A header usually contains a title and an image.
- "imageUrl": "A String", # The URL of the image in the card header.
- "imageStyle": "A String", # The image's type (e.g. square border or circular border).
- "title": "A 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 lines.
- "subtitle": "A String", # The subtitle of the card header.
+ ],
+ "header": "A String", # The header of the section, text formatted supported.
},
+ ],
+ "cardActions": [ # The actions of this card.
+ { # A card action is the action associated with the card. For an invoice card, a typical action would be: delete invoice, email invoice or open the invoice in browser.
+ "actionLabel": "A String", # The label used to be displayed in the action menu item.
+ "onClick": { # An onclick action (e.g. open a link). # The onclick action for this action item.
+ "openLink": { # A link that opens a new window. # This onclick triggers an open link action if specified.
+ "url": "A String", # The URL to open.
+ },
+ "action": { # A form action describes the behavior when the form is submitted. For example, an Apps Script can be invoked to handle the form. # A form action will be triggered by this onclick if specified.
+ "actionMethodName": "A String", # The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the bot as part of the card click event. The same method name can be used for several elements that trigger a common behavior if desired.
+ "parameters": [ # List of action parameters.
+ { # List of string parameters to supply when the action method is invoked. For example, consider three snooze buttons: snooze now, snooze 1 day, snooze next week. You might use action method = snooze(), passing the snooze type and snooze time in the list of string parameters.
+ "value": "A String", # The value of the parameter.
+ "key": "A String", # The name of the parameter for the action script.
+ },
+ ],
+ },
+ },
+ },
+ ],
+ "name": "A String", # Name of the card.
+ },
+ ],
+ "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
+ "name": "A String", # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
+ },
+ "annotations": [ # Output only. Annotations associated with the text in this message.
+ { # Annotations associated with the plain-text body of the message. Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/107946847022116401880", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
+ "slashCommand": { # Annotation metadata for slash commands (/). # The metadata for a slash command.
+ "bot": { # A user in Hangouts Chat. # The bot whose command was invoked.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "commandId": "A String", # The command id of the invoked slash command.
+ "type": "A String", # The type of slash command.
+ "commandName": "A String", # The name of the invoked slash command.
+ "triggersDialog": True or False, # Indicating whether the slash command is for a dialog.
},
- ],
- "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
- "displayName": "A String", # Output only. The display name (only if the space is a room).
- # Please note that this field might not be populated in direct messages
- # between humans.
- "threaded": True or False, # Whether the messages are threaded in this space.
- "name": "A String", # Resource name of the space, in the form "spaces/*".
- #
- # Example: spaces/AAAAMpdlehYs
- "type": "A String", # Output only. The type of a space.
- # This is deprecated. Use `single_user_bot_dm` instead.
- "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ "userMention": { # Annotation metadata for user mentions (@). # The metadata of user mention.
+ "user": { # A user in Hangouts Chat. # The user mentioned.
+ "type": "A String", # User type.
+ "domainId": "A String", # Obfuscated domain information.
+ "name": "A String", # Resource name, in the format "users/*".
+ "displayName": "A String", # The user's display name.
+ },
+ "type": "A String", # The type of user mention.
+ },
+ "type": "A String", # The type of this annotation.
+ "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
+ "startIndex": 42, # Start index (0-based, inclusive) in the plain-text message body this annotation corresponds to.
},
- "thread": { # A thread in Hangouts Chat. # The thread the message belongs to.
- "name": "A String", # Resource name, in the form "spaces/*/threads/*".
- #
- # Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
- },
- "fallbackText": "A String", # A plain-text description of the message's cards, used when the actual cards
- # cannot be displayed (e.g. mobile notifications).
- }</pre>
+ ],
+ "slashCommand": { # A Slash Command in Hangouts Chat. # Slash command information, if applicable.
+ "commandId": "A String", # The id of the slash command invoked.
+ },
+ "text": "A String", # Plain-text body of the message.
+ "previewText": "A String", # Text for generating preview chips. This text will not be displayed to the user, but any links to images, web pages, videos, etc. included here will generate preview chips.
+ "space": { # A room or DM in Hangouts Chat. # The space the message belongs to.
+ "threaded": True or False, # Whether the messages are threaded in this space.
+ "displayName": "A String", # Output only. The display name (only if the space is a room). Please note that this field might not be populated in direct messages between humans.
+ "type": "A String", # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.
+ "name": "A String", # Resource name of the space, in the form "spaces/*". Example: spaces/AAAAMpdlehYs
+ "singleUserBotDm": True or False, # Whether the space is a DM between a bot and a single human.
+ },
+ "argumentText": "A String", # Plain-text body of the message with all bot mentions stripped out.
+ "name": "A String", # Resource name, in the form "spaces/*/messages/*". Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
+ }</pre>
</div>
</body></html>
\ No newline at end of file