@google-apps/chat 0.16.0 → 0.18.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

@@ -152,7 +152,9 @@ message Message {
   // [Card builder](https://addons.gsuite.google.com/uikit/builder)
   repeated CardWithId cards_v2 = 22 [(google.api.field_behavior) = OPTIONAL];
 
-  // Output only. Annotations associated with the `text` in this message.
+  // Output only. Annotations can be associated with the plain-text body of the
+  // message or with chips that link to Google Workspace resources like Google
+  // Docs or Sheets with `start_index` and `length` of 0.
   repeated Annotation annotations = 10
       [(google.api.field_behavior) = OUTPUT_ONLY];
 

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";