feat: [chat] add ROLE_ASSISTANT_MANAGER to the MembershipRole enum in the Membership proto and assistant_managers_allowed to the PermissionSetting (#6843)

* feat: add ROLE_ASSISTANT_MANAGER to the MembershipRole enum in the Membership proto and assistant_managers_allowed to the PermissionSetting
docs: Update field documentations for space.proto and membership.proto

PiperOrigin-RevId: 823185429

Source-Link: googleapis/googleapis@98fef44

Source-Link: googleapis/googleapis-gen@1da7f77
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNoYXQvLk93bEJvdC55YW1sIiwiaCI6IjFkYTdmNzc2MmI2ODQ3ODQ1YzJkM2QyZjI0YThhMDczMGFhZDg3ZTEifQ==

* 🦉 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>

Author: gcf-owl-bot[bot]

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

@@ -39,7 +39,7 @@ message DeletionMetadata {
     // User deleted their own message.
     CREATOR = 1;
 
-    // A space manager deleted the message.
+    // An owner or manager deleted the message.
     SPACE_OWNER = 2;
 
     // A Google Workspace administrator deleted the message. Administrators can

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

@@ -66,16 +66,66 @@ message Membership {
     //  assigned this role (other enum values might be used in the future).
     MEMBERSHIP_ROLE_UNSPECIFIED = 0;
 
-    // A member of the space. The user has basic permissions, like sending
-    // messages to the space. In 1:1 and unnamed group conversations, everyone
+    // A member of the space. In the Chat UI, this role is called Member.
+    //
+    // The user has basic permissions, like sending
+    // messages to the space.
+    // Managers and owners can grant members additional permissions in a space,
+    // including:
+    //
+    // - Add or remove members.
+    // - Modify space details.
+    // - Turn history on or off.
+    // - Mention everyone in the space with `@all`.
+    // - Manage Chat apps and webhooks installed in the space.
+    //
+    // In direct messages and unnamed group conversations, everyone
     // has this role.
     ROLE_MEMBER = 1;
 
-    // A space manager. The user has all basic permissions plus administrative
-    // permissions that let them manage the space, like adding or removing
-    // members. Only supported in
-    // [SpaceType.SPACE][google.chat.v1.Space.SpaceType].
+    // A space owner. In the Chat UI, this role is called Owner.
+    //
+    // The user has the complete set of space permissions to manage the space,
+    // including:
+    //
+    // - Change the role of other members in the space to member, manager, or
+    // owner.
+    // - Delete the space.
+    //
+    // Only supported in
+    // [SpaceType.SPACE][google.chat.v1.Space.SpaceType] (named spaces).
+    //
+    // To learn more, see
+    // [Learn more about your role as a space
+    // owner or manager](https://support.google.com/chat/answer/11833441).
     ROLE_MANAGER = 2;
+
+    // A space manager. In the Chat UI, this role is called Manager.
+    //
+    // The user has all basic permissions of `ROLE_MEMBER`,
+    // and can be granted a subset of administrative permissions by an owner.
+    // By default, managers have all the permissions of an owner except for the
+    // ability to:
+    //
+    // - Delete the space.
+    // - Make another space member an owner.
+    // - Change an owner's role.
+    //
+    // By default, managers permissions include but aren't limited to:
+    //
+    // - Make another member a manager.
+    // - Delete messages in the space.
+    // - Manage space permissions.
+    // - Receive notifications for requests to join the space if the manager
+    //   has the "manage members" permission in the space settings.
+    // - Make a space discoverable.
+    //
+    // Only supported in
+    // [SpaceType.SPACE][google.chat.v1.Space.SpaceType] (named spaces).
+    //
+    // To learn more, see
+    // [Manage space settings](https://support.google.com/chat/answer/13340792).
+    ROLE_ASSISTANT_MANAGER = 4;
   }
 
   // Identifier. Resource name of the membership, assigned by the server.

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

@@ -232,10 +232,20 @@ message Space {
 
   // Represents a space permission setting.
   message PermissionSetting {
-    // Optional. Whether spaces managers have this permission.
+    // Optional. Whether space owners
+    // ([`ROLE_MANAGER`][google.chat.v1.Membership.MembershipRole.ROLE_MANAGER])
+    // have this permission.
     bool managers_allowed = 1 [(google.api.field_behavior) = OPTIONAL];
 
-    // Optional. Whether non-manager members have this permission.
+    // Optional. Whether space managers
+    // [`ROLE_ASSISTANT_MANAGER`][google.chat.v1.Membership.MembershipRole.ROLE_ASSISTANT_MANAGER])
+    // have this permission.
+    optional bool assistant_managers_allowed = 3
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Whether basic space members
+    // ([`ROLE_MEMBER`][google.chat.v1.Membership.MembershipRole.ROLE_MEMBER])
+    // have this permission.
     bool members_allowed = 2 [(google.api.field_behavior) = OPTIONAL];
   }