feat: add UpdateMembership API

Google APIs · copybara-github · commit c106d2f8cfec · 2024-04-17T14:23:54.000-07:00
PiperOrigin-RevId: 625805898
diff --git a/google/chat/v1/chat_service.proto b/google/chat/v1/chat_service.proto
@@ -441,6 +441,16 @@ service ChatService {
     option (google.api.method_signature) = "parent,membership";
   }
 
+  // Updates a membership. Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc UpdateMembership(UpdateMembershipRequest) returns (Membership) {
+    option (google.api.http) = {
+      patch: "/v1/{membership.name=spaces/*/members/*}"
+      body: "membership"
+    };
+    option (google.api.method_signature) = "membership,update_mask";
+  }
+
   // Deletes a membership. For an example, see
   // [Remove a user or a Google Chat app from a
   // space](https://developers.google.com/workspace/chat/delete-members).
diff --git a/google/chat/v1/membership.proto b/google/chat/v1/membership.proto
@@ -20,6 +20,7 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/chat/v1/group.proto";
 import "google/chat/v1/user.proto";
+import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Apps.Chat.V1";
@@ -89,7 +90,6 @@ message Membership {
   // Optional. User's role within a Chat space, which determines their permitted
   // actions in the space.
   //
-  // [Developer Preview](https://developers.google.com/workspace/preview):
   // This field can only be used as input in `UpdateMembership`.
   MembershipRole role = 7 [(google.api.field_behavior) = OPTIONAL];
 
@@ -159,6 +159,22 @@ message CreateMembershipRequest {
   Membership membership = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
+// Request message for updating a membership.
+message UpdateMembershipRequest {
+  // Required. The membership to update. Only fields specified by `update_mask`
+  // are updated.
+  Membership membership = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The field paths to update. Separate multiple values with commas
+  // or use `*` to update all field paths.
+  //
+  // Currently supported field paths:
+  //
+  // - `role`
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
 // Request message for listing memberships.
 message ListMembershipsRequest {
   // Required. The resource name of the space for which to fetch a membership
