feat: Support app authentication with admin-consent scopes for Chat API ListMessages, GetMessage, GetSpaceEvent and ListSpaceEvents

docs: Update reference documentation for Chat API ListMessages, GetMessage, GetSpaceEvent and ListSpaceEvents.

PiperOrigin-RevId: 893619899

Author: Google APIs

google/chat/v1/chat_service.proto

@@ -52,9 +52,11 @@ service ChatService {
       "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.memberships.readonly,"
       "https://www.googleapis.com/auth/chat.app.messages.readonly,"
       "https://www.googleapis.com/auth/chat.app.spaces,"
       "https://www.googleapis.com/auth/chat.app.spaces.create,"
+      "https://www.googleapis.com/auth/chat.app.spaces.readonly,"
       "https://www.googleapis.com/auth/chat.bot,"
       "https://www.googleapis.com/auth/chat.customemojis,"
       "https://www.googleapis.com/auth/chat.customemojis.readonly,"
@@ -145,9 +147,8 @@ service ChatService {
   // - [App
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // with [administrator
-  // approval](https://support.google.com/a?p=chat-app-auth) in
-  // [Developer Preview](https://developers.google.com/workspace/preview)
-  //  with the authorization scope:
+  // approval](https://support.google.com/a?p=chat-app-auth)
+  // with the authorization scope:
   //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`. When
   //     using this authentication scope, this method only returns public
   //     messages in a space. It doesn't include private messages.
@@ -256,8 +257,7 @@ service ChatService {
   //     that invoke the Chat app.
   //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`
   //     with [administrator
-  //     approval](https://support.google.com/a?p=chat-app-auth) (available in
-  //     [Developer Preview](https://developers.google.com/workspace/preview)).
+  //     approval](https://support.google.com/a?p=chat-app-auth).
   //     When using this authentication scope,
   //     this method returns details about a public message in a space.
   //
@@ -1077,12 +1077,13 @@ service ChatService {
   // - [App
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // with [administrator
-  // approval](https://support.google.com/a?p=chat-app-auth) in
-  // [Developer Preview](https://developers.google.com/workspace/preview)
-  //  with one of the following authorization scopes:
+  // approval](https://support.google.com/a?p=chat-app-auth)
+  // with one of the following authorization scopes:
   //     - `https://www.googleapis.com/auth/chat.app.spaces`
+  //     - `https://www.googleapis.com/auth/chat.app.spaces.readonly`
   //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`
   //     - `https://www.googleapis.com/auth/chat.app.memberships`
+  //     - `https://www.googleapis.com/auth/chat.app.memberships.readonly`
   //
   // - [User
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
@@ -1126,12 +1127,13 @@ service ChatService {
   // - [App
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
   // with [administrator
-  // approval](https://support.google.com/a?p=chat-app-auth) in
-  // [Developer Preview](https://developers.google.com/workspace/preview)
-  //  with one of the following authorization scopes:
+  // approval](https://support.google.com/a?p=chat-app-auth)
+  // with one of the following authorization scopes:
   //     - `https://www.googleapis.com/auth/chat.app.spaces`
+  //     - `https://www.googleapis.com/auth/chat.app.spaces.readonly`
   //     - `https://www.googleapis.com/auth/chat.app.messages.readonly`
   //     - `https://www.googleapis.com/auth/chat.app.memberships`
+  //     - `https://www.googleapis.com/auth/chat.app.memberships.readonly`
   //
   // - [User
   // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)

google/chat/v1/chat_v1.yaml

@@ -135,8 +135,10 @@ authentication:
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/chat.app.memberships,
+        https://www.googleapis.com/auth/chat.app.memberships.readonly,
         https://www.googleapis.com/auth/chat.app.messages.readonly,
         https://www.googleapis.com/auth/chat.app.spaces,
+        https://www.googleapis.com/auth/chat.app.spaces.readonly,
         https://www.googleapis.com/auth/chat.memberships,
         https://www.googleapis.com/auth/chat.memberships.readonly,
         https://www.googleapis.com/auth/chat.messages,
@@ -202,8 +204,10 @@ authentication:
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/chat.app.memberships,
+        https://www.googleapis.com/auth/chat.app.memberships.readonly,
         https://www.googleapis.com/auth/chat.app.messages.readonly,
         https://www.googleapis.com/auth/chat.app.spaces,
+        https://www.googleapis.com/auth/chat.app.spaces.readonly,
         https://www.googleapis.com/auth/chat.memberships,
         https://www.googleapis.com/auth/chat.memberships.readonly,
         https://www.googleapis.com/auth/chat.messages,