@google-apps/chat 0.1.0 → 0.3.0

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

@@ -22,13 +22,13 @@ import "google/chat/v1/history_state.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 = "SpaceProto";
 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 space in Google Chat. Spaces are conversations between two or more users
 // or 1:1 messages between a user and a Chat app.
@@ -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

@@ -20,14 +20,15 @@ import "google/api/field_behavior.proto";
 import "google/chat/v1/membership.proto";
 import "google/chat/v1/space.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 = "SpaceSetupProto";
 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";
 
+// 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

@@ -19,18 +19,19 @@ package google.chat.v1;
 import "google/api/field_behavior.proto";
 import "google/api/resource.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 = "UserProto";
 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 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

@@ -16,20 +16,20 @@ 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 = "WidgetsProto";
 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 widget is a UI element that presents text and images.
 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