@google-apps/chat 0.2.0 → 0.3.0

package/build/protos/google/chat/v1/message.proto

@@ -61,14 +61,14 @@ message Message {
   // from the `clientAssignedMessageId` field. For example,
   // `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name
   // a
-  // message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).
+  // message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   string name = 1;
 
   // Output only. The user who created the message.
   // If your Chat app [authenticates as a
-  // user](https://developers.google.com/chat/api/guides/auth/users), the output
-  // populates the
-  // [user](https://developers.google.com/chat/api/reference/rest/v1/User)
+  // user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+  // the output populates the
+  // [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User)
   // `name` and `type`.
   User sender = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
@@ -96,13 +96,13 @@ message Message {
 
   // Plain-text body of the message. The first link to an image, video, or web
   // page generates a
-  // [preview chip](https://developers.google.com/chat/how-tos/preview-links).
+  // [preview chip](https://developers.google.com/workspace/chat/preview-links).
   // You can also [@mention a Google Chat
-  // user](https://developers.google.com/chat/format-messages#messages-@mention),
+  // user](https://developers.google.com/workspace/chat/format-messages#messages-@mention),
   // or everyone in the space.
   //
   // To learn about creating text messages, see [Send a text
-  // message](https://developers.google.com/chat/api/guides/v1/messages/create#create-text-messages).
+  // message](https://developers.google.com/workspace/chat/create-messages#create-text-messages).
   string text = 4;
 
   // Output only. Contains the message `text` with markups added to communicate
@@ -110,23 +110,24 @@ message Message {
   // but includes the following:
   //
   // * [Markup
-  //   syntax](https://developers.google.com/chat/format-messages)
-  //   for bold, italic, strikethrough, monospace, and monospace block.
+  // syntax](https://developers.google.com/workspace/chat/format-messages)
+  // for bold, italic, strikethrough, monospace, monospace block, and bulleted
+  // list.
   //
   // * [User
-  //   mentions](https://developers.google.com/chat/format-messages#messages-@mention)
-  //   using the format `<users/{user}>`.
+  // mentions](https://developers.google.com/workspace/chat/format-messages#messages-@mention)
+  // using the format `<users/{user}>`.
   //
   // * Custom hyperlinks using the format `<{url}|{rendered_text}>` where the
-  //   first string is the URL and the second is the rendered text—for example,
-  //   `<http://example.com|custom text>`.
+  // first string is the URL and the second is the rendered text—for example,
+  // `<http://example.com|custom text>`.
   //
   // * Custom emoji using the format `:{emoji_name}:`—for example, `:smile:`.
-  //   This doesn't apply to Unicode emoji, such as `U+1F600` for a grinning
+  // This doesn't apply to Unicode emoji, such as `U+1F600` for a grinning
   // face emoji.
   //
   // For more information, see [View text formatting sent in a
-  // message](https://developers.google.com/chat/format-messages#view_text_formatting_sent_in_a_message)
+  // message](https://developers.google.com/workspace/chat/format-messages#view_text_formatting_sent_in_a_message)
   string formatted_text = 43 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Deprecated: Use `cards_v2` instead.
@@ -138,15 +139,14 @@ message Message {
   repeated ContextualAddOnMarkup.Card cards = 5 [deprecated = true];
 
   // An array of
-  // [cards](https://developers.google.com/chat/api/reference/rest/v1/cards).
+  // [cards](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards).
   //
   // Only Chat apps can create cards. If your Chat app [authenticates as a
-  // user](https://developers.google.com/chat/api/guides/auth/users), the
-  // messages can't contain cards.
+  // user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+  // the messages can't contain cards.
   //
-  // To learn about cards and how to create them, see [Design dynamic,
-  // interactive, and consistent UIs with
-  // cards](https://developers.google.com/chat/ui).
+  // To learn about cards and how to create them, see [Send card
+  // messages](https://developers.google.com/workspace/chat/create-messages#create).
   //
   // [Card builder](https://addons.gsuite.google.com/uikit/builder)
   repeated CardWithId cards_v2 = 22;
@@ -157,13 +157,13 @@ message Message {
 
   // The thread the message belongs to. For example usage, see
   // [Start or reply to a message
-  // thread](https://developers.google.com/chat/api/guides/v1/messages/create#create-message-thread).
+  // thread](https://developers.google.com/workspace/chat/create-messages#create-message-thread).
   Thread thread = 11;
 
   // If your Chat app [authenticates as a
-  // user](https://developers.google.com/chat/api/guides/auth/users), the output
-  // populates the
-  // [space](https://developers.google.com/chat/api/reference/rest/v1/spaces)
+  // user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+  // the output populates the
+  // [space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces)
   // `name`.
   Space space = 12;
 
@@ -188,7 +188,7 @@ message Message {
 
   // Output only. A URL in `spaces.messages.text` that matches a link preview
   // pattern. For more information, see [Preview
-  // links](https://developers.google.com/chat/how-tos/preview-links).
+  // links](https://developers.google.com/workspace/chat/preview-links).
   MatchedUrl matched_url = 20 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. When `true`, the message is a response in a reply thread. When
@@ -202,9 +202,9 @@ message Message {
   // Optional. A custom ID for the message. You can use field to identify a
   // message, or to get, delete, or update a message. To set a custom ID,
   // specify the
-  // [`messageId`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id)
+  // [`messageId`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#body.QUERY_PARAMETERS.message_id)
   // field when you create the message. For details, see [Name a
-  // message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).
+  // message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   string client_assigned_message_id = 32;
 
   // Output only. The list of emoji reaction summaries on the message.
@@ -217,11 +217,12 @@ message Message {
   // attachments aren't supported for private messages.
   //
   // Only Chat apps can send private messages. If your Chat app [authenticates
-  // as a user](https://developers.google.com/chat/api/guides/auth/users) to
-  // send a message, the message can't be private and must omit this field.
+  // as a
+  // user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+  // to send a message, the message can't be private and must omit this field.
   //
   // For details, see [Send private messages to Google Chat
-  // users](https://developers.google.com/chat/api/guides/v1/messages/private).
+  // users](https://developers.google.com/workspace/chat/private-messages).
   User private_message_viewer = 36 [(google.api.field_behavior) = IMMUTABLE];
 
   // Output only. Information about a deleted message. A message is deleted when
@@ -240,67 +241,13 @@ message Message {
 
   // One or more interactive widgets that appear at the bottom of a message.
   // You can add accessory widgets to messages that contain text, cards, or both
-  // text and cards. Not supported for messages that contain dialogs.
+  // text and cards. Not supported for messages that contain dialogs. For
+  // details, see [Add interactive widgets at the bottom of a
+  // message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets).
   //
   // Creating a message with accessory widgets requires [app
   // authentication]
-  // (https://developers.google.com/chat/api/guides/auth/service-accounts).
-  //
-  // The following example shows a Chat app that uses accessory widgets (thumbs
-  // up and thumbs down buttons) in a text message:
-  //
-  // ![Example accessory widgets
-  // message](https://developers.google.com/chat/images/message-accessory-widgets-reference.png)
-  //
-  // The JSON for this example message is the following:
-  //
-  // ```
-  // {
-  //   "text": "Rate your experience with this Chat app.",
-  //   "accessoryWidgets": [
-  //     {
-  //       "buttonList": {
-  //         "buttons": [
-  //           {
-  //             "icon": {
-  //               "material_icon": {
-  //                 "name": "thumb_up"
-  //               }
-  //             },
-  //             "color": {
-  //               "red": 0,
-  //               "blue": 255,
-  //               "green": 0
-  //             },
-  //             "onClick": {
-  //               "action": {
-  //                 "function": "doUpvote",
-  //               }
-  //             }
-  //           },
-  //           {
-  //             "icon": {
-  //               "material_icon": {
-  //                 "name": "thumb_down"
-  //               }
-  //             },
-  //             "color": {
-  //               "red": 0,
-  //               "blue": 255,
-  //               "green": 0
-  //             },
-  //             "onClick": {
-  //               "action": {
-  //                 "function": "doDownvote",
-  //               }
-  //             }
-  //           }
-  //         ]
-  //       }
-  //     }
-  //   ]
-  // }
-  // ```
+  // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   repeated AccessoryWidget accessory_widgets = 44;
 }
 
@@ -333,10 +280,10 @@ message QuotedMessageMetadata {
 
 // A thread in a Google Chat space. For example usage, see
 // [Start or reply to a message
-// thread](https://developers.google.com/chat/api/guides/v1/messages/create#create-message-thread).
+// thread](https://developers.google.com/workspace/chat/create-messages#create-message-thread).
 //
 // If you specify a thread when creating a message, you can set the
-// [`messageReplyOption`](https://developers.google.com/chat/api/reference/rest/v1/spaces.messages/create#messagereplyoption)
+// [`messageReplyOption`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/create#messagereplyoption)
 // field to determine what happens if no matching thread is found.
 message Thread {
   option (google.api.resource) = {
@@ -383,7 +330,7 @@ message ActionResponse {
     REQUEST_CONFIG = 3;
 
     // Presents a
-    // [dialog](https://developers.google.com/chat/how-tos/dialogs).
+    // [dialog](https://developers.google.com/workspace/chat/dialogs).
     DIALOG = 4;
 
     // Widget text autocomplete options query.
@@ -399,6 +346,7 @@ message ActionResponse {
   // The response of the updated widget.
   // Used to provide autocomplete options for a widget.
   message UpdatedWidget {
+    // The widget updated in response to a user action.
     oneof updated_widget {
       // List of widget autocomplete results
       SelectionItems suggestions = 1;
@@ -417,7 +365,7 @@ message ActionResponse {
   string url = 2 [(google.api.field_behavior) = INPUT_ONLY];
 
   // Input only. A response to an interaction event related to a
-  // [dialog](https://developers.google.com/chat/how-tos/dialogs). Must be
+  // [dialog](https://developers.google.com/workspace/chat/dialogs). Must be
   // accompanied by `ResponseType.Dialog`.
   DialogAction dialog_action = 3 [(google.api.field_behavior) = INPUT_ONLY];
 
@@ -425,14 +373,18 @@ message ActionResponse {
   UpdatedWidget updated_widget = 4 [(google.api.field_behavior) = INPUT_ONLY];
 }
 
-// A borderless widget attached to the bottom of an app's message.
+// One or more interactive widgets that appear at the bottom of a message. For
+// details, see [Add interactive widgets at the bottom of a
+// message](https://developers.google.com/workspace/chat/create-messages#add-accessory-widgets).
 message AccessoryWidget {
+  // The type of action.
   oneof action {
-    // A list of buttons that are displayed under the message.
+    // A list of buttons.
     google.apps.card.v1.ButtonList button_list = 1;
   }
 }
 
+// Request to get a message.
 message GetMessageRequest {
   // Required. Resource name of the message.
   //
@@ -441,13 +393,14 @@ message GetMessageRequest {
   // If you've set a custom ID for your message, you can use the value from the
   // `clientAssignedMessageId` field for `{message}`. For details, see [Name a
   // message]
-  // (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).
+  // (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "chat.googleapis.com/Message" }
   ];
 }
 
+// Request to delete a message.
 message DeleteMessageRequest {
   // Required. Resource name of the message.
   //
@@ -456,7 +409,7 @@ message DeleteMessageRequest {
   // If you've set a custom ID for your message, you can use the value from the
   // `clientAssignedMessageId` field for `{message}`. For details, see [Name a
   // message]
-  // (https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).
+  // (https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "chat.googleapis.com/Message" }
@@ -466,12 +419,13 @@ message DeleteMessageRequest {
   // `false`, if a message has threaded replies, deletion fails.
   //
   // Only applies when [authenticating as a
-  // user](https://developers.google.com/chat/api/guides/auth/users). Has no
-  // effect when [authenticating as a Chat app]
-  // (https://developers.google.com/chat/api/guides/auth/service-accounts).
+  // user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+  // Has no effect when [authenticating as a Chat app]
+  // (https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
   bool force = 2;
 }
 
+// Request to update a message.
 message UpdateMessageRequest {
   // Required. Message with fields updated.
   Message message = 1 [(google.api.field_behavior) = REQUIRED];
@@ -497,7 +451,7 @@ message UpdateMessageRequest {
 
   // Optional. If `true` and the message isn't found, a new message is created
   // and `updateMask` is ignored. The specified message ID must be
-  // [client-assigned](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message)
+  // [client-assigned](https://developers.google.com/workspace/chat/create-messages#name_a_created_message)
   // or the request fails.
   bool allow_missing = 4 [(google.api.field_behavior) = OPTIONAL];
 }
@@ -545,7 +499,7 @@ message CreateMessageRequest {
   // a message and specify a `threadKey` or the
   // [thread.name][google.chat.v1.Thread.name]. For example usage, see [Start or
   // reply to a message
-  // thread](https://developers.google.com/chat/api/guides/v1/messages/create#create-message-thread).
+  // thread](https://developers.google.com/workspace/chat/create-messages#create-message-thread).
   string thread_key = 6
       [deprecated = true, (google.api.field_behavior) = OPTIONAL];
 
@@ -573,7 +527,7 @@ message CreateMessageRequest {
   // different messages.
   //
   // For details, see [Name a
-  // message](https://developers.google.com/chat/api/guides/v1/messages/create#name_a_created_message).
+  // message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
   string message_id = 9 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -594,8 +548,8 @@ message ListMessagesRequest {
   //
   // If unspecified, at most 25 are returned.
   //
-  // The maximum value is 1,000. If you use a value more than 1,000, it's
-  // automatically changed to 1,000.
+  // The maximum value is 1000. If you use a value more than 1000, it's
+  // automatically changed to 1000.
   //
   // Negative values return an `INVALID_ARGUMENT` error.
   int32 page_size = 2;
@@ -666,6 +620,7 @@ message ListMessagesRequest {
   bool show_deleted = 6;
 }
 
+// Response message for listing messages.
 message ListMessagesResponse {
   // List of messages.
   repeated Message messages = 1;
@@ -676,17 +631,19 @@ message ListMessagesResponse {
 }
 
 // Contains a
-// [dialog](https://developers.google.com/chat/how-tos/dialogs) and request
+// [dialog](https://developers.google.com/workspace/chat/dialogs) and request
 // status code.
 message DialogAction {
+  // Action to perform.
   oneof action {
-    // Input only. [Dialog](https://developers.google.com/chat/how-tos/dialogs)
-    // for the request.
+    // Input only.
+    // [Dialog](https://developers.google.com/workspace/chat/dialogs) for the
+    // request.
     Dialog dialog = 1 [(google.api.field_behavior) = INPUT_ONLY];
   }
 
   // Input only. Status for a request to either invoke or submit a
-  // [dialog](https://developers.google.com/chat/how-tos/dialogs). Displays
+  // [dialog](https://developers.google.com/workspace/chat/dialogs). Displays
   // a status and message to users, if necessary.
   // For example, in case of an error or success.
   ActionStatus action_status = 2 [(google.api.field_behavior) = INPUT_ONLY];
@@ -700,12 +657,13 @@ message Dialog {
   google.apps.card.v1.Card body = 1 [(google.api.field_behavior) = INPUT_ONLY];
 }
 
-// A [card](https://developers.google.com/chat/api/reference/rest/v1/cards) in a
-// Google Chat message.
+// A
+// [card](https://developers.google.com/workspace/chat/api/reference/rest/v1/cards)
+// in a Google Chat message.
 //
 // Only Chat apps can create cards. If your Chat app [authenticates as a
-// user](https://developers.google.com/chat/api/guides/auth/users), the message
-// can't contain cards.
+// user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+// the message can't contain cards.
 //
 // [Card builder](https://addons.gsuite.google.com/uikit/builder)
 message CardWithId {

package/build/protos/google/chat/v1/reaction.proto

@@ -49,6 +49,7 @@ message Reaction {
 
 // An emoji that is used as a reaction to a message.
 message Emoji {
+  // The content of the emoji.
   oneof content {
     // A basic emoji represented by a unicode string.
     string unicode = 1;
@@ -118,9 +119,9 @@ message ListReactionsRequest {
   // Optional. A query filter.
   //
   // You can filter reactions by
-  // [emoji](https://developers.google.com/chat/api/reference/rest/v1/Emoji)
+  // [emoji](https://developers.google.com/workspace/chat/api/reference/rest/v1/Emoji)
   // (either `emoji.unicode` or `emoji.custom_emoji.uid`) and
-  // [user](https://developers.google.com/chat/api/reference/rest/v1/User)
+  // [user](https://developers.google.com/workspace/chat/api/reference/rest/v1/User)
   // (`user.name`).
   //
   // To filter reactions for multiple emojis or users, join similar fields
@@ -162,6 +163,7 @@ message ListReactionsRequest {
   string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
+// Response to a list reactions request.
 message ListReactionsResponse {
   // List of reactions in the requested (or first) page.
   repeated Reaction reactions = 1;

package/build/protos/google/chat/v1/slash_command.proto

@@ -24,8 +24,9 @@ option java_package = "com.google.chat.v1";
 option php_namespace = "Google\\Apps\\Chat\\V1";
 option ruby_package = "Google::Apps::Chat::V1";
 
-// A [slash command](https://developers.google.com/chat/how-tos/slash-commands)
-// in Google Chat.
+// A [slash
+// command](https://developers.google.com/workspace/chat/slash-commands) in
+// Google Chat.
 message SlashCommand {
   // The ID of the slash command invoked.
   int64 command_id = 1;

package/build/protos/google/chat/v1/space.proto

@@ -40,6 +40,7 @@ message Space {
 
   // Deprecated: Use `SpaceType` instead.
   enum Type {
+    // Reserved.
     TYPE_UNSPECIFIED = 0;
 
     // Conversations between two or more humans.
@@ -124,7 +125,7 @@ message Space {
       [deprecated = true, (google.api.field_behavior) = OUTPUT_ONLY];
 
   // The space's display name. Required when [creating a
-  // space](https://developers.google.com/chat/api/reference/rest/v1/spaces/create).
+  // space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create).
   // If you receive the error message `ALREADY_EXISTS` when creating a space or
   // updating the `displayName`, try a different `displayName`. An
   // existing space within the Google Workspace organization might already use
@@ -139,13 +140,18 @@ message Space {
   // Input when creating a space in a Google Workspace organization. Omit this
   // field when creating spaces in the following conditions:
   //
-  //   * The authenticated user uses a Google Account. By default,
-  //     the space permits any Google Chat user.
+  //   * The authenticated user uses a consumer account (unmanaged user
+  //     account). By default, a space created by a consumer account permits any
+  //     Google Chat user.
   //
   //   * The space is used to [import data to Google Chat]
-  //     (https://developers.google.com/chat/api/guides/import-data-overview).
-  //     Import mode spaces must only permit members from the same Google
-  //     Workspace organization.
+  //     (https://developers.google.com/chat/api/guides/import-data-overview)
+  //     because import mode spaces must only permit members from the same
+  //     Google Workspace organization. However, as part of the [Google
+  //     Workspace Developer Preview
+  //     Program](https://developers.google.com/workspace/preview), import mode
+  //     spaces can permit any Google Chat user so this field can then be set
+  //     for import mode spaces.
   //
   // For existing spaces, this field is output only.
   bool external_user_allowed = 8 [(google.api.field_behavior) = IMMUTABLE];
@@ -188,6 +194,7 @@ message Space {
   bool admin_installed = 19 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
+// A request to create a named space.
 message CreateSpaceRequest {
   // Required. The `displayName` and `spaceType` fields must be populated.  Only
   // `SpaceType.SPACE` is supported.
@@ -216,8 +223,8 @@ message ListSpacesRequest {
   //
   // If unspecified, at most 100 spaces are returned.
   //
-  // The maximum value is 1,000. If you use a value more than 1,000, it's
-  // automatically changed to 1,000.
+  // The maximum value is 1000. If you use a value more than 1000, it's
+  // automatically changed to 1000.
   //
   // Negative values return an `INVALID_ARGUMENT` error.
   int32 page_size = 1 [(google.api.field_behavior) = OPTIONAL];
@@ -232,7 +239,7 @@ message ListSpacesRequest {
   // Optional. A query filter.
   //
   // You can filter spaces by the space type
-  // ([`space_type`](https://developers.google.com/chat/api/reference/rest/v1/spaces#spacetype)).
+  // ([`space_type`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces#spacetype)).
   //
   // To filter by space type, you must specify valid enum value, such as
   // `SPACE` or `GROUP_CHAT` (the `space_type` can't be
@@ -251,6 +258,7 @@ message ListSpacesRequest {
   string filter = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
+// The response for a list spaces request.
 message ListSpacesResponse {
   // List of spaces in the requested (or first) page.
   repeated Space spaces = 1;
@@ -282,8 +290,8 @@ message FindDirectMessageRequest {
   // in the Directory API. For example, if the People API profile ID is
   // `123456789`, you can find a direct message with that person by using
   // `users/123456789` as the `name`. When [authenticated as a
-  // user](https://developers.google.com/chat/api/guides/auth/users), you can
-  // use the email as an alias for `{user}`. For example,
+  // user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+  // you can use the email as an alias for `{user}`. For example,
   // `users/example@gmail.com` where `example@gmail.com` is the email of the
   // Google Chat user.
   string name = 1 [(google.api.field_behavior) = REQUIRED];
@@ -310,12 +318,13 @@ message UpdateSpaceRequest {
   // Google Workspace organization might already use this display name.)
   //
   // - `space_type` (Only supports changing a `GROUP_CHAT` space type to
-  // `SPACE`. Include `display_name` together with `space_type` in the update
-  // mask and ensure that the specified space has a non-empty display name and
-  // the `SPACE` space type. Including the `space_type` mask and the `SPACE`
-  // type in the specified space when updating the display name is optional if
-  // the existing space already has the `SPACE` type. Trying to update the
-  // space type in other ways results in an invalid argument error).
+  // `SPACE`. Include `display_name` together
+  // with `space_type` in the update mask and ensure that the specified space
+  // has a non-empty display name and the `SPACE` space type. Including the
+  // `space_type` mask and the `SPACE` type in the specified space when updating
+  // the display name is optional if the existing space already has the `SPACE`
+  // type. Trying to update the space type in other ways results in an invalid
+  // argument error).
   //
   // - `space_details`
   //
@@ -324,6 +333,7 @@ message UpdateSpaceRequest {
   // allows users to change their history
   // setting](https://support.google.com/a/answer/7664184).
   // Warning: mutually exclusive with all other field paths.)
+  //
   // - Developer Preview: `access_settings.audience` (Supports changing the
   // [access setting](https://support.google.com/chat/answer/11971020) of a
   // space. If no audience is specified in the access setting, the space's
@@ -354,6 +364,7 @@ message CompleteImportSpaceRequest {
   ];
 }
 
+// Response message for completing the import process for a space.
 message CompleteImportSpaceResponse {
   // The import mode space.
   Space space = 1;

package/build/protos/google/chat/v1/space_setup.proto

@@ -28,6 +28,7 @@ option java_package = "com.google.chat.v1";
 option php_namespace = "Google\\Apps\\Chat\\V1";
 option ruby_package = "Google::Apps::Chat::V1";
 
+// Request to create a space and add specified users to it.
 message SetUpSpaceRequest {
   // Required. The `Space.spaceType` field is required.
   //

package/build/protos/google/chat/v1/user.proto

@@ -29,8 +29,9 @@ option ruby_package = "Google::Apps::Chat::V1";
 
 // A user in Google Chat.
 // When returned as an output from a request, if your Chat app [authenticates as
-// a user](https://developers.google.com/chat/api/guides/auth/users), the output
-// for a `User` resource only populates the user's `name` and `type`.
+// a
+// user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+// the output for a `User` resource only populates the user's `name` and `type`.
 message User {
   enum Type {
     // Default value for the enum. DO NOT USE.

package/build/protos/google/chat/v1/widgets.proto

@@ -29,7 +29,7 @@ message WidgetMarkup {
   // A paragraph of text. Formatted text supported. For more information
   // about formatting text, see
   // [Formatting text in Google Chat
-  // apps](https://developers.google.com/chat/format-messages#card-formatting)
+  // apps](https://developers.google.com/workspace/chat/format-messages#card-formatting)
   // and
   // [Formatting
   // text in Google Workspace
@@ -139,7 +139,7 @@ message WidgetMarkup {
     // The text of the top label. Formatted text supported. For more information
     // about formatting text, see
     // [Formatting text in Google Chat
-    // apps](https://developers.google.com/chat/format-messages#card-formatting)
+    // apps](https://developers.google.com/workspace/chat/format-messages#card-formatting)
     // and
     // [Formatting
     // text in Google Workspace
@@ -150,7 +150,7 @@ message WidgetMarkup {
     // For more information
     // about formatting text, see
     // [Formatting text in Google Chat
-    // apps](https://developers.google.com/chat/format-messages#card-formatting)
+    // apps](https://developers.google.com/workspace/chat/format-messages#card-formatting)
     // and
     // [Formatting
     // text in Google Workspace
@@ -162,7 +162,7 @@ message WidgetMarkup {
 
     // The text of the bottom label. Formatted text supported. For more
     // information about formatting text, see [Formatting text in Google Chat
-    // apps](https://developers.google.com/chat/format-messages#card-formatting)
+    // apps](https://developers.google.com/workspace/chat/format-messages#card-formatting)
     // and
     // [Formatting
     // text in Google Workspace