Skip to content

Commit 29336d1

Browse files
feat(workspaceevents): update the API
#### workspaceevents:v1 The following keys were added: - auth.oauth2.scopes.https://www.googleapis.com/auth/chat.app.memberships.readonly.description - auth.oauth2.scopes.https://www.googleapis.com/auth/chat.app.spaces.readonly.description - auth.oauth2.scopes.https://www.googleapis.com/auth/chat.users.readstate.description - auth.oauth2.scopes.https://www.googleapis.com/auth/chat.users.readstate.readonly.description - schemas.Subscription.properties.serviceAccountAuthority.description - schemas.Subscription.properties.serviceAccountAuthority.readOnly - schemas.Subscription.properties.serviceAccountAuthority.type - schemas.Subscription.properties.userAuthority.description - schemas.Subscription.properties.userAuthority.readOnly - schemas.Subscription.properties.userAuthority.type The following keys were changed: - resources.operations.methods.get.scopes - resources.subscriptions.methods.create.description - resources.subscriptions.methods.create.scopes - resources.subscriptions.methods.delete.scopes - resources.subscriptions.methods.get.scopes - resources.subscriptions.methods.list.scopes - resources.subscriptions.methods.patch.description - resources.subscriptions.methods.patch.scopes - resources.subscriptions.methods.reactivate.description - resources.subscriptions.methods.reactivate.scopes - schemas.Subscription.properties.suspensionReason.enum - schemas.Subscription.properties.suspensionReason.enumDescriptions
1 parent a380a00 commit 29336d1

2 files changed

Lines changed: 90 additions & 10 deletions

File tree

discovery/workspaceevents-v1.json

Lines changed: 50 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,18 @@
55
"https://www.googleapis.com/auth/chat.app.memberships": {
66
"description": "On their own behalf, apps in Google Chat can see, add, update, and remove members from conversations and spaces"
77
},
8+
"https://www.googleapis.com/auth/chat.app.memberships.readonly": {
9+
"description": "On their own behalf, apps in Google Chat can see members of conversations and spaces"
10+
},
811
"https://www.googleapis.com/auth/chat.app.messages.readonly": {
912
"description": "On their own behalf, apps in Google Chat can see all messages and their associated reactions and message content"
1013
},
1114
"https://www.googleapis.com/auth/chat.app.spaces": {
1215
"description": "On their own behalf, apps in Google Chat can create conversations and spaces and see or update their metadata (including history settings and access settings)"
1316
},
17+
"https://www.googleapis.com/auth/chat.app.spaces.readonly": {
18+
"description": "On their own behalf, apps in Google Chat can see conversations and spaces and their metadata (including history settings and access settings)"
19+
},
1420
"https://www.googleapis.com/auth/chat.bot": {
1521
"description": "Private Service: https://www.googleapis.com/auth/chat.bot"
1622
},
@@ -38,6 +44,12 @@
3844
"https://www.googleapis.com/auth/chat.spaces.readonly": {
3945
"description": "View chat and spaces in Google Chat"
4046
},
47+
"https://www.googleapis.com/auth/chat.users.readstate": {
48+
"description": "View and modify last read time for Google Chat conversations"
49+
},
50+
"https://www.googleapis.com/auth/chat.users.readstate.readonly": {
51+
"description": "View last read time for Google Chat conversations"
52+
},
4153
"https://www.googleapis.com/auth/drive": {
4254
"description": "See, edit, create, and delete all of your Google Drive files"
4355
},
@@ -211,6 +223,8 @@
211223
"https://www.googleapis.com/auth/chat.messages.readonly",
212224
"https://www.googleapis.com/auth/chat.spaces",
213225
"https://www.googleapis.com/auth/chat.spaces.readonly",
226+
"https://www.googleapis.com/auth/chat.users.readstate",
227+
"https://www.googleapis.com/auth/chat.users.readstate.readonly",
214228
"https://www.googleapis.com/auth/drive",
215229
"https://www.googleapis.com/auth/drive.file",
216230
"https://www.googleapis.com/auth/drive.metadata",
@@ -225,7 +239,7 @@
225239
"subscriptions": {
226240
"methods": {
227241
"create": {
228-
"description": "Creates a Google Workspace subscription. To learn how to use this method, see [Create a Google Workspace subscription](https://developers.google.com/workspace/events/guides/create-subscription). For a subscription on a [Chat target resource](https://developers.google.com/workspace/events/guides/events-chat), you can create a subscription as: - A Chat app by specifying an authorization scope that begins with `chat.app` and getting one-time administrator approval ([Developer Preview](https://developers.google.com/workspace/preview)). To learn more, see [Authorize as a Chat app with administrator approval](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). - A user by specifying an authorization scope that doesn't include `app` in its name. To learn more, see [Authorize as a Chat user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
242+
"description": "Creates a Google Workspace subscription. To learn how to use this method, see [Create a Google Workspace subscription](https://developers.google.com/workspace/events/guides/create-subscription). For a subscription on a [Chat target resource](https://developers.google.com/workspace/events/guides/events-chat), you can create a subscription as: - A Chat app by specifying an authorization scope that begins with `chat.app` and getting one-time administrator approval. To learn more, see [Authorize as a Chat app with administrator approval](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). - A user by specifying an authorization scope that doesn't include `app` in its name. To learn more, see [Authorize as a Chat user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
229243
"flatPath": "v1/subscriptions",
230244
"httpMethod": "POST",
231245
"id": "workspaceevents.subscriptions.create",
@@ -246,8 +260,10 @@
246260
},
247261
"scopes": [
248262
"https://www.googleapis.com/auth/chat.app.memberships",
263+
"https://www.googleapis.com/auth/chat.app.memberships.readonly",
249264
"https://www.googleapis.com/auth/chat.app.messages.readonly",
250265
"https://www.googleapis.com/auth/chat.app.spaces",
266+
"https://www.googleapis.com/auth/chat.app.spaces.readonly",
251267
"https://www.googleapis.com/auth/chat.memberships",
252268
"https://www.googleapis.com/auth/chat.memberships.readonly",
253269
"https://www.googleapis.com/auth/chat.messages",
@@ -256,6 +272,8 @@
256272
"https://www.googleapis.com/auth/chat.messages.readonly",
257273
"https://www.googleapis.com/auth/chat.spaces",
258274
"https://www.googleapis.com/auth/chat.spaces.readonly",
275+
"https://www.googleapis.com/auth/chat.users.readstate",
276+
"https://www.googleapis.com/auth/chat.users.readstate.readonly",
259277
"https://www.googleapis.com/auth/drive",
260278
"https://www.googleapis.com/auth/drive.file",
261279
"https://www.googleapis.com/auth/drive.metadata",
@@ -311,6 +329,8 @@
311329
"https://www.googleapis.com/auth/chat.messages.readonly",
312330
"https://www.googleapis.com/auth/chat.spaces",
313331
"https://www.googleapis.com/auth/chat.spaces.readonly",
332+
"https://www.googleapis.com/auth/chat.users.readstate",
333+
"https://www.googleapis.com/auth/chat.users.readstate.readonly",
314334
"https://www.googleapis.com/auth/drive",
315335
"https://www.googleapis.com/auth/drive.file",
316336
"https://www.googleapis.com/auth/drive.metadata",
@@ -351,6 +371,8 @@
351371
"https://www.googleapis.com/auth/chat.messages.readonly",
352372
"https://www.googleapis.com/auth/chat.spaces",
353373
"https://www.googleapis.com/auth/chat.spaces.readonly",
374+
"https://www.googleapis.com/auth/chat.users.readstate",
375+
"https://www.googleapis.com/auth/chat.users.readstate.readonly",
354376
"https://www.googleapis.com/auth/drive",
355377
"https://www.googleapis.com/auth/drive.file",
356378
"https://www.googleapis.com/auth/drive.metadata",
@@ -398,6 +420,8 @@
398420
"https://www.googleapis.com/auth/chat.messages.readonly",
399421
"https://www.googleapis.com/auth/chat.spaces",
400422
"https://www.googleapis.com/auth/chat.spaces.readonly",
423+
"https://www.googleapis.com/auth/chat.users.readstate",
424+
"https://www.googleapis.com/auth/chat.users.readstate.readonly",
401425
"https://www.googleapis.com/auth/drive",
402426
"https://www.googleapis.com/auth/drive.file",
403427
"https://www.googleapis.com/auth/drive.metadata",
@@ -408,7 +432,7 @@
408432
]
409433
},
410434
"patch": {
411-
"description": "Updates or renews a Google Workspace subscription. To learn how to use this method, see [Update or renew a Google Workspace subscription](https://developers.google.com/workspace/events/guides/update-subscription). For a subscription on a [Chat target resource](https://developers.google.com/workspace/events/guides/events-chat), you can update a subscription as: - A Chat app by specifying an authorization scope that begins with `chat.app` andgetting one-time administrator approval ([Developer Preview](https://developers.google.com/workspace/preview)). To learn more, see [Authorize as a Chat app with administrator approval](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). - A user by specifying an authorization scope that doesn't include `app` in its name. To learn more, see [Authorize as a Chat user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
435+
"description": "Updates or renews a Google Workspace subscription. To learn how to use this method, see [Update or renew a Google Workspace subscription](https://developers.google.com/workspace/events/guides/update-subscription). For a subscription on a [Chat target resource](https://developers.google.com/workspace/events/guides/events-chat), you can update a subscription as: - A Chat app by specifying an authorization scope that begins with `chat.app` and getting one-time administrator approval. To learn more, see [Authorize as a Chat app with administrator approval](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). - A user by specifying an authorization scope that doesn't include `app` in its name. To learn more, see [Authorize as a Chat user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
412436
"flatPath": "v1/subscriptions/{subscriptionsId}",
413437
"httpMethod": "PATCH",
414438
"id": "workspaceevents.subscriptions.patch",
@@ -444,8 +468,10 @@
444468
},
445469
"scopes": [
446470
"https://www.googleapis.com/auth/chat.app.memberships",
471+
"https://www.googleapis.com/auth/chat.app.memberships.readonly",
447472
"https://www.googleapis.com/auth/chat.app.messages.readonly",
448473
"https://www.googleapis.com/auth/chat.app.spaces",
474+
"https://www.googleapis.com/auth/chat.app.spaces.readonly",
449475
"https://www.googleapis.com/auth/chat.memberships",
450476
"https://www.googleapis.com/auth/chat.memberships.readonly",
451477
"https://www.googleapis.com/auth/chat.messages",
@@ -454,6 +480,8 @@
454480
"https://www.googleapis.com/auth/chat.messages.readonly",
455481
"https://www.googleapis.com/auth/chat.spaces",
456482
"https://www.googleapis.com/auth/chat.spaces.readonly",
483+
"https://www.googleapis.com/auth/chat.users.readstate",
484+
"https://www.googleapis.com/auth/chat.users.readstate.readonly",
457485
"https://www.googleapis.com/auth/drive",
458486
"https://www.googleapis.com/auth/drive.file",
459487
"https://www.googleapis.com/auth/drive.metadata",
@@ -464,7 +492,7 @@
464492
]
465493
},
466494
"reactivate": {
467-
"description": "Reactivates a suspended Google Workspace subscription. This method resets your subscription's `State` field to `ACTIVE`. Before you use this method, you must fix the error that suspended the subscription. This method will ignore or reject any subscription that isn't currently in a suspended state. To learn how to use this method, see [Reactivate a Google Workspace subscription](https://developers.google.com/workspace/events/guides/reactivate-subscription). For a subscription on a [Chat target resource](https://developers.google.com/workspace/events/guides/events-chat), you can reactivate a subscription as: - A Chat app by specifying an authorization scope that begins with `chat.app` andgetting one-time administrator approval ([Developer Preview](https://developers.google.com/workspace/preview)). To learn more, see [Authorize as a Chat app with administrator approval](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). - A user by specifying an authorization scope that doesn't include `app` in its name. To learn more, see [Authorize as a Chat user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
495+
"description": "Reactivates a suspended Google Workspace subscription. This method resets your subscription's `State` field to `ACTIVE`. Before you use this method, you must fix the error that suspended the subscription. This method will ignore or reject any subscription that isn't currently in a suspended state. To learn how to use this method, see [Reactivate a Google Workspace subscription](https://developers.google.com/workspace/events/guides/reactivate-subscription). For a subscription on a [Chat target resource](https://developers.google.com/workspace/events/guides/events-chat), you can reactivate a subscription as: - A Chat app by specifying an authorization scope that begins with `chat.app` and getting one-time administrator approval. To learn more, see [Authorize as a Chat app with administrator approval](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app). - A user by specifying an authorization scope that doesn't include `app` in its name. To learn more, see [Authorize as a Chat user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).",
468496
"flatPath": "v1/subscriptions/{subscriptionsId}:reactivate",
469497
"httpMethod": "POST",
470498
"id": "workspaceevents.subscriptions.reactivate",
@@ -489,8 +517,10 @@
489517
},
490518
"scopes": [
491519
"https://www.googleapis.com/auth/chat.app.memberships",
520+
"https://www.googleapis.com/auth/chat.app.memberships.readonly",
492521
"https://www.googleapis.com/auth/chat.app.messages.readonly",
493522
"https://www.googleapis.com/auth/chat.app.spaces",
523+
"https://www.googleapis.com/auth/chat.app.spaces.readonly",
494524
"https://www.googleapis.com/auth/chat.memberships",
495525
"https://www.googleapis.com/auth/chat.memberships.readonly",
496526
"https://www.googleapis.com/auth/chat.messages",
@@ -499,6 +529,8 @@
499529
"https://www.googleapis.com/auth/chat.messages.readonly",
500530
"https://www.googleapis.com/auth/chat.spaces",
501531
"https://www.googleapis.com/auth/chat.spaces.readonly",
532+
"https://www.googleapis.com/auth/chat.users.readstate",
533+
"https://www.googleapis.com/auth/chat.users.readstate.readonly",
502534
"https://www.googleapis.com/auth/drive",
503535
"https://www.googleapis.com/auth/drive.file",
504536
"https://www.googleapis.com/auth/drive.metadata",
@@ -733,7 +765,7 @@
733765
}
734766
}
735767
},
736-
"revision": "20251216",
768+
"revision": "20260422",
737769
"rootUrl": "https://workspaceevents.googleapis.com/",
738770
"schemas": {
739771
"Artifact": {
@@ -1198,6 +1230,11 @@
11981230
"readOnly": true,
11991231
"type": "boolean"
12001232
},
1233+
"serviceAccountAuthority": {
1234+
"description": "Output only. The service account that was used to authorize the creation of the subscription. This service account must be owned by the same Google Cloud project where you created this subscription. Format: `projects/{project_id}/serviceAccounts/{service_account_id}`",
1235+
"readOnly": true,
1236+
"type": "string"
1237+
},
12011238
"state": {
12021239
"description": "Output only. The state of the subscription. Determines whether the subscription can receive events and deliver them to the notification endpoint.",
12031240
"enum": [
@@ -1220,8 +1257,10 @@
12201257
"enum": [
12211258
"ERROR_TYPE_UNSPECIFIED",
12221259
"USER_SCOPE_REVOKED",
1260+
"APP_SCOPE_REVOKED",
12231261
"RESOURCE_DELETED",
12241262
"USER_AUTHORIZATION_FAILURE",
1263+
"APP_AUTHORIZATION_FAILURE",
12251264
"ENDPOINT_PERMISSION_DENIED",
12261265
"ENDPOINT_NOT_FOUND",
12271266
"ENDPOINT_RESOURCE_EXHAUSTED",
@@ -1230,8 +1269,10 @@
12301269
"enumDescriptions": [
12311270
"Default value. This value is unused.",
12321271
"The authorizing user has revoked the grant of one or more OAuth scopes. To learn more about authorization for Google Workspace, see [Configure the OAuth consent screen](https://developers.google.com/workspace/guides/configure-oauth-consent#choose-scopes).",
1272+
"The domain administrator has revoked the grant of one or more OAuth scopes for the app.",
12331273
"The target resource for the subscription no longer exists.",
12341274
"The user that authorized the creation of the subscription no longer has access to the subscription's target resource.",
1275+
"The app that authorized the creation of the subscription no longer has access to the subscription's target resource.",
12351276
"The Google Workspace application doesn't have access to deliver events to your subscription's notification endpoint.",
12361277
"The subscription's notification endpoint doesn't exist, or the endpoint can't be found in the Google Cloud project where you created the subscription.",
12371278
"The subscription's notification endpoint failed to receive events due to insufficient quota or reaching rate limiting.",
@@ -1259,6 +1300,11 @@
12591300
"format": "google-datetime",
12601301
"readOnly": true,
12611302
"type": "string"
1303+
},
1304+
"userAuthority": {
1305+
"description": "Output only. The user who authorized the creation of the subscription. The user must be able to view the `target_resource`. For Google Workspace users, the `{user}` value is the [`user.id`](https://developers.google.com/workspace/admin/directory/reference/rest/v1/users#User.FIELDS.id) field from the Directory API. Format: `users/{user}`",
1306+
"readOnly": true,
1307+
"type": "string"
12621308
}
12631309
},
12641310
"type": "object"

0 commit comments

Comments
 (0)