Skip to content

Commit 40e0811

Browse files
feat: [chat] add GetSpaceEvent and ListSpaceEvents APIs (#5546)
* feat: add GetSpaceEvent and ListSpaceEvents APIs PiperOrigin-RevId: 651735637 Source-Link: googleapis/googleapis@7a77d8e Source-Link: googleapis/googleapis-gen@86a91f7 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNoYXQvLk93bEJvdC55YW1sIiwiaCI6Ijg2YTkxZjdjZjY0NWM0NWZkYzlhZTYzOWMzMGIyZmEwNGVhMzZiMWUifQ== * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 00296ee commit 40e0811

16 files changed

Lines changed: 10129 additions & 0 deletions

packages/google-chat/README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -140,11 +140,13 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
140140
| Chat_service.get_membership | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_membership.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_membership.js,packages/google-chat/samples/README.md) |
141141
| Chat_service.get_message | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_message.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_message.js,packages/google-chat/samples/README.md) |
142142
| Chat_service.get_space | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_space.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_space.js,packages/google-chat/samples/README.md) |
143+
| Chat_service.get_space_event | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_space_event.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_space_event.js,packages/google-chat/samples/README.md) |
143144
| Chat_service.get_space_read_state | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_space_read_state.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_space_read_state.js,packages/google-chat/samples/README.md) |
144145
| Chat_service.get_thread_read_state | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.get_thread_read_state.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.get_thread_read_state.js,packages/google-chat/samples/README.md) |
145146
| Chat_service.list_memberships | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_memberships.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_memberships.js,packages/google-chat/samples/README.md) |
146147
| Chat_service.list_messages | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_messages.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_messages.js,packages/google-chat/samples/README.md) |
147148
| Chat_service.list_reactions | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_reactions.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_reactions.js,packages/google-chat/samples/README.md) |
149+
| Chat_service.list_space_events | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_space_events.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_space_events.js,packages/google-chat/samples/README.md) |
148150
| Chat_service.list_spaces | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.list_spaces.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.list_spaces.js,packages/google-chat/samples/README.md) |
149151
| Chat_service.set_up_space | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.set_up_space.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.set_up_space.js,packages/google-chat/samples/README.md) |
150152
| Chat_service.update_membership | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-chat/samples/generated/v1/chat_service.update_membership.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-chat/samples/generated/v1/chat_service.update_membership.js,packages/google-chat/samples/README.md) |

packages/google-chat/protos/google/chat/v1/chat_service.proto

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ import "google/chat/v1/membership.proto";
2323
import "google/chat/v1/message.proto";
2424
import "google/chat/v1/reaction.proto";
2525
import "google/chat/v1/space.proto";
26+
import "google/chat/v1/space_event.proto";
2627
import "google/chat/v1/space_read_state.proto";
2728
import "google/chat/v1/space_setup.proto";
2829
import "google/chat/v1/thread_read_state.proto";
@@ -584,4 +585,47 @@ service ChatService {
584585
};
585586
option (google.api.method_signature) = "name";
586587
}
588+
589+
// Returns an event from a Google Chat space. The [event
590+
// payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload)
591+
// contains the most recent version of the resource that changed. For example,
592+
// if you request an event about a new message but the message was later
593+
// updated, the server returns the updated `Message` resource in the event
594+
// payload.
595+
//
596+
// Requires [user
597+
// authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
598+
// To get an event, the authenticated user must be a member of the space.
599+
//
600+
// For an example, see [Get details about an
601+
// event from a Google Chat
602+
// space](https://developers.google.com/workspace/chat/get-space-event).
603+
rpc GetSpaceEvent(GetSpaceEventRequest) returns (SpaceEvent) {
604+
option (google.api.http) = {
605+
get: "/v1/{name=spaces/*/spaceEvents/*}"
606+
};
607+
option (google.api.method_signature) = "name";
608+
}
609+
610+
// Lists events from a Google Chat space. For each event, the
611+
// [payload](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents#SpaceEvent.FIELDS.oneof_payload)
612+
// contains the most recent version of the Chat resource. For example, if you
613+
// list events about new space members, the server returns `Membership`
614+
// resources that contain the latest membership details. If new members were
615+
// removed during the requested period, the event payload contains an empty
616+
// `Membership` resource.
617+
//
618+
// Requires [user
619+
// authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
620+
// To list events, the authenticated user must be a member of the space.
621+
//
622+
// For an example, see [List events from a Google Chat
623+
// space](https://developers.google.com/workspace/chat/list-space-events).
624+
rpc ListSpaceEvents(ListSpaceEventsRequest)
625+
returns (ListSpaceEventsResponse) {
626+
option (google.api.http) = {
627+
get: "/v1/{parent=spaces/*}/spaceEvents"
628+
};
629+
option (google.api.method_signature) = "parent,filter";
630+
}
587631
}
Lines changed: 177 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,177 @@
1+
// Copyright 2024 Google LLC
2+
//
3+
// Licensed under the Apache License, Version 2.0 (the "License");
4+
// you may not use this file except in compliance with the License.
5+
// You may obtain a copy of the License at
6+
//
7+
// http://www.apache.org/licenses/LICENSE-2.0
8+
//
9+
// Unless required by applicable law or agreed to in writing, software
10+
// distributed under the License is distributed on an "AS IS" BASIS,
11+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
// See the License for the specific language governing permissions and
13+
// limitations under the License.
14+
15+
syntax = "proto3";
16+
17+
package google.chat.v1;
18+
19+
import "google/api/field_behavior.proto";
20+
import "google/chat/v1/membership.proto";
21+
import "google/chat/v1/message.proto";
22+
import "google/chat/v1/reaction.proto";
23+
import "google/chat/v1/space.proto";
24+
25+
option csharp_namespace = "Google.Apps.Chat.V1";
26+
option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
27+
option java_multiple_files = true;
28+
option java_outer_classname = "EventPayloadProto";
29+
option java_package = "com.google.chat.v1";
30+
option objc_class_prefix = "DYNAPIProto";
31+
option php_namespace = "Google\\Apps\\Chat\\V1";
32+
option ruby_package = "Google::Apps::Chat::V1";
33+
34+
// Event payload for a new membership.
35+
//
36+
// Event type: `google.workspace.chat.membership.v1.created`.
37+
message MembershipCreatedEventData {
38+
// The new membership.
39+
Membership membership = 1;
40+
}
41+
42+
// Event payload for a deleted membership.
43+
//
44+
// Event type: `google.workspace.chat.membership.v1.deleted`
45+
message MembershipDeletedEventData {
46+
// The deleted membership. Only the `name` and `state` fields are populated.
47+
Membership membership = 1;
48+
}
49+
50+
// Event payload for an updated membership.
51+
//
52+
// Event type: `google.workspace.chat.membership.v1.updated`
53+
message MembershipUpdatedEventData {
54+
// The updated membership.
55+
Membership membership = 1;
56+
}
57+
58+
// Event payload for multiple new memberships.
59+
//
60+
// Event type: `google.workspace.chat.membership.v1.batchCreated`
61+
message MembershipBatchCreatedEventData {
62+
// A list of new memberships.
63+
repeated MembershipCreatedEventData memberships = 1;
64+
}
65+
66+
// Event payload for multiple updated memberships.
67+
//
68+
// Event type: `google.workspace.chat.membership.v1.batchUpdated`
69+
message MembershipBatchUpdatedEventData {
70+
// A list of updated memberships.
71+
repeated MembershipUpdatedEventData memberships = 1;
72+
}
73+
74+
// Event payload for multiple deleted memberships.
75+
//
76+
// Event type: `google.workspace.chat.membership.v1.batchDeleted`
77+
message MembershipBatchDeletedEventData {
78+
// A list of deleted memberships.
79+
repeated MembershipDeletedEventData memberships = 1;
80+
}
81+
82+
// Event payload for a new message.
83+
//
84+
// Event type: `google.workspace.chat.message.v1.created`
85+
message MessageCreatedEventData {
86+
// The new message.
87+
Message message = 1;
88+
}
89+
90+
// Event payload for an updated message.
91+
//
92+
// Event type: `google.workspace.chat.message.v1.updated`
93+
message MessageUpdatedEventData {
94+
// The updated message.
95+
Message message = 1;
96+
}
97+
98+
// Event payload for a deleted message.
99+
//
100+
// Event type: `google.workspace.chat.message.v1.deleted`
101+
message MessageDeletedEventData {
102+
// The deleted message. Only the `name`, `createTime`, `deleteTime`, and
103+
// `deletionMetadata` fields are populated.
104+
Message message = 1;
105+
}
106+
107+
// Event payload for multiple new messages.
108+
//
109+
// Event type: `google.workspace.chat.message.v1.batchCreated`
110+
message MessageBatchCreatedEventData {
111+
// A list of new messages.
112+
repeated MessageCreatedEventData messages = 1;
113+
}
114+
115+
// Event payload for multiple updated messages.
116+
//
117+
// Event type: `google.workspace.chat.message.v1.batchUpdated`
118+
message MessageBatchUpdatedEventData {
119+
// A list of updated messages.
120+
repeated MessageUpdatedEventData messages = 1;
121+
}
122+
123+
// Event payload for multiple deleted messages.
124+
//
125+
// Event type: `google.workspace.chat.message.v1.batchDeleted`
126+
message MessageBatchDeletedEventData {
127+
// A list of deleted messages.
128+
repeated MessageDeletedEventData messages = 1;
129+
}
130+
131+
// Event payload for an updated space.
132+
//
133+
// Event type: `google.workspace.chat.space.v1.updated`
134+
message SpaceUpdatedEventData {
135+
// The updated space.
136+
Space space = 1;
137+
}
138+
139+
// Event payload for multiple updates to a space.
140+
//
141+
// Event type: `google.workspace.chat.space.v1.batchUpdated`
142+
message SpaceBatchUpdatedEventData {
143+
// A list of updated spaces.
144+
repeated SpaceUpdatedEventData spaces = 1;
145+
}
146+
147+
// Event payload for a new reaction.
148+
//
149+
// Event type: `google.workspace.chat.reaction.v1.created`
150+
message ReactionCreatedEventData {
151+
// The new reaction.
152+
Reaction reaction = 1;
153+
}
154+
155+
// Event payload for a deleted reaction.
156+
//
157+
// Type: `google.workspace.chat.reaction.v1.deleted`
158+
message ReactionDeletedEventData {
159+
// The deleted reaction.
160+
Reaction reaction = 1;
161+
}
162+
163+
// Event payload for multiple new reactions.
164+
//
165+
// Event type: `google.workspace.chat.reaction.v1.batchCreated`
166+
message ReactionBatchCreatedEventData {
167+
// A list of new reactions.
168+
repeated ReactionCreatedEventData reactions = 1;
169+
}
170+
171+
// Event payload for multiple deleted reactions.
172+
//
173+
// Event type: `google.workspace.chat.reaction.v1.batchDeleted`
174+
message ReactionBatchDeletedEventData {
175+
// A list of deleted reactions.
176+
repeated ReactionDeletedEventData reactions = 1;
177+
}

0 commit comments

Comments
 (0)