@google-apps/chat 0.1.0 → 0.3.0

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

@@ -16,13 +16,13 @@ syntax = "proto3";
 
 package google.chat.v1;
 
-option csharp_namespace = "Google.Chat.V1";
+option csharp_namespace = "Google.Apps.Chat.V1";
 option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "DeletionMetadataProto";
 option java_package = "com.google.chat.v1";
-option php_namespace = "Google\\Chat\\V1";
-option ruby_package = "Google::Chat::V1";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
 
 // Information about a deleted message. A message is deleted when `delete_time`
 // is set.

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

@@ -16,13 +16,13 @@ syntax = "proto3";
 
 package google.chat.v1;
 
-option csharp_namespace = "Google.Chat.V1";
+option csharp_namespace = "Google.Apps.Chat.V1";
 option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "GroupProto";
 option java_package = "com.google.chat.v1";
-option php_namespace = "Google\\Chat\\V1";
-option ruby_package = "Google::Chat::V1";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
 
 // A Google Group in Google Chat.
 message Group {

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

@@ -16,13 +16,13 @@ syntax = "proto3";
 
 package google.chat.v1;
 
-option csharp_namespace = "Google.Chat.V1";
+option csharp_namespace = "Google.Apps.Chat.V1";
 option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "HistoryStateProto";
 option java_package = "com.google.chat.v1";
-option php_namespace = "Google\\Chat\\V1";
-option ruby_package = "Google::Chat::V1";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
 
 // The history state for messages and spaces. Specifies how long messages and
 // conversation threads are kept after creation.

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

@@ -18,13 +18,13 @@ package google.chat.v1;
 
 import "google/api/field_behavior.proto";
 
-option csharp_namespace = "Google.Chat.V1";
+option csharp_namespace = "Google.Apps.Chat.V1";
 option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "MatchedUrlProto";
 option java_package = "com.google.chat.v1";
-option php_namespace = "Google\\Chat\\V1";
-option ruby_package = "Google::Chat::V1";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
 
 // A matched URL in a Chat message. Chat apps can preview matched URLs. For more
 // information, see [Preview

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

@@ -20,15 +20,16 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/chat/v1/group.proto";
 import "google/chat/v1/user.proto";
+import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
-option csharp_namespace = "Google.Chat.V1";
+option csharp_namespace = "Google.Apps.Chat.V1";
 option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "MembershipProto";
 option java_package = "com.google.chat.v1";
-option php_namespace = "Google\\Chat\\V1";
-option ruby_package = "Google::Chat::V1";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
 
 // Represents a membership relation in Google Chat, such as whether a user or
 // Chat app is invited to, part of, or absent from a space.
@@ -89,7 +90,6 @@ message Membership {
   // Optional. User's role within a Chat space, which determines their permitted
   // actions in the space.
   //
-  // [Developer Preview](https://developers.google.com/workspace/preview):
   // This field can only be used as input in `UpdateMembership`.
   MembershipRole role = 7 [(google.api.field_behavior) = OPTIONAL];
 
@@ -98,9 +98,9 @@ message Membership {
   oneof memberType {
     // The Google Chat user or app the membership corresponds to.
     // 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 member = 3;
 
@@ -127,6 +127,7 @@ message Membership {
   ];
 }
 
+// Request message for creating a membership.
 message CreateMembershipRequest {
   // Required. The resource name of the space for which to create the
   // membership.
@@ -158,6 +159,23 @@ message CreateMembershipRequest {
   Membership membership = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
+// Request message for updating a membership.
+message UpdateMembershipRequest {
+  // Required. The membership to update. Only fields specified by `update_mask`
+  // are updated.
+  Membership membership = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The field paths to update. Separate multiple values with commas
+  // or use `*` to update all field paths.
+  //
+  // Currently supported field paths:
+  //
+  // - `role`
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for listing memberships.
 message ListMembershipsRequest {
   // Required. The resource name of the space for which to fetch a membership
   // list.
@@ -175,8 +193,8 @@ message ListMembershipsRequest {
   //
   // If unspecified, at most 100 memberships 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 [(google.api.field_behavior) = OPTIONAL];
@@ -192,9 +210,9 @@ message ListMembershipsRequest {
   // Optional. A query filter.
   //
   // You can filter memberships by a member's role
-  // ([`role`](https://developers.google.com/chat/api/reference/rest/v1/spaces.members#membershiprole))
+  // ([`role`](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.members#membershiprole))
   // and type
-  // ([`member.type`](https://developers.google.com/chat/api/reference/rest/v1/User#type)).
+  // ([`member.type`](https://developers.google.com/workspace/chat/api/reference/rest/v1/User#type)).
   //
   // To filter by role, set `role` to `ROLE_MEMBER` or `ROLE_MANAGER`.
   //
@@ -217,6 +235,7 @@ message ListMembershipsRequest {
   // role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"
   // ```
   //
+  //
   // Invalid queries are rejected by the server with an `INVALID_ARGUMENT`
   // error.
   string filter = 5 [(google.api.field_behavior) = OPTIONAL];
@@ -237,10 +256,11 @@ message ListMembershipsRequest {
   // that don't match the filter criteria aren't returned.
   //
   // Currently requires [user
-  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   bool show_invited = 7 [(google.api.field_behavior) = OPTIONAL];
 }
 
+// Response to list memberships of the space.
 message ListMembershipsResponse {
   // Unordered list. List of memberships in the requested (or first) page.
   repeated Membership memberships = 1
@@ -251,6 +271,7 @@ message ListMembershipsResponse {
   string next_page_token = 2;
 }
 
+// Request to get a membership of a space.
 message GetMembershipRequest {
   // Required. Resource name of the membership to retrieve.
   //
@@ -260,8 +281,8 @@ message GetMembershipRequest {
   // Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app`
   //
   // When [authenticated as a
-  // user](https://developers.google.com/chat/api/guides/auth/users), you can
-  // use the user's email as an alias for `{member}`. For example,
+  // user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user),
+  // you can use the user's email as an alias for `{member}`. For example,
   // `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the
   // email of the Google Chat user.
   string name = 1 [
@@ -270,6 +291,7 @@ message GetMembershipRequest {
   ];
 }
 
+// Request to delete a membership in a space.
 message DeleteMembershipRequest {
   // Required. Resource name of the membership to delete. Chat apps can delete
   // human users' or their own memberships. Chat apps can't delete other apps'

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

@@ -32,13 +32,13 @@ import "google/chat/v1/user.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
-option csharp_namespace = "Google.Chat.V1";
+option csharp_namespace = "Google.Apps.Chat.V1";
 option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "MessageProto";
 option java_package = "com.google.chat.v1";
-option php_namespace = "Google\\Chat\\V1";
-option ruby_package = "Google::Chat::V1";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
 
 // A message in a Google Chat space.
 message Message {
@@ -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
@@ -237,6 +238,17 @@ message Message {
   // Output only. GIF images that are attached to the message.
   repeated AttachedGif attached_gifs = 42
       [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // 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. 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/workspace/chat/authenticate-authorize-chat-app).
+  repeated AccessoryWidget accessory_widgets = 44;
 }
 
 // A GIF image that's specified by a URL.
@@ -268,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) = {
@@ -318,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.
@@ -334,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;
@@ -352,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];
 
@@ -360,6 +373,18 @@ message ActionResponse {
   UpdatedWidget updated_widget = 4 [(google.api.field_behavior) = INPUT_ONLY];
 }
 
+// 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.
+    google.apps.card.v1.ButtonList button_list = 1;
+  }
+}
+
+// Request to get a message.
 message GetMessageRequest {
   // Required. Resource name of the message.
   //
@@ -368,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.
   //
@@ -383,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" }
@@ -393,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];
@@ -418,13 +445,13 @@ message UpdateMessageRequest {
   // - `cards_v2`  (Requires [app
   // authentication](/chat/api/guides/auth/service-accounts).)
   //
-  // - Developer Preview: `accessory_widgets`  (Requires [app
+  // - `accessory_widgets`  (Requires [app
   // authentication](/chat/api/guides/auth/service-accounts).)
   google.protobuf.FieldMask update_mask = 2;
 
   // 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];
 }
@@ -472,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];
 
@@ -500,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];
 }
 
@@ -521,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;
@@ -593,6 +620,7 @@ message ListMessagesRequest {
   bool show_deleted = 6;
 }
 
+// Response message for listing messages.
 message ListMessagesResponse {
   // List of messages.
   repeated Message messages = 1;
@@ -603,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];
@@ -627,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

@@ -20,13 +20,13 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/chat/v1/user.proto";
 
-option csharp_namespace = "Google.Chat.V1";
+option csharp_namespace = "Google.Apps.Chat.V1";
 option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "ReactionProto";
 option java_package = "com.google.chat.v1";
-option php_namespace = "Google\\Chat\\V1";
-option ruby_package = "Google::Chat::V1";
+option php_namespace = "Google\\Apps\\Chat\\V1";
+option ruby_package = "Google::Apps::Chat::V1";
 
 // A reaction to a message.
 message Reaction {
@@ -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

@@ -16,16 +16,17 @@ syntax = "proto3";
 
 package google.chat.v1;
 
-option csharp_namespace = "Google.Chat.V1";
+option csharp_namespace = "Google.Apps.Chat.V1";
 option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
 option java_multiple_files = true;
 option java_outer_classname = "SlashCommandProto";
 option java_package = "com.google.chat.v1";
-option php_namespace = "Google\\Chat\\V1";
-option ruby_package = "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;