@google-apps/chat 0.17.0 → 0.19.0

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

@@ -29,7 +29,9 @@ option ruby_package = "Google::Apps::Chat::V1";
 // is set.
 message DeletionMetadata {
   // Who deleted the message and how it was deleted. More values may be added in
-  // the future.
+  // the future. See [Edit or delete a message in Google
+  // Chat](https://support.google.com/chat/answer/7653281) for details on when
+  // messages can be deleted.
   enum DeletionType {
     // This value is unused.
     DELETION_TYPE_UNSPECIFIED = 0;
@@ -37,23 +39,27 @@ message DeletionMetadata {
     // User deleted their own message.
     CREATOR = 1;
 
-    // The space owner deleted the message.
+    // A space manager deleted the message.
     SPACE_OWNER = 2;
 
-    // A Google Workspace admin deleted the message.
+    // A Google Workspace administrator deleted the message. Administrators can
+    // delete any message in the space, including messages sent by any space
+    // member or Chat app.
     ADMIN = 3;
 
     // A Chat app deleted its own message when it expired.
     APP_MESSAGE_EXPIRY = 4;
 
-    // A Chat app deleted the message on behalf of the user.
+    // A Chat app deleted the message on behalf of the creator (using user
+    // authentication).
     CREATOR_VIA_APP = 5;
 
-    // A Chat app deleted the message on behalf of the space owner.
+    // A Chat app deleted the message on behalf of a space manager (using user
+    // authentication).
     SPACE_OWNER_VIA_APP = 6;
 
-    // A member of the space deleted the message. Human users can delete
-    // messages sent by apps.
+    // A member of the space deleted the message. Users can delete messages sent
+    // by apps.
     SPACE_MEMBER = 7;
   }
 

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

@@ -156,8 +156,6 @@ message CreateMembershipRequest {
   // - When [authenticating as an
   // app](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app),
   // the `chat.app.memberships` authorization scope is required.
-  // Authenticating as an app is available in [Developer
-  // Preview](https://developers.google.com/workspace/preview).
   //
   // - Set `user.type` to `HUMAN`, and set `user.name` with format
   // `users/{user}`, where `{user}` can be the email address for the user. For
@@ -377,9 +375,13 @@ message DeleteMembershipRequest {
   // human users' or their own memberships. Chat apps can't delete other apps'
   // memberships.
   //
-  // When deleting a human membership, requires the `chat.memberships` scope and
-  // `spaces/{space}/members/{member}` format. You can use the email as an
-  // alias for `{member}`. For example,
+  // When deleting a human membership, requires the `chat.memberships` scope
+  // with [user
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
+  // or the `chat.memberships.app` scope with [app
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+  // and the `spaces/{space}/members/{member}` format.
+  // You can use the email as an alias for `{member}`. For example,
   // `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the
   // email of the Google Chat user.
   //

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

@@ -238,10 +238,19 @@ message Message {
   DeletionMetadata deletion_metadata = 38
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Output only. Information about a message that's quoted by a Google Chat
-  // user in a space. Google Chat users can quote a message to reply to it.
+  // Optional. Information about a message that another message quotes.
+  //
+  // When you create a message, you can quote messages within the same
+  // thread, or quote a root message to create a new root message.
+  // However, you can't quote a message reply from a different thread.
+  //
+  // When you update a message, you can't add or replace the
+  // `quotedMessageMetadata` field, but you can remove it.
+  //
+  // For example usage, see [Quote another
+  // message](https://developers.google.com/workspace/chat/create-messages#quote-a-message).
   QuotedMessageMetadata quoted_message_metadata = 39
-      [(google.api.field_behavior) = OUTPUT_ONLY];
+      [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. GIF images that are attached to the message.
   repeated AttachedGif attached_gifs = 42
@@ -266,25 +275,41 @@ message AttachedGif {
   string uri = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
-// Information about a quoted message.
+// Information about a message that another message quotes.
+//
+// When you create a message, you can quote messages within the same
+// thread, or quote a root message to create a new root message.
+// However, you can't quote a message reply from a different thread.
+//
+// When you update a message, you can't add or replace the
+// `quotedMessageMetadata` field, but you can remove it.
+//
+// For example usage, see [Quote another
+// message](https://developers.google.com/workspace/chat/create-messages#quote-a-message).
 message QuotedMessageMetadata {
   option (google.api.resource) = {
     type: "chat.googleapis.com/QuotedMessageMetadata"
     pattern: "spaces/{space}/messages/{message}/quotedMessageMetadata/{quoted_message_metadata}"
   };
 
-  // Output only. Resource name of the quoted message.
+  // Required. Resource name of the message that is quoted.
   //
   // Format: `spaces/{space}/messages/{message}`
   string name = 1 [
-    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "chat.googleapis.com/Message" }
   ];
 
-  // Output only. The timestamp when the quoted message was created or when the
+  // Required. The timestamp when the quoted message was created or when the
   // quoted message was last updated.
+  //
+  // If the message was edited, use this field, `last_update_time`.
+  // If the message was never edited, use `create_time`.
+  //
+  // If `last_update_time` doesn't match the latest version of the quoted
+  // message, the request fails.
   google.protobuf.Timestamp last_update_time = 2
-      [(google.api.field_behavior) = OUTPUT_ONLY];
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // A thread in a Google Chat space. For example usage, see
@@ -456,6 +481,8 @@ message UpdateMessageRequest {
   //
   // - `accessory_widgets`  (Requires [app
   // authentication](/chat/api/guides/auth/service-accounts).)
+  //
+  // - `quoted_message_metadata` (Only allows removal of the quoted message.)
   google.protobuf.FieldMask update_mask = 2
       [(google.api.field_behavior) = REQUIRED];
 

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

@@ -25,10 +25,10 @@ option objc_class_prefix = "DYNAPIProto";
 option php_namespace = "Google\\Apps\\Chat\\V1";
 option ruby_package = "Google::Apps::Chat::V1";
 
-// A [slash
+// Metadata about a [slash
 // command](https://developers.google.com/workspace/chat/commands) in
 // Google Chat.
 message SlashCommand {
-  // The ID of the slash command invoked.
+  // The ID of the slash command.
   int64 command_id = 1;
 }

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

@@ -163,8 +163,7 @@ message Space {
     // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
     // with [administrator
     // approval](https://support.google.com/a?p=chat-app-auth)
-    // with the `chat.app.spaces` scope in [Developer
-    // Preview](https://developers.google.com/workspace/preview).
+    // with the `chat.app.spaces` scope.
     //
     // This field is not populated when using the `chat.bot` scope with [app
     // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app).
@@ -350,20 +349,45 @@ message Space {
   // Only populated when the `space_type` is `SPACE`.
   AccessSettings access_settings = 23 [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. Immutable. The customer id of the domain of the space.
+  // Required only when creating a space with [app
+  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+  // and `SpaceType` is `SPACE`, otherwise should not be set.
+  //
+  // In the format `customers/{customer}`, where `customer` is the `id` from the
+  // [Admin SDK customer
+  // resource](https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers).
+  // Private apps can also use the `customers/my_customer` alias to create
+  // the space in the same Google Workspace organization as the app.
+  //
+  // For DMs, this field isn't populated.
+  optional string customer = 24 [
+    (google.api.field_behavior) = IMMUTABLE,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+
   // Output only. The URI for a user to access the space.
   string space_uri = 25 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Represents the [permission settings]
   // (https://support.google.com/chat/answer/13340792) of a space. Only
   // populated when the `space_type` is `SPACE`.
-  //
-  // Requires [user
-  // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
   oneof space_permission_settings {
     // Optional. Input only. Predefined space permission settings, input only
     // when creating a space. If the field is not set, a collaboration space is
     // created. After you create the space, settings are populated in the
     // `PermissionSettings` field.
+    //
+    // Setting predefined permission settings supports:
+    //
+    // - [App
+    // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+    // with [administrator
+    // approval](https://support.google.com/a?p=chat-app-auth) with the
+    // `chat.app.spaces` or `chat.app.spaces.create` scopes.
+    //
+    // - [User
+    // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
     PredefinedPermissionSettings predefined_permission_settings = 26 [
       (google.api.field_behavior) = INPUT_ONLY,
       (google.api.field_behavior) = OPTIONAL
@@ -372,6 +396,18 @@ message Space {
     // Optional. Space permission settings for existing spaces. Input for
     // updating exact space permission settings, where existing permission
     // settings are replaced. Output lists current permission settings.
+    //
+    // Reading and updating permission settings supports:
+    //
+    // - [App
+    // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app)
+    // with [administrator
+    // approval](https://support.google.com/a?p=chat-app-auth) with the
+    // `chat.app.spaces` scope. Only populated and settable when the Chat app
+    // created the space.
+    //
+    // - [User
+    // authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user)
     PermissionSettings permission_settings = 27
         [(google.api.field_behavior) = OPTIONAL];
   }

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

@@ -67,7 +67,7 @@ message SetUpSpaceRequest {
   // Optional. The Google Chat users or groups to invite to join the space. Omit
   // the calling user, as they are added automatically.
   //
-  // The set currently allows up to 20 memberships (in addition to the caller).
+  // The set currently allows up to 49 memberships (in addition to the caller).
   //
   // For human membership, the `Membership.member` field must contain a `user`
   // with `name` populated (format: `users/{user}`) and `type` set to

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

@@ -17,7 +17,6 @@ syntax = "proto3";
 package google.chat.v1;
 
 import "google/api/field_behavior.proto";
-import "google/api/resource.proto";
 
 option csharp_namespace = "Google.Apps.Chat.V1";
 option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";

package/build/protos/protos.d.ts

@@ -19171,6 +19171,9 @@ export namespace google {
                 /** Space accessSettings */
                 accessSettings?: (google.chat.v1.Space.IAccessSettings|null);
 
+                /** Space customer */
+                customer?: (string|null);
+
                 /** Space spaceUri */
                 spaceUri?: (string|null);
 
@@ -19241,6 +19244,9 @@ export namespace google {
                 /** Space accessSettings. */
                 public accessSettings?: (google.chat.v1.Space.IAccessSettings|null);
 
+                /** Space customer. */
+                public customer?: (string|null);
+
                 /** Space spaceUri. */
                 public spaceUri: string;
 

package/build/protos/protos.js

@@ -49682,6 +49682,7 @@
                      * @property {boolean|null} [adminInstalled] Space adminInstalled
                      * @property {google.chat.v1.Space.IMembershipCount|null} [membershipCount] Space membershipCount
                      * @property {google.chat.v1.Space.IAccessSettings|null} [accessSettings] Space accessSettings
+                     * @property {string|null} [customer] Space customer
                      * @property {string|null} [spaceUri] Space spaceUri
                      * @property {google.chat.v1.Space.PredefinedPermissionSettings|null} [predefinedPermissionSettings] Space predefinedPermissionSettings
                      * @property {google.chat.v1.Space.IPermissionSettings|null} [permissionSettings] Space permissionSettings
@@ -49831,6 +49832,14 @@
                      */
                     Space.prototype.accessSettings = null;
     
+                    /**
+                     * Space customer.
+                     * @member {string|null|undefined} customer
+                     * @memberof google.chat.v1.Space
+                     * @instance
+                     */
+                    Space.prototype.customer = null;
+    
                     /**
                      * Space spaceUri.
                      * @member {string} spaceUri
@@ -49866,6 +49875,12 @@
                     // OneOf field names bound to virtual getters and setters
                     var $oneOfFields;
     
+                    // Virtual OneOf for proto3 optional field
+                    Object.defineProperty(Space.prototype, "_customer", {
+                        get: $util.oneOfGetter($oneOfFields = ["customer"]),
+                        set: $util.oneOfSetter($oneOfFields)
+                    });
+    
                     /**
                      * Space spacePermissionSettings.
                      * @member {"predefinedPermissionSettings"|"permissionSettings"|undefined} spacePermissionSettings
@@ -49933,6 +49948,8 @@
                             $root.google.chat.v1.Space.MembershipCount.encode(message.membershipCount, writer.uint32(/* id 20, wireType 2 =*/162).fork()).ldelim();
                         if (message.accessSettings != null && Object.hasOwnProperty.call(message, "accessSettings"))
                             $root.google.chat.v1.Space.AccessSettings.encode(message.accessSettings, writer.uint32(/* id 23, wireType 2 =*/186).fork()).ldelim();
+                        if (message.customer != null && Object.hasOwnProperty.call(message, "customer"))
+                            writer.uint32(/* id 24, wireType 2 =*/194).string(message.customer);
                         if (message.spaceUri != null && Object.hasOwnProperty.call(message, "spaceUri"))
                             writer.uint32(/* id 25, wireType 2 =*/202).string(message.spaceUri);
                         if (message.predefinedPermissionSettings != null && Object.hasOwnProperty.call(message, "predefinedPermissionSettings"))
@@ -50041,6 +50058,10 @@
                                     message.accessSettings = $root.google.chat.v1.Space.AccessSettings.decode(reader, reader.uint32());
                                     break;
                                 }
+                            case 24: {
+                                    message.customer = reader.string();
+                                    break;
+                                }
                             case 25: {
                                     message.spaceUri = reader.string();
                                     break;
@@ -50177,6 +50198,11 @@
                             if (error)
                                 return "accessSettings." + error;
                         }
+                        if (message.customer != null && message.hasOwnProperty("customer")) {
+                            properties._customer = 1;
+                            if (!$util.isString(message.customer))
+                                return "customer: string expected";
+                        }
                         if (message.spaceUri != null && message.hasOwnProperty("spaceUri"))
                             if (!$util.isString(message.spaceUri))
                                 return "spaceUri: string expected";
@@ -50348,6 +50374,8 @@
                                 throw TypeError(".google.chat.v1.Space.accessSettings: object expected");
                             message.accessSettings = $root.google.chat.v1.Space.AccessSettings.fromObject(object.accessSettings);
                         }
+                        if (object.customer != null)
+                            message.customer = String(object.customer);
                         if (object.spaceUri != null)
                             message.spaceUri = String(object.spaceUri);
                         switch (object.predefinedPermissionSettings) {
@@ -50448,6 +50476,11 @@
                             object.membershipCount = $root.google.chat.v1.Space.MembershipCount.toObject(message.membershipCount, options);
                         if (message.accessSettings != null && message.hasOwnProperty("accessSettings"))
                             object.accessSettings = $root.google.chat.v1.Space.AccessSettings.toObject(message.accessSettings, options);
+                        if (message.customer != null && message.hasOwnProperty("customer")) {
+                            object.customer = message.customer;
+                            if (options.oneofs)
+                                object._customer = "customer";
+                        }
                         if (message.spaceUri != null && message.hasOwnProperty("spaceUri"))
                             object.spaceUri = message.spaceUri;
                         if (message.predefinedPermissionSettings != null && message.hasOwnProperty("predefinedPermissionSettings")) {

package/build/protos/protos.json

@@ -3332,7 +3332,7 @@
                 "ChatService": {
                   "options": {
                     "(google.api.default_host)": "chat.googleapis.com",
-                    "(google.api.oauth_scopes)": "https://www.googleapis.com/auth/chat.admin.delete,https://www.googleapis.com/auth/chat.admin.memberships,https://www.googleapis.com/auth/chat.admin.memberships.readonly,https://www.googleapis.com/auth/chat.admin.spaces,https://www.googleapis.com/auth/chat.admin.spaces.readonly,https://www.googleapis.com/auth/chat.bot,https://www.googleapis.com/auth/chat.customemojis,https://www.googleapis.com/auth/chat.customemojis.readonly,https://www.googleapis.com/auth/chat.delete,https://www.googleapis.com/auth/chat.import,https://www.googleapis.com/auth/chat.memberships,https://www.googleapis.com/auth/chat.memberships.app,https://www.googleapis.com/auth/chat.memberships.readonly,https://www.googleapis.com/auth/chat.messages,https://www.googleapis.com/auth/chat.messages.create,https://www.googleapis.com/auth/chat.messages.reactions,https://www.googleapis.com/auth/chat.messages.reactions.create,https://www.googleapis.com/auth/chat.messages.reactions.readonly,https://www.googleapis.com/auth/chat.messages.readonly,https://www.googleapis.com/auth/chat.spaces,https://www.googleapis.com/auth/chat.spaces.create,https://www.googleapis.com/auth/chat.spaces.readonly,https://www.googleapis.com/auth/chat.users.readstate,https://www.googleapis.com/auth/chat.users.readstate.readonly,https://www.googleapis.com/auth/chat.users.spacesettings"
+                    "(google.api.oauth_scopes)": "https://www.googleapis.com/auth/chat.admin.delete,https://www.googleapis.com/auth/chat.admin.memberships,https://www.googleapis.com/auth/chat.admin.memberships.readonly,https://www.googleapis.com/auth/chat.admin.spaces,https://www.googleapis.com/auth/chat.admin.spaces.readonly,https://www.googleapis.com/auth/chat.app.delete,https://www.googleapis.com/auth/chat.app.memberships,https://www.googleapis.com/auth/chat.app.spaces,https://www.googleapis.com/auth/chat.app.spaces.create,https://www.googleapis.com/auth/chat.bot,https://www.googleapis.com/auth/chat.customemojis,https://www.googleapis.com/auth/chat.customemojis.readonly,https://www.googleapis.com/auth/chat.delete,https://www.googleapis.com/auth/chat.import,https://www.googleapis.com/auth/chat.memberships,https://www.googleapis.com/auth/chat.memberships.app,https://www.googleapis.com/auth/chat.memberships.readonly,https://www.googleapis.com/auth/chat.messages,https://www.googleapis.com/auth/chat.messages.create,https://www.googleapis.com/auth/chat.messages.reactions,https://www.googleapis.com/auth/chat.messages.reactions.create,https://www.googleapis.com/auth/chat.messages.reactions.readonly,https://www.googleapis.com/auth/chat.messages.readonly,https://www.googleapis.com/auth/chat.spaces,https://www.googleapis.com/auth/chat.spaces.create,https://www.googleapis.com/auth/chat.spaces.readonly,https://www.googleapis.com/auth/chat.users.readstate,https://www.googleapis.com/auth/chat.users.readstate.readonly,https://www.googleapis.com/auth/chat.users.spacesettings"
                   },
                   "methods": {
                     "CreateMessage": {
@@ -4405,7 +4405,7 @@
                       "type": "QuotedMessageMetadata",
                       "id": 39,
                       "options": {
-                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                        "(google.api.field_behavior)": "OPTIONAL"
                       }
                     },
                     "attachedGifs": {
@@ -4447,7 +4447,7 @@
                       "type": "string",
                       "id": 1,
                       "options": {
-                        "(google.api.field_behavior)": "OUTPUT_ONLY",
+                        "(google.api.field_behavior)": "REQUIRED",
                         "(google.api.resource_reference).type": "chat.googleapis.com/Message"
                       }
                     },
@@ -4455,7 +4455,7 @@
                       "type": "google.protobuf.Timestamp",
                       "id": 2,
                       "options": {
-                        "(google.api.field_behavior)": "OUTPUT_ONLY"
+                        "(google.api.field_behavior)": "REQUIRED"
                       }
                     }
                   }
@@ -5176,6 +5176,11 @@
                     "(google.api.resource).pattern": "spaces/{space}"
                   },
                   "oneofs": {
+                    "_customer": {
+                      "oneof": [
+                        "customer"
+                      ]
+                    },
                     "spacePermissionSettings": {
                       "oneof": [
                         "predefinedPermissionSettings",
@@ -5298,6 +5303,14 @@
                         "(google.api.field_behavior)": "OPTIONAL"
                       }
                     },
+                    "customer": {
+                      "type": "string",
+                      "id": 24,
+                      "options": {
+                        "(google.api.field_behavior)": "OPTIONAL",
+                        "proto3_optional": true
+                      }
+                    },
                     "spaceUri": {
                       "type": "string",
                       "id": 25,