@oomol-lab/open-connector 1.6.5 → 1.7.0

package/assets/open-connector/catalog/apps/googlechat.json

@@ -1,7 +1,7 @@
 {
   "service": "googlechat",
   "displayName": "Google Chat",
-  "description": "Read Google Chat spaces and message history as the authenticated Google Workspace user.",
+  "description": "Read Google Chat spaces and message history, name members and message senders through the Workspace directory, and send plain-text messages, as the authenticated Google Workspace user. Sending and naming require an OAuth user connection: service account connections only read spaces and messages.",
   "categories": [
     "Communication",
     "Productivity"
@@ -20,7 +20,10 @@
         "https://www.googleapis.com/auth/chat.messages.readonly",
         "openid",
         "email",
-        "profile"
+        "profile",
+        "https://www.googleapis.com/auth/chat.messages.create",
+        "https://www.googleapis.com/auth/chat.memberships.readonly",
+        "https://www.googleapis.com/auth/directory.readonly"
       ],
       "tokenEndpointAuthMethod": "client_secret_post",
       "authorizationParams": {
@@ -49,18 +52,513 @@
           "required": true,
           "secret": false,
           "placeholder": "user@your-domain.com",
-          "description": "Workspace user to impersonate through domain-wide delegation. In the Workspace Admin console (Security > Access and data control > API Controls > Domain-wide Delegation), grant the service account client ID the Chat scopes this provider requests."
+          "description": "Workspace user to impersonate through domain-wide delegation. In the Workspace Admin console (Security > Access and data control > API Controls > Domain-wide Delegation), grant the service account client ID https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.messages.readonly, openid, email, and profile. Service account connections only read spaces and messages; sending messages and naming members need an OAuth connection."
         }
       ]
     }
   ],
   "homepageUrl": "https://workspace.google.com/products/chat/",
   "actions": [
+    {
+      "id": "googlechat.create_message",
+      "service": "googlechat",
+      "name": "create_message",
+      "description": "Send a plain-text message to a Google Chat space, optionally as a reply inside an existing thread. Under user authentication the Chat API only accepts plain text, so cards and attachments are not supported. When thread is provided but messageReplyOption is omitted, this action sends REPLY_MESSAGE_OR_FAIL rather than the Google default, which would silently ignore the thread and start a new one. messageReplyOption only applies to named spaces (spaceType=SPACE). Reusing a requestId returns the message that was already created instead of sending a new one.",
+      "operationType": "write",
+      "requiredScopes": [
+        "https://www.googleapis.com/auth/chat.messages.create"
+      ],
+      "providerPermissions": [
+        "https://www.googleapis.com/auth/chat.messages.create"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "space": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The space to post into, either spaces/{space} or the bare {space} ID."
+          },
+          "text": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The plain-text body of the message. Leading and trailing whitespace is preserved, so indentation inside the message survives.",
+            "pattern": "\\S"
+          },
+          "thread": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The thread to reply into, as the full spaces/{space}/threads/{thread} name. Its space must match the space input.",
+            "pattern": "\\S"
+          },
+          "messageReplyOption": {
+            "type": "string",
+            "enum": [
+              "REPLY_MESSAGE_OR_FAIL",
+              "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD"
+            ],
+            "description": "How to handle the target thread. Only allowed together with thread; defaults to REPLY_MESSAGE_OR_FAIL when thread is set."
+          },
+          "requestId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "An idempotency key. Only reuse it to retry the same intended message: reusing it with different content returns the original message instead of sending or updating anything.",
+            "pattern": "\\S"
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "space",
+          "text"
+        ],
+        "description": "Action input.",
+        "dependentRequired": {
+          "messageReplyOption": [
+            "thread"
+          ]
+        }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "The resource name of the message, in the form spaces/{space}/messages/{message}."
+          },
+          "messageId": {
+            "type": "string",
+            "description": "The bare message ID with the spaces/{space}/messages/ prefix removed."
+          },
+          "spaceName": {
+            "type": "string",
+            "description": "The resource name of the space that owns the message."
+          },
+          "text": {
+            "type": "string",
+            "description": "The plain-text body of the message."
+          },
+          "formattedText": {
+            "type": "string",
+            "description": "The message body with Google Chat formatting markup preserved."
+          },
+          "argumentText": {
+            "type": "string",
+            "description": "The plain-text body with all Chat app mentions stripped out."
+          },
+          "createTime": {
+            "type": "string",
+            "description": "The time the message was created."
+          },
+          "lastUpdateTime": {
+            "type": "string",
+            "description": "The time the message was last edited by a user."
+          },
+          "deleteTime": {
+            "type": "string",
+            "description": "The time the message was deleted, when it has been deleted."
+          },
+          "threadReply": {
+            "type": "boolean",
+            "description": "Whether the message is a reply inside an existing thread."
+          },
+          "sender": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "The resource name of the sender, in the form users/{user}."
+              },
+              "displayName": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "description": "The sender's name. Under user authentication Google Chat only reports it for members of the space and users with prior affinity, so a human sender's missing name is filled in from the Workspace directory; null when neither reveals it, with profileUnavailableReason saying why. Bots are never looked up in the directory."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "email": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "description": "The human sender's email address as Google Chat reports it, or the primary one from the Workspace directory, when visible."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "profileUnavailableReason": {
+                "type": "string",
+                "enum": [
+                  "profile_name_missing",
+                  "people_forbidden",
+                  "people_not_found",
+                  "people_request_failed"
+                ],
+                "description": "Why displayName is null for a human sender: profile_name_missing, people_forbidden, people_not_found, or people_request_failed. Names need the directory.readonly scope and the People API."
+              },
+              "type": {
+                "type": "string",
+                "description": "The sender type, either HUMAN or BOT."
+              },
+              "domainId": {
+                "type": "string",
+                "description": "The Google Workspace domain ID of the sender."
+              },
+              "isAnonymous": {
+                "type": "boolean",
+                "description": "Whether the sender is an anonymous user."
+              }
+            },
+            "additionalProperties": false,
+            "description": "The user who created the message."
+          },
+          "thread": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "The resource name of the thread, in the form spaces/{space}/threads/{thread}."
+              },
+              "threadKey": {
+                "type": "string",
+                "description": "The client-assigned ID for the thread."
+              }
+            },
+            "additionalProperties": false,
+            "description": "The thread the message belongs to."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "messageId"
+        ],
+        "description": "A normalized Google Chat message."
+      }
+    },
+    {
+      "id": "googlechat.find_direct_message",
+      "service": "googlechat",
+      "name": "find_direct_message",
+      "description": "Find the existing direct message space between the authenticated user and one other user, identified by email address or numeric user id. Use this to address a person by identity instead of by an opaque space id: a direct message space has no displayName, so list_spaces can never tell you who a DM is with. Only finds conversations that already exist; it never creates one. Caution when the result is fed to create_message: if the identifier is mistyped but still resolves to another real user this account already has a DM with, this action succeeds and returns that person's space, and the returned space id is opaque, so it cannot be eyeballed to confirm the recipient. The result therefore carries peer, the person the space actually belongs to, named by Google Chat or the Workspace directory: read it back to the user and confirm the name before sending. Nothing enforces that check. Naming the peer needs the chat.memberships.readonly and directory.readonly scopes plus the People API on top of the scope below. When the peer cannot be resolved at all (listing the members or reading your own People id failed), peer is null and peerError says why, while the space itself is still returned. A resolved peer can still be unnamed: displayName is null for an AMBIGUOUS peer, for a BOT or SELF peer Google Chat did not name, and for a HUMAN peer the directory could not name (profileUnavailableReason then says why). Treat a null peer or a null displayName as an unconfirmed recipient.",
+      "operationType": "read",
+      "requiredScopes": [
+        "https://www.googleapis.com/auth/chat.spaces.readonly"
+      ],
+      "providerPermissions": [
+        "https://www.googleapis.com/auth/chat.spaces.readonly"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "user": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The other participant, as a bare email address such as person@example.com or a bare numeric user id. Do not include the users/ prefix, and aliases such as me or app are not accepted."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "user"
+        ],
+        "description": "Action input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "The resource name of the space, in the form spaces/{space}."
+          },
+          "spaceId": {
+            "type": "string",
+            "description": "The bare space ID with the spaces/ prefix removed."
+          },
+          "displayName": {
+            "type": "string",
+            "description": "The display name of the space. Empty for direct messages."
+          },
+          "spaceType": {
+            "type": "string",
+            "description": "The space type, such as SPACE, GROUP_CHAT, or DIRECT_MESSAGE."
+          },
+          "spaceHistoryState": {
+            "type": "string",
+            "description": "Whether message history is turned on or off for the space."
+          },
+          "externalUserAllowed": {
+            "type": "boolean",
+            "description": "Whether the space allows users outside the Google Workspace organization."
+          },
+          "spaceUri": {
+            "type": "string",
+            "description": "The URI that opens the space in the Google Chat client."
+          },
+          "createTime": {
+            "type": "string",
+            "description": "The time the space was created."
+          },
+          "lastActiveTime": {
+            "type": "string",
+            "description": "The time of the most recent message in the space."
+          },
+          "spaceDetails": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Space description and guidelines shown to members."
+          },
+          "membershipCount": {
+            "type": "object",
+            "properties": {
+              "joinedDirectHumanUserCount": {
+                "type": "integer",
+                "description": "The number of human users that have directly joined the space."
+              },
+              "joinedGroupCount": {
+                "type": "integer",
+                "description": "The number of groups that have directly joined the space."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Counts of members that have directly joined the space."
+          },
+          "peer": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "kind": {
+                    "type": "string",
+                    "enum": [
+                      "HUMAN",
+                      "BOT",
+                      "SELF",
+                      "AMBIGUOUS"
+                    ],
+                    "description": "HUMAN for another person, BOT for a Chat app, SELF for a direct message with only yourself, AMBIGUOUS when the members do not single out one peer."
+                  },
+                  "user": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "description": "The peer's resource name, in the form users/{user}. Null when the peer is AMBIGUOUS."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "displayName": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "description": "The peer's name as Google Chat reports it, or, for a HUMAN peer, from the Workspace directory when Chat leaves it out. Null for AMBIGUOUS, or when neither reveals it; for a HUMAN peer profileUnavailableReason then says why. BOT and SELF peers are never looked up in the directory."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "email": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "description": "The peer's email address as Google Chat reports it, or, for a HUMAN peer, the primary one from the Workspace directory, when visible. Null for AMBIGUOUS."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "profileUnavailableReason": {
+                    "type": "string",
+                    "enum": [
+                      "profile_name_missing",
+                      "people_forbidden",
+                      "people_not_found",
+                      "people_request_failed"
+                    ],
+                    "description": "Why displayName is null for a HUMAN peer: profile_name_missing when the directory returned no name (profile sharing may be off), people_forbidden or people_not_found for a 403 or 404 from the People API, people_request_failed for any other failure."
+                  },
+                  "candidates": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "description": "For an AMBIGUOUS peer, the users/{user} names of the members that could be the peer."
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "kind",
+                  "user",
+                  "displayName",
+                  "email"
+                ],
+                "description": "The other participant of a direct message, named by Google Chat or, where Chat leaves the name out, through the Workspace directory."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "peerError": {
+            "type": "object",
+            "properties": {
+              "status": {
+                "type": "integer",
+                "description": "The HTTP status of the failed lookup, or 502 when it failed without one, such as a network error."
+              },
+              "message": {
+                "type": "string",
+                "description": "What went wrong."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Why peer is null. Absent when the peer was resolved."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "spaceId",
+          "peer"
+        ],
+        "description": "The direct message space, with its other participant."
+      }
+    },
+    {
+      "id": "googlechat.get_direct_message_peer",
+      "service": "googlechat",
+      "name": "get_direct_message_peer",
+      "description": "Name the other participant of a direct message space. Under user authentication Google Chat may report a member only as users/{id}, so a name or email Chat leaves out is looked up in the Workspace directory through the People API. Use it to tell who a direct message from list_spaces is with. Rejects spaces that are not direct messages. A HUMAN peer that cannot be named still comes back with its users/{id} and a profileUnavailableReason; BOT and SELF peers carry only what Google Chat reports, and an AMBIGUOUS peer has a null user and lists its candidates.",
+      "operationType": "read",
+      "requiredScopes": [
+        "https://www.googleapis.com/auth/chat.spaces.readonly",
+        "https://www.googleapis.com/auth/chat.memberships.readonly",
+        "https://www.googleapis.com/auth/directory.readonly"
+      ],
+      "providerPermissions": [
+        "https://www.googleapis.com/auth/chat.spaces.readonly",
+        "https://www.googleapis.com/auth/chat.memberships.readonly",
+        "https://www.googleapis.com/auth/directory.readonly"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "space": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The direct message space, either spaces/{space} or the bare {space} ID."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "space"
+        ],
+        "description": "Action input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "space": {
+            "type": "string",
+            "description": "The resource name of the space, in the form spaces/{space}."
+          },
+          "peer": {
+            "type": "object",
+            "properties": {
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "HUMAN",
+                  "BOT",
+                  "SELF",
+                  "AMBIGUOUS"
+                ],
+                "description": "HUMAN for another person, BOT for a Chat app, SELF for a direct message with only yourself, AMBIGUOUS when the members do not single out one peer."
+              },
+              "user": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "description": "The peer's resource name, in the form users/{user}. Null when the peer is AMBIGUOUS."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "displayName": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "description": "The peer's name as Google Chat reports it, or, for a HUMAN peer, from the Workspace directory when Chat leaves it out. Null for AMBIGUOUS, or when neither reveals it; for a HUMAN peer profileUnavailableReason then says why. BOT and SELF peers are never looked up in the directory."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "email": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "description": "The peer's email address as Google Chat reports it, or, for a HUMAN peer, the primary one from the Workspace directory, when visible. Null for AMBIGUOUS."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "profileUnavailableReason": {
+                "type": "string",
+                "enum": [
+                  "profile_name_missing",
+                  "people_forbidden",
+                  "people_not_found",
+                  "people_request_failed"
+                ],
+                "description": "Why displayName is null for a HUMAN peer: profile_name_missing when the directory returned no name (profile sharing may be off), people_forbidden or people_not_found for a 403 or 404 from the People API, people_request_failed for any other failure."
+              },
+              "candidates": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "description": "For an AMBIGUOUS peer, the users/{user} names of the members that could be the peer."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "kind",
+              "user",
+              "displayName",
+              "email"
+            ],
+            "description": "The other participant of a direct message, named by Google Chat or, where Chat leaves the name out, through the Workspace directory."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "space",
+          "peer"
+        ],
+        "description": "The direct message space and its other participant."
+      }
+    },
     {
       "id": "googlechat.get_message",
       "service": "googlechat",
       "name": "get_message",
-      "description": "Retrieve a single Google Chat message by its resource name, or by space and message ID.",
+      "description": "Retrieve a single Google Chat message by its resource name, or by space and message ID. A name or email Google Chat leaves out for a human sender is filled in from the Workspace directory, which needs the directory.readonly scope and the People API on top of the scope below; without them the sender keeps its users/{id} with a null displayName and a profileUnavailableReason, and the message is still returned.",
       "operationType": "read",
       "requiredScopes": [
         "https://www.googleapis.com/auth/chat.messages.readonly"
@@ -139,8 +637,36 @@
                 "description": "The resource name of the sender, in the form users/{user}."
               },
               "displayName": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "description": "The sender's name. Under user authentication Google Chat only reports it for members of the space and users with prior affinity, so a human sender's missing name is filled in from the Workspace directory; null when neither reveals it, with profileUnavailableReason saying why. Bots are never looked up in the directory."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "email": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "description": "The human sender's email address as Google Chat reports it, or the primary one from the Workspace directory, when visible."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "profileUnavailableReason": {
                 "type": "string",
-                "description": "The display name of the sender. Only populated for app authentication."
+                "enum": [
+                  "profile_name_missing",
+                  "people_forbidden",
+                  "people_not_found",
+                  "people_request_failed"
+                ],
+                "description": "Why displayName is null for a human sender: profile_name_missing, people_forbidden, people_not_found, or people_request_failed. Names need the directory.readonly scope and the People API."
               },
               "type": {
                 "type": "string",
@@ -282,7 +808,7 @@
       "id": "googlechat.list_messages",
       "service": "googlechat",
       "name": "list_messages",
-      "description": "List the message history of a Google Chat space, with optional filtering, ordering, and pagination.",
+      "description": "List the message history of a Google Chat space, with optional filtering, ordering, and pagination. A name or email Google Chat leaves out for a human sender is filled in from the Workspace directory, which needs the directory.readonly scope and the People API on top of the scope below; without them such a sender keeps its users/{id} with a null displayName and a profileUnavailableReason, and the messages are still returned.",
       "operationType": "read",
       "requiredScopes": [
         "https://www.googleapis.com/auth/chat.messages.readonly"
@@ -386,8 +912,36 @@
                       "description": "The resource name of the sender, in the form users/{user}."
                     },
                     "displayName": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "The sender's name. Under user authentication Google Chat only reports it for members of the space and users with prior affinity, so a human sender's missing name is filled in from the Workspace directory; null when neither reveals it, with profileUnavailableReason saying why. Bots are never looked up in the directory."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "email": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "The human sender's email address as Google Chat reports it, or the primary one from the Workspace directory, when visible."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "profileUnavailableReason": {
                       "type": "string",
-                      "description": "The display name of the sender. Only populated for app authentication."
+                      "enum": [
+                        "profile_name_missing",
+                        "people_forbidden",
+                        "people_not_found",
+                        "people_request_failed"
+                      ],
+                      "description": "Why displayName is null for a human sender: profile_name_missing, people_forbidden, people_not_found, or people_request_failed. Names need the directory.readonly scope and the People API."
                     },
                     "type": {
                       "type": "string",
@@ -450,6 +1004,139 @@
         "description": "The normalized result of listing space messages."
       }
     },
+    {
+      "id": "googlechat.list_space_members",
+      "service": "googlechat",
+      "name": "list_space_members",
+      "description": "List the members of any Google Chat space, including group spaces, with each person's name and email. Like Google Chat's default, it leaves out memberships held through a Google Group and people who were invited but have not joined. Under user authentication Google Chat may report a member only as users/{id}, so every human on a page whose name or email Chat leaves out is looked up in the Workspace directory through the People API in one batch. Returns one page at a time; pass nextPageToken back as pageToken for the next page. Members whose profile cannot be read keep their users/{id} with a null displayName and a profileUnavailableReason.",
+      "operationType": "read",
+      "requiredScopes": [
+        "https://www.googleapis.com/auth/chat.memberships.readonly",
+        "https://www.googleapis.com/auth/directory.readonly"
+      ],
+      "providerPermissions": [
+        "https://www.googleapis.com/auth/chat.memberships.readonly",
+        "https://www.googleapis.com/auth/directory.readonly"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "space": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The space whose members to list, either spaces/{space} or the bare {space} ID."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 200,
+            "description": "The maximum number of members to return, at most 200 so that one directory lookup covers the page. Defaults to 100."
+          },
+          "pageToken": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The nextPageToken from a previous call, to fetch the next page."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "space"
+        ],
+        "description": "Action input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "space": {
+            "type": "string",
+            "description": "The resource name of the space, in the form spaces/{space}."
+          },
+          "members": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "user": {
+                  "type": "string",
+                  "description": "The member's resource name, in the form users/{user}."
+                },
+                "kind": {
+                  "type": "string",
+                  "description": "HUMAN for a person, BOT for a Chat app."
+                },
+                "role": {
+                  "type": "string",
+                  "description": "The member's role in the space, such as ROLE_MEMBER or ROLE_MANAGER."
+                },
+                "isSelf": {
+                  "type": "boolean",
+                  "description": "Whether this member is the authenticated user."
+                },
+                "displayName": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The member's name as Google Chat reports it, or for a human member from the Workspace directory when Chat leaves it out. Null when neither reveals it; for a human member profileUnavailableReason then says why. Bots are never looked up in the directory."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "email": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "The member's email address as Google Chat reports it, or for a human member the primary one from the Workspace directory, when visible."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "profileUnavailableReason": {
+                  "type": "string",
+                  "enum": [
+                    "profile_name_missing",
+                    "people_forbidden",
+                    "people_not_found",
+                    "people_request_failed"
+                  ],
+                  "description": "Why displayName is null for a human member: profile_name_missing when the directory returned no name (profile sharing may be off), people_forbidden or people_not_found when the People API refused or could not find the profile, people_request_failed for any other failure."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "user",
+                "isSelf",
+                "displayName",
+                "email"
+              ],
+              "description": "A member of a Google Chat space, named by Google Chat or, where Chat leaves the name out, through the Workspace directory."
+            },
+            "description": "The members on this page, in the order Google Chat returned them."
+          },
+          "nextPageToken": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The token for the next page, or null when this is the last page."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "space",
+          "members",
+          "nextPageToken"
+        ],
+        "description": "One page of the space's members."
+      }
+    },
     {
       "id": "googlechat.list_spaces",
       "service": "googlechat",