@google-apps/chat 0.12.0 → 0.14.0

package/build/protos/protos.json

@@ -1,7 +1,4 @@
 {
-  "options": {
-    "syntax": "proto3"
-  },
   "nested": {
     "google": {
       "nested": {
@@ -2981,7 +2978,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.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"
+                    "(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.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": {
@@ -3517,6 +3514,44 @@
                           "(google.api.method_signature)": "parent,filter"
                         }
                       ]
+                    },
+                    "GetSpaceNotificationSetting": {
+                      "requestType": "GetSpaceNotificationSettingRequest",
+                      "responseType": "SpaceNotificationSetting",
+                      "options": {
+                        "(google.api.http).get": "/v1/{name=users/*/spaces/*/spaceNotificationSetting}",
+                        "(google.api.method_signature)": "name"
+                      },
+                      "parsedOptions": [
+                        {
+                          "(google.api.http)": {
+                            "get": "/v1/{name=users/*/spaces/*/spaceNotificationSetting}"
+                          }
+                        },
+                        {
+                          "(google.api.method_signature)": "name"
+                        }
+                      ]
+                    },
+                    "UpdateSpaceNotificationSetting": {
+                      "requestType": "UpdateSpaceNotificationSettingRequest",
+                      "responseType": "SpaceNotificationSetting",
+                      "options": {
+                        "(google.api.http).patch": "/v1/{space_notification_setting.name=users/*/spaces/*/spaceNotificationSetting}",
+                        "(google.api.http).body": "space_notification_setting",
+                        "(google.api.method_signature)": "space_notification_setting,update_mask"
+                      },
+                      "parsedOptions": [
+                        {
+                          "(google.api.http)": {
+                            "patch": "/v1/{space_notification_setting.name=users/*/spaces/*/spaceNotificationSetting}",
+                            "body": "space_notification_setting"
+                          }
+                        },
+                        {
+                          "(google.api.method_signature)": "space_notification_setting,update_mask"
+                        }
+                      ]
                     }
                   }
                 },
@@ -4682,7 +4717,8 @@
                         "ADMIN": 3,
                         "APP_MESSAGE_EXPIRY": 4,
                         "CREATOR_VIA_APP": 5,
-                        "SPACE_OWNER_VIA_APP": 6
+                        "SPACE_OWNER_VIA_APP": 6,
+                        "SPACE_MEMBER": 7
                       }
                     }
                   }
@@ -5618,6 +5654,96 @@
                     }
                   }
                 },
+                "SpaceNotificationSetting": {
+                  "options": {
+                    "(google.api.resource).type": "chat.googleapis.com/SpaceNotificationSetting",
+                    "(google.api.resource).pattern": "users/{user}/spaces/{space}/spaceNotificationSetting",
+                    "(google.api.resource).singular": "spaceNotificationSetting"
+                  },
+                  "oneofs": {
+                    "_notificationSetting": {
+                      "oneof": [
+                        "notificationSetting"
+                      ]
+                    },
+                    "_muteSetting": {
+                      "oneof": [
+                        "muteSetting"
+                      ]
+                    }
+                  },
+                  "fields": {
+                    "name": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "IDENTIFIER"
+                      }
+                    },
+                    "notificationSetting": {
+                      "type": "NotificationSetting",
+                      "id": 2,
+                      "options": {
+                        "proto3_optional": true
+                      }
+                    },
+                    "muteSetting": {
+                      "type": "MuteSetting",
+                      "id": 3,
+                      "options": {
+                        "proto3_optional": true
+                      }
+                    }
+                  },
+                  "nested": {
+                    "NotificationSetting": {
+                      "values": {
+                        "NOTIFICATION_SETTING_UNSPECIFIED": 0,
+                        "ALL": 1,
+                        "MAIN_CONVERSATIONS": 2,
+                        "FOR_YOU": 3,
+                        "OFF": 4
+                      }
+                    },
+                    "MuteSetting": {
+                      "values": {
+                        "MUTE_SETTING_UNSPECIFIED": 0,
+                        "UNMUTED": 1,
+                        "MUTED": 2
+                      }
+                    }
+                  }
+                },
+                "GetSpaceNotificationSettingRequest": {
+                  "fields": {
+                    "name": {
+                      "type": "string",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED",
+                        "(google.api.resource_reference).type": "chat.googleapis.com/SpaceNotificationSetting"
+                      }
+                    }
+                  }
+                },
+                "UpdateSpaceNotificationSettingRequest": {
+                  "fields": {
+                    "spaceNotificationSetting": {
+                      "type": "SpaceNotificationSetting",
+                      "id": 1,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED"
+                      }
+                    },
+                    "updateMask": {
+                      "type": "google.protobuf.FieldMask",
+                      "id": 2,
+                      "options": {
+                        "(google.api.field_behavior)": "REQUIRED"
+                      }
+                    }
+                  }
+                },
                 "SpaceReadState": {
                   "options": {
                     "(google.api.resource).type": "chat.googleapis.com/SpaceReadState",

package/build/src/v1/chat_service_client.d.ts

@@ -18,6 +18,7 @@ export declare class ChatServiceClient {
     private _defaults;
     private _universeDomain;
     private _servicePath;
+    private _log;
     auth: gax.GoogleAuth;
     descriptors: Descriptors;
     warn: (code: string, message: string, warnType?: string) => void;
@@ -52,7 +53,7 @@ export declare class ChatServiceClient {
      *     Developer's Console, e.g. 'grape-spaceship-123'. We will also check
      *     the environment variable GCLOUD_PROJECT for your project ID. If your
      *     app is running in an environment which supports
-     *     {@link https://developers.google.com/identity/protocols/application-default-credentials Application Default Credentials},
+     *     {@link https://cloud.google.com/docs/authentication/application-default-credentials Application Default Credentials},
      *     your project ID will be detected automatically.
      * @param {string} [options.apiEndpoint] - The domain name of the
      *     API remote host.
@@ -1467,6 +1468,76 @@ export declare class ChatServiceClient {
     ]>;
     getSpaceEvent(request: protos.google.chat.v1.IGetSpaceEventRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.ISpaceEvent, protos.google.chat.v1.IGetSpaceEventRequest | null | undefined, {} | null | undefined>): void;
     getSpaceEvent(request: protos.google.chat.v1.IGetSpaceEventRequest, callback: Callback<protos.google.chat.v1.ISpaceEvent, protos.google.chat.v1.IGetSpaceEventRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Gets the space notification setting. For an example, see [Get the
+     * caller's space notification
+     * setting](https://developers.google.com/workspace/chat/get-space-notification-setting).
+     *
+     * Requires [user
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. Format: users/{user}/spaces/{space}/spaceNotificationSetting
+     *
+     *   - `users/me/spaces/{space}/spaceNotificationSetting`, OR
+     *   - `users/user@example.com/spaces/{space}/spaceNotificationSetting`, OR
+     *   - `users/123456789/spaces/{space}/spaceNotificationSetting`.
+     *   Note: Only the caller's user id or email is allowed in the path.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing {@link protos.google.chat.v1.SpaceNotificationSetting|SpaceNotificationSetting}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v1/chat_service.get_space_notification_setting.js</caption>
+     * region_tag:chat_v1_generated_ChatService_GetSpaceNotificationSetting_async
+     */
+    getSpaceNotificationSetting(request?: protos.google.chat.v1.IGetSpaceNotificationSettingRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISpaceNotificationSetting,
+        protos.google.chat.v1.IGetSpaceNotificationSettingRequest | undefined,
+        {} | undefined
+    ]>;
+    getSpaceNotificationSetting(request: protos.google.chat.v1.IGetSpaceNotificationSettingRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.ISpaceNotificationSetting, protos.google.chat.v1.IGetSpaceNotificationSettingRequest | null | undefined, {} | null | undefined>): void;
+    getSpaceNotificationSetting(request: protos.google.chat.v1.IGetSpaceNotificationSettingRequest, callback: Callback<protos.google.chat.v1.ISpaceNotificationSetting, protos.google.chat.v1.IGetSpaceNotificationSettingRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Updates the space notification setting. For an example, see [Update
+     * the caller's space notification
+     * setting](https://developers.google.com/workspace/chat/update-space-notification-setting).
+     *
+     * Requires [user
+     * authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {google.chat.v1.SpaceNotificationSetting} request.spaceNotificationSetting
+     *   Required. The resource name for the space notification settings must be
+     *   populated in the form of
+     *   `users/{user}/spaces/{space}/spaceNotificationSetting`. Only fields
+     *   specified by `update_mask` are updated.
+     * @param {google.protobuf.FieldMask} request.updateMask
+     *   Required. Supported field paths:
+     *
+     *   - `notification_setting`
+     *
+     *   - `mute_setting`
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing {@link protos.google.chat.v1.SpaceNotificationSetting|SpaceNotificationSetting}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v1/chat_service.update_space_notification_setting.js</caption>
+     * region_tag:chat_v1_generated_ChatService_UpdateSpaceNotificationSetting_async
+     */
+    updateSpaceNotificationSetting(request?: protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest, options?: CallOptions): Promise<[
+        protos.google.chat.v1.ISpaceNotificationSetting,
+        protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest | undefined,
+        {} | undefined
+    ]>;
+    updateSpaceNotificationSetting(request: protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest, options: CallOptions, callback: Callback<protos.google.chat.v1.ISpaceNotificationSetting, protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest | null | undefined, {} | null | undefined>): void;
+    updateSpaceNotificationSetting(request: protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest, callback: Callback<protos.google.chat.v1.ISpaceNotificationSetting, protos.google.chat.v1.IUpdateSpaceNotificationSettingRequest | null | undefined, {} | null | undefined>): void;
     /**
      * Lists messages in a space that the caller is a member of, including
      * messages from blocked members and spaces. If you list messages from a
@@ -1573,7 +1644,7 @@ export declare class ChatServiceClient {
     listMessages(request: protos.google.chat.v1.IListMessagesRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.IListMessagesRequest, protos.google.chat.v1.IListMessagesResponse | null | undefined, protos.google.chat.v1.IMessage>): void;
     listMessages(request: protos.google.chat.v1.IListMessagesRequest, callback: PaginationCallback<protos.google.chat.v1.IListMessagesRequest, protos.google.chat.v1.IListMessagesResponse | null | undefined, protos.google.chat.v1.IMessage>): void;
     /**
-     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * Equivalent to `listMessages`, but returns a NodeJS Stream object.
      * @param {Object} request
      *   The request object that will be sent.
      * @param {string} request.parent
@@ -1887,7 +1958,7 @@ export declare class ChatServiceClient {
     listMemberships(request: protos.google.chat.v1.IListMembershipsRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.IListMembershipsRequest, protos.google.chat.v1.IListMembershipsResponse | null | undefined, protos.google.chat.v1.IMembership>): void;
     listMemberships(request: protos.google.chat.v1.IListMembershipsRequest, callback: PaginationCallback<protos.google.chat.v1.IListMembershipsRequest, protos.google.chat.v1.IListMembershipsResponse | null | undefined, protos.google.chat.v1.IMembership>): void;
     /**
-     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * Equivalent to `listMemberships`, but returns a NodeJS Stream object.
      * @param {Object} request
      *   The request object that will be sent.
      * @param {string} request.parent
@@ -2178,7 +2249,7 @@ export declare class ChatServiceClient {
     listSpaces(request: protos.google.chat.v1.IListSpacesRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.IListSpacesRequest, protos.google.chat.v1.IListSpacesResponse | null | undefined, protos.google.chat.v1.ISpace>): void;
     listSpaces(request: protos.google.chat.v1.IListSpacesRequest, callback: PaginationCallback<protos.google.chat.v1.IListSpacesRequest, protos.google.chat.v1.IListSpacesResponse | null | undefined, protos.google.chat.v1.ISpace>): void;
     /**
-     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * Equivalent to `listSpaces`, but returns a NodeJS Stream object.
      * @param {Object} request
      *   The request object that will be sent.
      * @param {number} [request.pageSize]
@@ -2438,7 +2509,7 @@ export declare class ChatServiceClient {
     searchSpaces(request: protos.google.chat.v1.ISearchSpacesRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.ISearchSpacesRequest, protos.google.chat.v1.ISearchSpacesResponse | null | undefined, protos.google.chat.v1.ISpace>): void;
     searchSpaces(request: protos.google.chat.v1.ISearchSpacesRequest, callback: PaginationCallback<protos.google.chat.v1.ISearchSpacesRequest, protos.google.chat.v1.ISearchSpacesResponse | null | undefined, protos.google.chat.v1.ISpace>): void;
     /**
-     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * Equivalent to `searchSpaces`, but returns a NodeJS Stream object.
      * @param {Object} request
      *   The request object that will be sent.
      * @param {boolean} request.useAdminAccess
@@ -2809,7 +2880,7 @@ export declare class ChatServiceClient {
     listReactions(request: protos.google.chat.v1.IListReactionsRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.IListReactionsRequest, protos.google.chat.v1.IListReactionsResponse | null | undefined, protos.google.chat.v1.IReaction>): void;
     listReactions(request: protos.google.chat.v1.IListReactionsRequest, callback: PaginationCallback<protos.google.chat.v1.IListReactionsRequest, protos.google.chat.v1.IListReactionsResponse | null | undefined, protos.google.chat.v1.IReaction>): void;
     /**
-     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * Equivalent to `listReactions`, but returns a NodeJS Stream object.
      * @param {Object} request
      *   The request object that will be sent.
      * @param {string} request.parent
@@ -3074,7 +3145,7 @@ export declare class ChatServiceClient {
     listSpaceEvents(request: protos.google.chat.v1.IListSpaceEventsRequest, options: CallOptions, callback: PaginationCallback<protos.google.chat.v1.IListSpaceEventsRequest, protos.google.chat.v1.IListSpaceEventsResponse | null | undefined, protos.google.chat.v1.ISpaceEvent>): void;
     listSpaceEvents(request: protos.google.chat.v1.IListSpaceEventsRequest, callback: PaginationCallback<protos.google.chat.v1.IListSpaceEventsRequest, protos.google.chat.v1.IListSpaceEventsResponse | null | undefined, protos.google.chat.v1.ISpaceEvent>): void;
     /**
-     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * Equivalent to `listSpaceEvents`, but returns a NodeJS Stream object.
      * @param {Object} request
      *   The request object that will be sent.
      * @param {string} request.parent
@@ -3436,6 +3507,30 @@ export declare class ChatServiceClient {
      * @returns {string} A string representing the space_event.
      */
     matchSpaceEventFromSpaceEventName(spaceEventName: string): string | number;
+    /**
+     * Return a fully-qualified spaceNotificationSetting resource name string.
+     *
+     * @param {string} user
+     * @param {string} space
+     * @returns {string} Resource name string.
+     */
+    spaceNotificationSettingPath(user: string, space: string): string;
+    /**
+     * Parse the user from SpaceNotificationSetting resource.
+     *
+     * @param {string} spaceNotificationSettingName
+     *   A fully-qualified path representing SpaceNotificationSetting resource.
+     * @returns {string} A string representing the user.
+     */
+    matchUserFromSpaceNotificationSettingName(spaceNotificationSettingName: string): string | number;
+    /**
+     * Parse the space from SpaceNotificationSetting resource.
+     *
+     * @param {string} spaceNotificationSettingName
+     *   A fully-qualified path representing SpaceNotificationSetting resource.
+     * @returns {string} A string representing the space.
+     */
+    matchSpaceFromSpaceNotificationSettingName(spaceNotificationSettingName: string): string | number;
     /**
      * Return a fully-qualified spaceReadState resource name string.
      *