Skip to content

Commit ba90d3f

Browse files
feat(chat): update the api
#### chat:v1 The following keys were added: - resources.dms.methods.messages.parameters.requestId (Total Keys: 2) - resources.dms.methods.webhooks.parameters.requestId (Total Keys: 2) - resources.dms.resources.conversations.methods.messages.parameters.requestId (Total Keys: 2) - resources.rooms.methods.messages.parameters.requestId (Total Keys: 2) - resources.rooms.methods.webhooks.parameters.requestId (Total Keys: 2) - resources.rooms.resources.conversations.methods.messages.parameters.requestId (Total Keys: 2) - resources.spaces.methods.webhooks.parameters.requestId (Total Keys: 2) - resources.spaces.resources.messages.methods.create.parameters.requestId (Total Keys: 2)
1 parent b86e9bd commit ba90d3f

File tree

7 files changed

+112
-62
lines changed

7 files changed

+112
-62
lines changed

docs/dyn/chat_v1.dms.conversations.html

+7-6
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ <h2>Instance Methods</h2>
7878
<code><a href="#close">close()</a></code></p>
7979
<p class="firstline">Close httplib2 connections.</p>
8080
<p class="toc_element">
81-
<code><a href="#messages">messages(parent, body=None, threadKey=None, x__xgafv=None)</a></code></p>
81+
<code><a href="#messages">messages(parent, body=None, requestId=None, threadKey=None, x__xgafv=None)</a></code></p>
8282
<p class="firstline">Legacy path for creating message. Calling these will result in a BadRequest response.</p>
8383
<h3>Method Details</h3>
8484
<div class="method">
@@ -87,7 +87,7 @@ <h3>Method Details</h3>
8787
</div>
8888

8989
<div class="method">
90-
<code class="details" id="messages">messages(parent, body=None, threadKey=None, x__xgafv=None)</code>
90+
<code class="details" id="messages">messages(parent, body=None, requestId=None, threadKey=None, x__xgafv=None)</code>
9191
<pre>Legacy path for creating message. Calling these will result in a BadRequest response.
9292

9393
Args:
@@ -835,7 +835,7 @@ <h3>Method Details</h3>
835835
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was created in Google Chat server.
836836
&quot;fallbackText&quot;: &quot;A String&quot;, # A plain-text description of the message&#x27;s cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
837837
&quot;lastUpdateTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was last updated in Google Chat server. If the message was never updated, this field will be same as create_time.
838-
&quot;name&quot;: &quot;A String&quot;,
838+
&quot;name&quot;: &quot;A String&quot;, # Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4`
839839
&quot;previewText&quot;: &quot;A String&quot;, # 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.
840840
&quot;sender&quot;: { # A user in Google Chat. # The user who created the message.
841841
&quot;displayName&quot;: &quot;A String&quot;, # The user&#x27;s display name.
@@ -849,7 +849,7 @@ <h3>Method Details</h3>
849849
},
850850
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat bot. # The space the message belongs to.
851851
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name (only if the space is of type `ROOM`). Please note that this field might not be populated in direct messages between humans.
852-
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAMpdlehYs
852+
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAAAAAAAAA
853853
&quot;singleUserBotDm&quot;: True or False, # Whether the space is a DM between a bot and a single human.
854854
&quot;threaded&quot;: True or False, # Whether the messages are threaded in this space.
855855
&quot;type&quot;: &quot;A String&quot;, # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.
@@ -860,6 +860,7 @@ <h3>Method Details</h3>
860860
},
861861
}
862862

863+
requestId: string, Optional. A unique request ID for this message. If a message has already been created in the space with this request ID, the subsequent request will return the existing message and no new message will be created.
863864
threadKey: string, Optional. 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 Google 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.
864865
x__xgafv: string, V1 error format.
865866
Allowed values
@@ -1609,7 +1610,7 @@ <h3>Method Details</h3>
16091610
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was created in Google Chat server.
16101611
&quot;fallbackText&quot;: &quot;A String&quot;, # A plain-text description of the message&#x27;s cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
16111612
&quot;lastUpdateTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was last updated in Google Chat server. If the message was never updated, this field will be same as create_time.
1612-
&quot;name&quot;: &quot;A String&quot;,
1613+
&quot;name&quot;: &quot;A String&quot;, # Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4`
16131614
&quot;previewText&quot;: &quot;A String&quot;, # 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.
16141615
&quot;sender&quot;: { # A user in Google Chat. # The user who created the message.
16151616
&quot;displayName&quot;: &quot;A String&quot;, # The user&#x27;s display name.
@@ -1623,7 +1624,7 @@ <h3>Method Details</h3>
16231624
},
16241625
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat bot. # The space the message belongs to.
16251626
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name (only if the space is of type `ROOM`). Please note that this field might not be populated in direct messages between humans.
1626-
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAMpdlehYs
1627+
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAAAAAAAAA
16271628
&quot;singleUserBotDm&quot;: True or False, # Whether the space is a DM between a bot and a single human.
16281629
&quot;threaded&quot;: True or False, # Whether the messages are threaded in this space.
16291630
&quot;type&quot;: &quot;A String&quot;, # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.

docs/dyn/chat_v1.dms.html

+14-12
Original file line numberDiff line numberDiff line change
@@ -83,10 +83,10 @@ <h2>Instance Methods</h2>
8383
<code><a href="#close">close()</a></code></p>
8484
<p class="firstline">Close httplib2 connections.</p>
8585
<p class="toc_element">
86-
<code><a href="#messages">messages(parent, body=None, threadKey=None, x__xgafv=None)</a></code></p>
86+
<code><a href="#messages">messages(parent, body=None, requestId=None, threadKey=None, x__xgafv=None)</a></code></p>
8787
<p class="firstline">Legacy path for creating message. Calling these will result in a BadRequest response.</p>
8888
<p class="toc_element">
89-
<code><a href="#webhooks">webhooks(parent, body=None, threadKey=None, x__xgafv=None)</a></code></p>
89+
<code><a href="#webhooks">webhooks(parent, body=None, requestId=None, threadKey=None, x__xgafv=None)</a></code></p>
9090
<p class="firstline">Legacy path for creating message. Calling these will result in a BadRequest response.</p>
9191
<h3>Method Details</h3>
9292
<div class="method">
@@ -95,7 +95,7 @@ <h3>Method Details</h3>
9595
</div>
9696

9797
<div class="method">
98-
<code class="details" id="messages">messages(parent, body=None, threadKey=None, x__xgafv=None)</code>
98+
<code class="details" id="messages">messages(parent, body=None, requestId=None, threadKey=None, x__xgafv=None)</code>
9999
<pre>Legacy path for creating message. Calling these will result in a BadRequest response.
100100

101101
Args:
@@ -843,7 +843,7 @@ <h3>Method Details</h3>
843843
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was created in Google Chat server.
844844
&quot;fallbackText&quot;: &quot;A String&quot;, # A plain-text description of the message&#x27;s cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
845845
&quot;lastUpdateTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was last updated in Google Chat server. If the message was never updated, this field will be same as create_time.
846-
&quot;name&quot;: &quot;A String&quot;,
846+
&quot;name&quot;: &quot;A String&quot;, # Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4`
847847
&quot;previewText&quot;: &quot;A String&quot;, # 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.
848848
&quot;sender&quot;: { # A user in Google Chat. # The user who created the message.
849849
&quot;displayName&quot;: &quot;A String&quot;, # The user&#x27;s display name.
@@ -857,7 +857,7 @@ <h3>Method Details</h3>
857857
},
858858
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat bot. # The space the message belongs to.
859859
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name (only if the space is of type `ROOM`). Please note that this field might not be populated in direct messages between humans.
860-
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAMpdlehYs
860+
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAAAAAAAAA
861861
&quot;singleUserBotDm&quot;: True or False, # Whether the space is a DM between a bot and a single human.
862862
&quot;threaded&quot;: True or False, # Whether the messages are threaded in this space.
863863
&quot;type&quot;: &quot;A String&quot;, # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.
@@ -868,6 +868,7 @@ <h3>Method Details</h3>
868868
},
869869
}
870870

871+
requestId: string, Optional. A unique request ID for this message. If a message has already been created in the space with this request ID, the subsequent request will return the existing message and no new message will be created.
871872
threadKey: string, Optional. 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 Google 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.
872873
x__xgafv: string, V1 error format.
873874
Allowed values
@@ -1617,7 +1618,7 @@ <h3>Method Details</h3>
16171618
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was created in Google Chat server.
16181619
&quot;fallbackText&quot;: &quot;A String&quot;, # A plain-text description of the message&#x27;s cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
16191620
&quot;lastUpdateTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was last updated in Google Chat server. If the message was never updated, this field will be same as create_time.
1620-
&quot;name&quot;: &quot;A String&quot;,
1621+
&quot;name&quot;: &quot;A String&quot;, # Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4`
16211622
&quot;previewText&quot;: &quot;A String&quot;, # 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.
16221623
&quot;sender&quot;: { # A user in Google Chat. # The user who created the message.
16231624
&quot;displayName&quot;: &quot;A String&quot;, # The user&#x27;s display name.
@@ -1631,7 +1632,7 @@ <h3>Method Details</h3>
16311632
},
16321633
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat bot. # The space the message belongs to.
16331634
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name (only if the space is of type `ROOM`). Please note that this field might not be populated in direct messages between humans.
1634-
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAMpdlehYs
1635+
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAAAAAAAAA
16351636
&quot;singleUserBotDm&quot;: True or False, # Whether the space is a DM between a bot and a single human.
16361637
&quot;threaded&quot;: True or False, # Whether the messages are threaded in this space.
16371638
&quot;type&quot;: &quot;A String&quot;, # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.
@@ -1644,7 +1645,7 @@ <h3>Method Details</h3>
16441645
</div>
16451646

16461647
<div class="method">
1647-
<code class="details" id="webhooks">webhooks(parent, body=None, threadKey=None, x__xgafv=None)</code>
1648+
<code class="details" id="webhooks">webhooks(parent, body=None, requestId=None, threadKey=None, x__xgafv=None)</code>
16481649
<pre>Legacy path for creating message. Calling these will result in a BadRequest response.
16491650

16501651
Args:
@@ -2392,7 +2393,7 @@ <h3>Method Details</h3>
23922393
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was created in Google Chat server.
23932394
&quot;fallbackText&quot;: &quot;A String&quot;, # A plain-text description of the message&#x27;s cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
23942395
&quot;lastUpdateTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was last updated in Google Chat server. If the message was never updated, this field will be same as create_time.
2395-
&quot;name&quot;: &quot;A String&quot;,
2396+
&quot;name&quot;: &quot;A String&quot;, # Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4`
23962397
&quot;previewText&quot;: &quot;A String&quot;, # 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.
23972398
&quot;sender&quot;: { # A user in Google Chat. # The user who created the message.
23982399
&quot;displayName&quot;: &quot;A String&quot;, # The user&#x27;s display name.
@@ -2406,7 +2407,7 @@ <h3>Method Details</h3>
24062407
},
24072408
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat bot. # The space the message belongs to.
24082409
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name (only if the space is of type `ROOM`). Please note that this field might not be populated in direct messages between humans.
2409-
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAMpdlehYs
2410+
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAAAAAAAAA
24102411
&quot;singleUserBotDm&quot;: True or False, # Whether the space is a DM between a bot and a single human.
24112412
&quot;threaded&quot;: True or False, # Whether the messages are threaded in this space.
24122413
&quot;type&quot;: &quot;A String&quot;, # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.
@@ -2417,6 +2418,7 @@ <h3>Method Details</h3>
24172418
},
24182419
}
24192420

2421+
requestId: string, Optional. A unique request ID for this message. If a message has already been created in the space with this request ID, the subsequent request will return the existing message and no new message will be created.
24202422
threadKey: string, Optional. 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 Google 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.
24212423
x__xgafv: string, V1 error format.
24222424
Allowed values
@@ -3166,7 +3168,7 @@ <h3>Method Details</h3>
31663168
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was created in Google Chat server.
31673169
&quot;fallbackText&quot;: &quot;A String&quot;, # A plain-text description of the message&#x27;s cards, used when the actual cards cannot be displayed (e.g. mobile notifications).
31683170
&quot;lastUpdateTime&quot;: &quot;A String&quot;, # Output only. The time at which the message was last updated in Google Chat server. If the message was never updated, this field will be same as create_time.
3169-
&quot;name&quot;: &quot;A String&quot;,
3171+
&quot;name&quot;: &quot;A String&quot;, # Resource name in the form `spaces/*/messages/*`. Example: `spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4`
31703172
&quot;previewText&quot;: &quot;A String&quot;, # 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.
31713173
&quot;sender&quot;: { # A user in Google Chat. # The user who created the message.
31723174
&quot;displayName&quot;: &quot;A String&quot;, # The user&#x27;s display name.
@@ -3180,7 +3182,7 @@ <h3>Method Details</h3>
31803182
},
31813183
&quot;space&quot;: { # A space in Google Chat. Spaces are conversations between two or more users or 1:1 messages between a user and a Chat bot. # The space the message belongs to.
31823184
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name (only if the space is of type `ROOM`). Please note that this field might not be populated in direct messages between humans.
3183-
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAMpdlehYs
3185+
&quot;name&quot;: &quot;A String&quot;, # Resource name of the space, in the form &quot;spaces/*&quot;. Example: spaces/AAAAAAAAAAAA
31843186
&quot;singleUserBotDm&quot;: True or False, # Whether the space is a DM between a bot and a single human.
31853187
&quot;threaded&quot;: True or False, # Whether the messages are threaded in this space.
31863188
&quot;type&quot;: &quot;A String&quot;, # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm` instead.

0 commit comments

Comments
 (0)