feat: [google-apps-chat] Addition of app auth support for chat api (#14163)

BEGIN_COMMIT_OVERRIDE
feat: Addition of app auth support for chat api
docs: Update reference documentation for
createSpace,updateSpace,deleteSpace,createMembership,updateMembership,deleteMembership
and the newly added field -customer- in space.proto
END_COMMIT_OVERRIDE

- [ ] Regenerate this pull request now.

docs: Update reference documentation for
createSpace,updateSpace,deleteSpace,createMembership,updateMembership,deleteMembership
and the newly added field -customer- in space.proto

PiperOrigin-RevId: 788882030

Source-Link:
googleapis/googleapis@f6801ce

Source-Link:
googleapis/googleapis-gen@34024b5
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWFwcHMtY2hhdC8uT3dsQm90LnlhbWwiLCJoIjoiMzQwMjRiNTk0YzM3MTRlZDZhNDExODA1MDA3ZmM0ZDYyNDRlYTYzMiJ9

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-apps-chat/google/apps/chat/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.2.7"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-apps-chat/google/apps/chat_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.2.7"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-apps-chat/google/apps/chat_v1/services/chat_service/async_client.py

@@ -62,6 +62,10 @@ class ChatServiceTransport(abc.ABC):
         "https://www.googleapis.com/auth/chat.admin.memberships.readonly",
         "https://www.googleapis.com/auth/chat.admin.spaces",
         "https://www.googleapis.com/auth/chat.admin.spaces.readonly",
+        "https://www.googleapis.com/auth/chat.app.delete",
+        "https://www.googleapis.com/auth/chat.app.memberships",
+        "https://www.googleapis.com/auth/chat.app.spaces",
+        "https://www.googleapis.com/auth/chat.app.spaces.create",
         "https://www.googleapis.com/auth/chat.bot",
         "https://www.googleapis.com/auth/chat.customemojis",
         "https://www.googleapis.com/auth/chat.customemojis.readonly",

packages/google-apps-chat/google/apps/chat_v1/services/chat_service/client.py

@@ -37,30 +37,35 @@ class DeletionMetadata(proto.Message):
     """
 
     class DeletionType(proto.Enum):
-        r"""Who deleted the message and how it was deleted. More values
-        may be added in the future.
+        r"""Who deleted the message and how it was deleted. More values may be
+        added in the future. See `Edit or delete a message in Google
+        Chat <https://support.google.com/chat/answer/7653281>`__ for details
+        on when messages can be deleted.
 
         Values:
             DELETION_TYPE_UNSPECIFIED (0):
                 This value is unused.
             CREATOR (1):
                 User deleted their own message.
             SPACE_OWNER (2):
-                The space owner deleted the message.
+                A space manager deleted the message.
             ADMIN (3):
-                A Google Workspace admin deleted the message.
+                A Google Workspace administrator deleted the
+                message. Administrators can delete any message
+                in the space, including messages sent by any
+                space member or Chat app.
             APP_MESSAGE_EXPIRY (4):
                 A Chat app deleted its own message when it
                 expired.
             CREATOR_VIA_APP (5):
                 A Chat app deleted the message on behalf of
-                the user.
+                the creator (using user authentication).
             SPACE_OWNER_VIA_APP (6):
-                A Chat app deleted the message on behalf of
-                the space owner.
+                A Chat app deleted the message on behalf of a
+                space manager (using user authentication).
             SPACE_MEMBER (7):
                 A member of the space deleted the message.
-                Human users can delete messages sent by apps.
+                Users can delete messages sent by apps.
         """
         DELETION_TYPE_UNSPECIFIED = 0
         CREATOR = 1

packages/google-apps-chat/google/apps/chat_v1/services/chat_service/transports/base.py

@@ -210,9 +210,7 @@ class CreateMembershipRequest(proto.Message):
             -  When `authenticating as an
                app <https://developers.google.com/workspace/chat/authenticate-authorize-chat-app>`__,
                the ``chat.app.memberships`` authorization scope is
-               required. Authenticating as an app is available in
-               `Developer
-               Preview <https://developers.google.com/workspace/preview>`__.
+               required.
 
             -  Set ``user.type`` to ``HUMAN``, and set ``user.name``
                with format ``users/{user}``, where ``{user}`` can be the
@@ -527,9 +525,12 @@ class DeleteMembershipRequest(proto.Message):
             apps can't delete other apps' memberships.
 
             When deleting a human membership, requires the
-            ``chat.memberships`` scope and
-            ``spaces/{space}/members/{member}`` format. You can use the
-            email as an alias for ``{member}``. For example,
+            ``chat.memberships`` scope with `user
+            authentication <https://developers.google.com/workspace/chat/authenticate-authorize-chat-user>`__
+            or the ``chat.memberships.app`` scope with `app
+            authentication <https://developers.google.com/workspace/chat/authenticate-authorize-chat-app>`__
+            and the ``spaces/{space}/members/{member}`` format. You can
+            use the email as an alias for ``{member}``. For example,
             ``spaces/{space}/members/[email protected]`` where
             ``[email protected]`` is the email of the Google Chat user.
 

packages/google-apps-chat/google/apps/chat_v1/services/chat_service/transports/grpc.py

@@ -28,13 +28,13 @@
 
 
 class SlashCommand(proto.Message):
-    r"""A `slash
+    r"""Metadata about a `slash
     command <https://developers.google.com/workspace/chat/commands>`__
     in Google Chat.
 
     Attributes:
         command_id (int):
-            The ID of the slash command invoked.
+            The ID of the slash command.
     """
 
     command_id: int = proto.Field(