Skip to content

Commit 223f373

Browse files
feat(chat): update the api
#### chat:v1 The following keys were added: - resources.users.resources.spaces.resources.spaceNotificationSetting.methods.get (Total Keys: 11) - resources.users.resources.spaces.resources.spaceNotificationSetting.methods.patch (Total Keys: 15) - schemas.SpaceNotificationSetting (Total Keys: 5)
1 parent 3e78dfd commit 223f373

File tree

3 files changed

+259
-1
lines changed

3 files changed

+259
-1
lines changed

docs/dyn/chat_v1.users.spaces.html

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,11 @@
7474

7575
<h1><a href="chat_v1.html">Google Chat API</a> . <a href="chat_v1.users.html">users</a> . <a href="chat_v1.users.spaces.html">spaces</a></h1>
7676
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="chat_v1.users.spaces.spaceNotificationSetting.html">spaceNotificationSetting()</a></code>
79+
</p>
80+
<p class="firstline">Returns the spaceNotificationSetting Resource.</p>
81+
7782
<p class="toc_element">
7883
<code><a href="chat_v1.users.spaces.threads.html">threads()</a></code>
7984
</p>
Lines changed: 144 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
<html><body>
2+
<style>
3+
4+
body, h1, h2, h3, div, span, p, pre, a {
5+
margin: 0;
6+
padding: 0;
7+
border: 0;
8+
font-weight: inherit;
9+
font-style: inherit;
10+
font-size: 100%;
11+
font-family: inherit;
12+
vertical-align: baseline;
13+
}
14+
15+
body {
16+
font-size: 13px;
17+
padding: 1em;
18+
}
19+
20+
h1 {
21+
font-size: 26px;
22+
margin-bottom: 1em;
23+
}
24+
25+
h2 {
26+
font-size: 24px;
27+
margin-bottom: 1em;
28+
}
29+
30+
h3 {
31+
font-size: 20px;
32+
margin-bottom: 1em;
33+
margin-top: 1em;
34+
}
35+
36+
pre, code {
37+
line-height: 1.5;
38+
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39+
}
40+
41+
pre {
42+
margin-top: 0.5em;
43+
}
44+
45+
h1, h2, h3, p {
46+
font-family: Arial, sans serif;
47+
}
48+
49+
h1, h2, h3 {
50+
border-bottom: solid #CCC 1px;
51+
}
52+
53+
.toc_element {
54+
margin-top: 0.5em;
55+
}
56+
57+
.firstline {
58+
margin-left: 2 em;
59+
}
60+
61+
.method {
62+
margin-top: 1em;
63+
border: solid 1px #CCC;
64+
padding: 1em;
65+
background: #EEE;
66+
}
67+
68+
.details {
69+
font-weight: bold;
70+
font-size: 14px;
71+
}
72+
73+
</style>
74+
75+
<h1><a href="chat_v1.html">Google Chat API</a> . <a href="chat_v1.users.html">users</a> . <a href="chat_v1.users.spaces.html">spaces</a> . <a href="chat_v1.users.spaces.spaceNotificationSetting.html">spaceNotificationSetting</a></h1>
76+
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="#close">close()</a></code></p>
79+
<p class="firstline">Close httplib2 connections.</p>
80+
<p class="toc_element">
81+
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
82+
<p class="firstline">Gets the space notification state setting. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</p>
83+
<p class="toc_element">
84+
<code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
85+
<p class="firstline">Updates the space notification state setting. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).</p>
86+
<h3>Method Details</h3>
87+
<div class="method">
88+
<code class="details" id="close">close()</code>
89+
<pre>Close httplib2 connections.</pre>
90+
</div>
91+
92+
<div class="method">
93+
<code class="details" id="get">get(name, x__xgafv=None)</code>
94+
<pre>Gets the space notification state setting. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
95+
96+
Args:
97+
name: string, Required. Format: users/{user}/spaces/{space}/spaceNotificationSetting - `users/me/spaces/{space}/spaceNotificationSetting`, OR - `users/user@example.com/spaces/{space}/spaceNotificationSetting`, OR - `users/123456789/spaces/{space}/spaceNotificationSetting`. Note: Only the caller&#x27;s user id or email is allowed in the path. (required)
98+
x__xgafv: string, V1 error format.
99+
Allowed values
100+
1 - v1 error format
101+
2 - v2 error format
102+
103+
Returns:
104+
An object of the form:
105+
106+
{ # The notification setting of a user in a space.
107+
&quot;muteSetting&quot;: &quot;A String&quot;, # The space notification mute setting.
108+
&quot;name&quot;: &quot;A String&quot;, # Identifier. The resource name of the space notification setting. Format: `users/{user}/spaces/{space}/spaceNotificationSetting`.
109+
&quot;notificationSetting&quot;: &quot;A String&quot;, # The notification setting.
110+
}</pre>
111+
</div>
112+
113+
<div class="method">
114+
<code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
115+
<pre>Updates the space notification state setting. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
116+
117+
Args:
118+
name: string, Identifier. The resource name of the space notification setting. Format: `users/{user}/spaces/{space}/spaceNotificationSetting`. (required)
119+
body: object, The request body.
120+
The object takes the form of:
121+
122+
{ # The notification setting of a user in a space.
123+
&quot;muteSetting&quot;: &quot;A String&quot;, # The space notification mute setting.
124+
&quot;name&quot;: &quot;A String&quot;, # Identifier. The resource name of the space notification setting. Format: `users/{user}/spaces/{space}/spaceNotificationSetting`.
125+
&quot;notificationSetting&quot;: &quot;A String&quot;, # The notification setting.
126+
}
127+
128+
updateMask: string, Required. Supported field paths: - `notification_setting` - `mute_setting`
129+
x__xgafv: string, V1 error format.
130+
Allowed values
131+
1 - v1 error format
132+
2 - v2 error format
133+
134+
Returns:
135+
An object of the form:
136+
137+
{ # The notification setting of a user in a space.
138+
&quot;muteSetting&quot;: &quot;A String&quot;, # The space notification mute setting.
139+
&quot;name&quot;: &quot;A String&quot;, # Identifier. The resource name of the space notification setting. Format: `users/{user}/spaces/{space}/spaceNotificationSetting`.
140+
&quot;notificationSetting&quot;: &quot;A String&quot;, # The notification setting.
141+
}</pre>
142+
</div>
143+
144+
</body></html>

googleapiclient/discovery_cache/documents/chat.v1.json

Lines changed: 110 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,9 @@
7979
},
8080
"https://www.googleapis.com/auth/chat.users.readstate.readonly": {
8181
"description": "View last read time for Google Chat conversations"
82+
},
83+
"https://www.googleapis.com/auth/chat.users.spacesettings": {
84+
"description": "Read and update your space settings"
8285
}
8386
}
8487
}
@@ -1309,6 +1312,69 @@
13091312
}
13101313
},
13111314
"resources": {
1315+
"spaceNotificationSetting": {
1316+
"methods": {
1317+
"get": {
1318+
"description": "Gets the space notification state setting. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
1319+
"flatPath": "v1/users/{usersId}/spaces/{spacesId}/spaceNotificationSetting",
1320+
"httpMethod": "GET",
1321+
"id": "chat.users.spaces.spaceNotificationSetting.get",
1322+
"parameterOrder": [
1323+
"name"
1324+
],
1325+
"parameters": {
1326+
"name": {
1327+
"description": "Required. Format: users/{user}/spaces/{space}/spaceNotificationSetting - `users/me/spaces/{space}/spaceNotificationSetting`, OR - `users/user@example.com/spaces/{space}/spaceNotificationSetting`, OR - `users/123456789/spaces/{space}/spaceNotificationSetting`. Note: Only the caller's user id or email is allowed in the path.",
1328+
"location": "path",
1329+
"pattern": "^users/[^/]+/spaces/[^/]+/spaceNotificationSetting$",
1330+
"required": true,
1331+
"type": "string"
1332+
}
1333+
},
1334+
"path": "v1/{+name}",
1335+
"response": {
1336+
"$ref": "SpaceNotificationSetting"
1337+
},
1338+
"scopes": [
1339+
"https://www.googleapis.com/auth/chat.users.spacesettings"
1340+
]
1341+
},
1342+
"patch": {
1343+
"description": "Updates the space notification state setting. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
1344+
"flatPath": "v1/users/{usersId}/spaces/{spacesId}/spaceNotificationSetting",
1345+
"httpMethod": "PATCH",
1346+
"id": "chat.users.spaces.spaceNotificationSetting.patch",
1347+
"parameterOrder": [
1348+
"name"
1349+
],
1350+
"parameters": {
1351+
"name": {
1352+
"description": "Identifier. The resource name of the space notification setting. Format: `users/{user}/spaces/{space}/spaceNotificationSetting`.",
1353+
"location": "path",
1354+
"pattern": "^users/[^/]+/spaces/[^/]+/spaceNotificationSetting$",
1355+
"required": true,
1356+
"type": "string"
1357+
},
1358+
"updateMask": {
1359+
"description": "Required. Supported field paths: - `notification_setting` - `mute_setting`",
1360+
"format": "google-fieldmask",
1361+
"location": "query",
1362+
"type": "string"
1363+
}
1364+
},
1365+
"path": "v1/{+name}",
1366+
"request": {
1367+
"$ref": "SpaceNotificationSetting"
1368+
},
1369+
"response": {
1370+
"$ref": "SpaceNotificationSetting"
1371+
},
1372+
"scopes": [
1373+
"https://www.googleapis.com/auth/chat.users.spacesettings"
1374+
]
1375+
}
1376+
}
1377+
},
13121378
"threads": {
13131379
"methods": {
13141380
"getThreadReadState": {
@@ -1344,7 +1410,7 @@
13441410
}
13451411
}
13461412
},
1347-
"revision": "20250213",
1413+
"revision": "20250227",
13481414
"rootUrl": "https://chat.googleapis.com/",
13491415
"schemas": {
13501416
"AccessSettings": {
@@ -4913,6 +4979,49 @@
49134979
},
49144980
"type": "object"
49154981
},
4982+
"SpaceNotificationSetting": {
4983+
"description": "The notification setting of a user in a space.",
4984+
"id": "SpaceNotificationSetting",
4985+
"properties": {
4986+
"muteSetting": {
4987+
"description": "The space notification mute setting.",
4988+
"enum": [
4989+
"MUTE_SETTING_UNSPECIFIED",
4990+
"UNMUTED",
4991+
"MUTED"
4992+
],
4993+
"enumDescriptions": [
4994+
"Reserved.",
4995+
"The user will receive notifications for the space based on the notification setting.",
4996+
"The user will not receive any notifications for the space, regardless of the notification setting."
4997+
],
4998+
"type": "string"
4999+
},
5000+
"name": {
5001+
"description": "Identifier. The resource name of the space notification setting. Format: `users/{user}/spaces/{space}/spaceNotificationSetting`.",
5002+
"type": "string"
5003+
},
5004+
"notificationSetting": {
5005+
"description": "The notification setting.",
5006+
"enum": [
5007+
"NOTIFICATION_SETTING_UNSPECIFIED",
5008+
"ALL",
5009+
"MAIN_CONVERSATIONS",
5010+
"FOR_YOU",
5011+
"OFF"
5012+
],
5013+
"enumDescriptions": [
5014+
"Reserved.",
5015+
"Notifications are triggered by @mentions, followed threads, first message of new threads. All new threads are automatically followed, unless manually unfollowed by the user.",
5016+
"The notification is triggered by @mentions, followed threads, first message of new threads. Not available for 1:1 direct messages.",
5017+
"The notification is triggered by @mentions, followed threads. Not available for 1:1 direct messages.",
5018+
"Notification is off."
5019+
],
5020+
"type": "string"
5021+
}
5022+
},
5023+
"type": "object"
5024+
},
49165025
"SpaceReadState": {
49175026
"description": "A user's read state within a space, used to identify read and unread messages.",
49185027
"id": "SpaceReadState",

0 commit comments

Comments
 (0)