@google-apps/chat 0.1.0

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

@@ -0,0 +1,493 @@
+// Copyright 2023 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.chat.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/chat/v1/attachment.proto";
+import "google/chat/v1/membership.proto";
+import "google/chat/v1/message.proto";
+import "google/chat/v1/reaction.proto";
+import "google/chat/v1/space.proto";
+import "google/chat/v1/space_setup.proto";
+import "google/protobuf/empty.proto";
+
+option csharp_namespace = "Google.Chat.V1";
+option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
+option java_multiple_files = true;
+option java_outer_classname = "ChatServiceProto";
+option java_package = "com.google.chat.v1";
+option php_namespace = "Google\\Chat\\V1";
+option ruby_package = "Google::Chat::V1";
+
+// Enables developers to build Chat apps and
+// integrations on Google Chat Platform.
+service ChatService {
+  option (google.api.default_host) = "chat.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/chat.bot,"
+      "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";
+
+  // Creates a message in a Google Chat space. For an example, see [Create a
+  // message](https://developers.google.com/chat/api/guides/v1/messages/create).
+  //
+  // Calling this method requires
+  // [authentication](https://developers.google.com/chat/api/guides/auth) and
+  // supports the following authentication types:
+  //
+  // - For text messages, user authentication or app authentication are
+  // supported.
+  // - For card messages, only app authentication is supported. (Only Chat apps
+  // can create card messages.)
+  rpc CreateMessage(CreateMessageRequest) returns (Message) {
+    option (google.api.http) = {
+      post: "/v1/{parent=spaces/*}/messages"
+      body: "message"
+    };
+    option (google.api.method_signature) = "parent,message,message_id";
+  }
+
+  // Lists messages in a space that the caller is a member of, including
+  // messages from blocked members and spaces. For an example, see
+  // [List messages](/chat/api/guides/v1/messages/list).
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc ListMessages(ListMessagesRequest) returns (ListMessagesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=spaces/*}/messages"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Lists memberships in a space. For an example, see [List
+  // memberships](https://developers.google.com/chat/api/guides/v1/members/list).
+  // Listing memberships with
+  // [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // lists memberships in spaces that the Chat app has
+  // access to, but excludes Chat app memberships,
+  // including its own. Listing memberships with
+  // [User
+  // authentication](https://developers.google.com/chat/api/guides/auth/users)
+  // lists memberships in spaces that the authenticated user has access to.
+  //
+  // Requires
+  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // Supports
+  // [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // and [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc ListMemberships(ListMembershipsRequest)
+      returns (ListMembershipsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=spaces/*}/members"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Returns details about a membership. For an example, see
+  // [Get a
+  // membership](https://developers.google.com/chat/api/guides/v1/members/get).
+  //
+  // Requires
+  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // Supports
+  // [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // and [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc GetMembership(GetMembershipRequest) returns (Membership) {
+    option (google.api.http) = {
+      get: "/v1/{name=spaces/*/members/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Returns details about a message.
+  // For an example, see [Read a
+  // message](https://developers.google.com/chat/api/guides/v1/messages/get).
+  //
+  // Requires
+  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // Supports
+  // [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // and [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  //
+  // Note: Might return a message from a blocked member or space.
+  rpc GetMessage(GetMessageRequest) returns (Message) {
+    option (google.api.http) = {
+      get: "/v1/{name=spaces/*/messages/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates a message. There's a difference between the `patch` and `update`
+  // methods. The `patch`
+  // method uses a `patch` request while the `update` method uses a `put`
+  // request. We recommend using the `patch` method. For an example, see
+  // [Update a
+  // message](https://developers.google.com/chat/api/guides/v1/messages/update).
+  //
+  // Requires
+  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // Supports
+  // [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // and [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // When using app authentication, requests can only update messages
+  // created by the calling Chat app.
+  rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
+    option (google.api.http) = {
+      put: "/v1/{message.name=spaces/*/messages/*}"
+      body: "message"
+      additional_bindings {
+        patch: "/v1/{message.name=spaces/*/messages/*}"
+        body: "message"
+      }
+    };
+    option (google.api.method_signature) = "message,update_mask";
+  }
+
+  // Deletes a message.
+  // For an example, see [Delete a
+  // message](https://developers.google.com/chat/api/guides/v1/messages/delete).
+  //
+  // Requires
+  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // Supports
+  // [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // and [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // When using app authentication, requests can only delete messages
+  // created by the calling Chat app.
+  rpc DeleteMessage(DeleteMessageRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=spaces/*/messages/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets the metadata of a message attachment. The attachment data is fetched
+  // using the [media
+  // API](https://developers.google.com/chat/api/reference/rest/v1/media/download).
+  // For an example, see
+  // [Get a message
+  // attachment](https://developers.google.com/chat/api/guides/v1/media-and-attachments/get).
+  // Requires [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
+  rpc GetAttachment(GetAttachmentRequest) returns (Attachment) {
+    option (google.api.http) = {
+      get: "/v1/{name=spaces/*/messages/*/attachments/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Uploads an attachment. For an example, see
+  // [Upload media as a file
+  // attachment](https://developers.google.com/chat/api/guides/v1/media-and-attachments/upload).
+  // Requires user
+  // [authentication](https://developers.google.com/chat/api/guides/auth/users).
+  //
+  // You can upload attachments up to 200 MB. Certain file types aren't
+  // supported. For details, see [File types blocked by Google
+  // Chat](https://support.google.com/chat/answer/7651457?&co=GENIE.Platform%3DDesktop#File%20types%20blocked%20in%20Google%20Chat).
+  rpc UploadAttachment(UploadAttachmentRequest)
+      returns (UploadAttachmentResponse) {
+    option (google.api.http) = {
+      post: "/v1/{parent=spaces/*}/attachments:upload"
+      body: "*"
+    };
+  }
+
+  // Lists spaces the caller is a member of. Group chats and DMs aren't listed
+  // until the first message is sent. For an example, see
+  // [List
+  // spaces](https://developers.google.com/chat/api/guides/v1/spaces/list).
+  //
+  // Requires
+  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // Supports
+  // [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // and [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  //
+  // Lists spaces visible to the caller or authenticated user. Group chats
+  // and DMs aren't listed until the first message is sent.
+  rpc ListSpaces(ListSpacesRequest) returns (ListSpacesResponse) {
+    option (google.api.http) = {
+      get: "/v1/spaces"
+    };
+    option (google.api.method_signature) = "";
+  }
+
+  // Returns details about a space. For an example, see
+  // [Get a space](https://developers.google.com/chat/api/guides/v1/spaces/get).
+  //
+  // Requires
+  // [authentication](https://developers.google.com/chat/api/guides/auth).
+  // Supports
+  // [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts)
+  // and [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc GetSpace(GetSpaceRequest) returns (Space) {
+    option (google.api.http) = {
+      get: "/v1/{name=spaces/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Creates a named space. Spaces grouped by topics aren't supported. For an
+  // example, see [Create a
+  // space](https://developers.google.com/chat/api/guides/v1/spaces/create).
+  //
+  //  If you receive the error message `ALREADY_EXISTS` when creating
+  //  a space, try a different `displayName`. An existing space within
+  //  the Google Workspace organization might already use this display name.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc CreateSpace(CreateSpaceRequest) returns (Space) {
+    option (google.api.http) = {
+      post: "/v1/spaces"
+      body: "space"
+    };
+    option (google.api.method_signature) = "space";
+  }
+
+  // Creates a space and adds specified users to it. The calling user is
+  // automatically added to the space, and shouldn't be specified as a
+  // membership in the request. For an example, see
+  // [Set up a
+  // space](https://developers.google.com/chat/api/guides/v1/spaces/set-up).
+  //
+  // To specify the human members to add, add memberships with the appropriate
+  // `member.name` in the `SetUpSpaceRequest`. To add a human user, use
+  // `users/{user}`, where `{user}` can be the email address for the user. For
+  // users in the same Workspace organization `{user}` can also be the `id` for
+  // the person from the People API, or the `id` for the user in the Directory
+  // API. For example, if the People API Person profile ID for
+  // `user@example.com` is `123456789`, you can add the user to the space by
+  // setting the `membership.member.name` to `users/user@example.com` or
+  // `users/123456789`.
+  //
+  // For a space or group chat, if the caller blocks or is blocked by some
+  // members, then those members aren't added to the created space.
+  //
+  // To create a direct message (DM) between the calling user and another human
+  // user, specify exactly one membership to represent the human user. If
+  // one user blocks the other, the request fails and the DM isn't created.
+  //
+  // To create a DM between the calling user and the calling app, set
+  // `Space.singleUserBotDm` to `true` and don't specify any memberships. You
+  // can only use this method to set up a DM with the calling app. To add the
+  // calling app as a member of a space or an existing DM between two human
+  // users, see
+  // [create a
+  // membership](https://developers.google.com/chat/api/guides/v1/members/create).
+  //
+  // If a DM already exists between two users, even when one user blocks the
+  // other at the time a request is made, then the existing DM is returned.
+  //
+  // Spaces with threaded replies aren't supported. If you receive the error
+  // message `ALREADY_EXISTS` when setting up a space, try a different
+  // `displayName`. An existing space within the Google Workspace organization
+  // might already use this display name.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc SetUpSpace(SetUpSpaceRequest) returns (Space) {
+    option (google.api.http) = {
+      post: "/v1/spaces:setup"
+      body: "*"
+    };
+  }
+
+  // Updates a space. For an example, see
+  // [Update a
+  // space](https://developers.google.com/chat/api/guides/v1/spaces/update).
+  //
+  // If you're updating the `displayName` field and receive the error message
+  // `ALREADY_EXISTS`, try a different display name.. An existing space within
+  // the Google Workspace organization might already use this display name.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc UpdateSpace(UpdateSpaceRequest) returns (Space) {
+    option (google.api.http) = {
+      patch: "/v1/{space.name=spaces/*}"
+      body: "space"
+    };
+    option (google.api.method_signature) = "space,update_mask";
+  }
+
+  // Deletes a named space. Always performs a cascading delete, which means
+  // that the space's child resources—like messages posted in the space and
+  // memberships in the space—are also deleted. For an example, see
+  // [Delete a
+  // space](https://developers.google.com/chat/api/guides/v1/spaces/delete).
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users)
+  // from a user who has permission to delete the space.
+  rpc DeleteSpace(DeleteSpaceRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=spaces/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Completes the
+  // [import process](https://developers.google.com/chat/api/guides/import-data)
+  // for the specified space and makes it visible to users.
+  // Requires app authentication and domain-wide delegation. For more
+  // information, see [Authorize Google Chat apps to import
+  // data](https://developers.google.com/chat/api/guides/authorize-import).
+  rpc CompleteImportSpace(CompleteImportSpaceRequest)
+      returns (CompleteImportSpaceResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=spaces/*}:completeImport"
+      body: "*"
+    };
+  }
+
+  // Returns the existing direct message with the specified user. If no direct
+  // message space is found, returns a `404 NOT_FOUND` error. For an example,
+  // see
+  // [Find a direct message](/chat/api/guides/v1/spaces/find-direct-message).
+  //
+  // With [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users),
+  // returns the direct message space between the specified user and the
+  // authenticated user.
+  //
+  // With [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts),
+  // returns the direct message space between the specified user and the calling
+  // Chat app.
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users)
+  // or [app
+  // authentication](https://developers.google.com/chat/api/guides/auth/service-accounts).
+  rpc FindDirectMessage(FindDirectMessageRequest) returns (Space) {
+    option (google.api.http) = {
+      get: "/v1/spaces:findDirectMessage"
+    };
+  }
+
+  // Creates a human membership or app membership for the calling app. Creating
+  // memberships for other apps isn't supported. For an example, see
+  // [ Create a
+  // membership](https://developers.google.com/chat/api/guides/v1/members/create).
+  // When creating a membership, if the specified member has their auto-accept
+  // policy turned off, then they're invited, and must accept the space
+  // invitation before joining. Otherwise, creating a membership adds the member
+  // directly to the specified space. Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  //
+  // To specify the member to add, set the `membership.member.name` in the
+  // `CreateMembershipRequest`:
+  //
+  // - To add the calling app to a space or a direct message between two human
+  //   users, use `users/app`. Unable to add other
+  //   apps to the space.
+  //
+  // - To add a human user, use `users/{user}`, where `{user}` can be the email
+  // address for the user. For users in the same Workspace organization `{user}`
+  // can also be the `id` for the person from the People API, or the `id` for
+  // the user in the Directory API. For example, if the People API Person
+  // profile ID for `user@example.com` is `123456789`, you can add the user to
+  // the space by setting the `membership.member.name` to
+  // `users/user@example.com` or `users/123456789`.
+  rpc CreateMembership(CreateMembershipRequest) returns (Membership) {
+    option (google.api.http) = {
+      post: "/v1/{parent=spaces/*}/members"
+      body: "membership"
+    };
+    option (google.api.method_signature) = "parent,membership";
+  }
+
+  // Deletes a membership. For an example, see
+  // [Delete a
+  // membership](https://developers.google.com/chat/api/guides/v1/members/delete).
+  //
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc DeleteMembership(DeleteMembershipRequest) returns (Membership) {
+    option (google.api.http) = {
+      delete: "/v1/{name=spaces/*/members/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Creates a reaction and adds it to a message. For an example, see
+  // [Create a
+  // reaction](https://developers.google.com/chat/api/guides/v1/reactions/create).
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  // Only unicode emoji are supported.
+  rpc CreateReaction(CreateReactionRequest) returns (Reaction) {
+    option (google.api.http) = {
+      post: "/v1/{parent=spaces/*/messages/*}/reactions"
+      body: "reaction"
+    };
+    option (google.api.method_signature) = "parent,reaction";
+  }
+
+  // Lists reactions to a message. For an example, see
+  // [List
+  // reactions](https://developers.google.com/chat/api/guides/v1/reactions/list).
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc ListReactions(ListReactionsRequest) returns (ListReactionsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=spaces/*/messages/*}/reactions"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Deletes a reaction to a message. For an example, see
+  // [Delete a
+  // reaction](https://developers.google.com/chat/api/guides/v1/reactions/delete).
+  // Requires [user
+  // authentication](https://developers.google.com/chat/api/guides/auth/users).
+  rpc DeleteReaction(DeleteReactionRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=spaces/*/messages/*/reactions/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+}

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

@@ -0,0 +1,106 @@
+// Copyright 2023 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.chat.v1;
+
+import "google/chat/v1/widgets.proto";
+
+option csharp_namespace = "Google.Chat.V1";
+option go_package = "cloud.google.com/go/chat/apiv1/chatpb;chatpb";
+option java_multiple_files = true;
+option java_outer_classname = "ContextualAddOnProto";
+option java_package = "com.google.chat.v1";
+option php_namespace = "Google\\Chat\\V1";
+option ruby_package = "Google::Chat::V1";
+
+// The markup for developers to specify the contents of a contextual AddOn.
+message ContextualAddOnMarkup {
+  // A card is a UI element that can contain UI widgets such as text and
+  // images.
+  message Card {
+    message CardHeader {
+      enum ImageStyle {
+        IMAGE_STYLE_UNSPECIFIED = 0;
+
+        // Square border.
+        IMAGE = 1;
+
+        // Circular border.
+        AVATAR = 2;
+      }
+
+      // The title must be specified. The header has a fixed height: if both a
+      // title and subtitle is specified, each takes up one line. If only the
+      // title is specified, it takes up both lines.
+      string title = 1;
+
+      // The subtitle of the card header.
+      string subtitle = 2;
+
+      // The image's type (for example, square border or circular border).
+      ImageStyle image_style = 3;
+
+      // The URL of the image in the card header.
+      string image_url = 4;
+    }
+
+    // A section contains a collection of widgets that are rendered
+    // (vertically) in the order that they are specified. Across all platforms,
+    // cards have a narrow fixed width, so
+    // there's currently no need for layout properties (for example, float).
+    message Section {
+      // The header of the section. Formatted text is
+      // supported. For more information
+      // about formatting text, see
+      // [Formatting text in Google Chat
+      // apps](https://developers.google.com/chat/format-messages#card-formatting)
+      // and
+      // [Formatting
+      // text in Google Workspace
+      // Add-ons](https://developers.google.com/apps-script/add-ons/concepts/widgets#text_formatting).
+      string header = 1;
+
+      // A section must contain at least one widget.
+      repeated WidgetMarkup widgets = 2;
+    }
+
+    // A card action is
+    // the action associated with the card. For an invoice card, a
+    // typical action would be: delete invoice, email invoice or open the
+    // invoice in browser.
+    //
+    // Not supported by Google Chat apps.
+    message CardAction {
+      // The label used to be displayed in the action menu item.
+      string action_label = 1;
+
+      // The onclick action for this action item.
+      WidgetMarkup.OnClick on_click = 2;
+    }
+
+    // The header of the card. A header usually contains a title and an image.
+    CardHeader header = 1;
+
+    // Sections are separated by a line divider.
+    repeated Section sections = 2;
+
+    // The actions of this card.
+    repeated CardAction card_actions = 3;
+
+    // Name of the card.
+    string name = 4;
+  }
+}

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

@@ -0,0 +1,56 @@
+// Copyright 2023 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.chat.v1;
+
+option csharp_namespace = "Google.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";
+
+// Information about a deleted message. A message is deleted when `delete_time`
+// is set.
+message DeletionMetadata {
+  // Who deleted the message and how it was deleted.
+  enum DeletionType {
+    // This value is unused.
+    DELETION_TYPE_UNSPECIFIED = 0;
+
+    // User deleted their own message.
+    CREATOR = 1;
+
+    // The space owner deleted the message.
+    SPACE_OWNER = 2;
+
+    // A Google Workspace admin deleted the message.
+    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.
+    CREATOR_VIA_APP = 5;
+
+    // A Chat app deleted the message on behalf of the space owner.
+    SPACE_OWNER_VIA_APP = 6;
+  }
+
+  // Indicates who deleted the message.
+  DeletionType deletion_type = 1;
+}