google-apps-chat-v1 0.24.0 → 0.26.0

data/proto_docs/google/chat/v1/audience.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Copyright 2026 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Apps
+    module Chat
+      module V1
+        # A target audience in Google Chat. A target audience represents a group of
+        # users within a Google Workspace organization, defined by an administrator.
+        # Target audiences are used to configure access and visibility settings for
+        # resources, such as making a space discoverable to a specific group of users.
+        #
+        # For more details, see [Target
+        # audiences](https://support.google.com/a/answer/9934697) and [Make a space
+        # discoverable to a target
+        # audience](https://developers.google.com/workspace/chat/space-target-audience).
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The resource name of the [target
+        #     audience](https://support.google.com/a/answer/9934697) who can discover
+        #     or join the space. For details, see [Make a space
+        #     discoverable to a target
+        #     audience](https://developers.google.com/workspace/chat/space-target-audience).
+        #     Format: `audiences/{audience}`
+        #
+        #     To use the default target audience for the Google Workspace organization,
+        #     set to `audiences/default`.
+        class Audience
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/chat/v1/availability.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+# Copyright 2026 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Apps
+    module Chat
+      module V1
+        # Represents a user's current availability information in Google Chat,
+        # including their state (for example, Active, Away, Do Not Disturb) and any
+        # custom status.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Resource name of the user's availability.
+        #
+        #     Format: `users/{user}/availability`
+        #
+        #     `{user}` is the id for the Person in the People API or Admin SDK directory
+        #     API. For example, `users/123456789`.
+        #
+        #     The user's email address or `me` can also be used as an alias to refer to
+        #     the caller.  For example, `users/user@example.com` or `users/me`.
+        # @!attribute [r] state
+        #   @return [::Google::Apps::Chat::V1::Availability::State]
+        #     Output only. The user's current availability state.
+        # @!attribute [r] do_not_disturb_metadata
+        #   @return [::Google::Apps::Chat::V1::DoNotDisturbMetadata]
+        #     Output only. Metadata if the user state is set to DO_NOT_DISTURB.
+        # @!attribute [rw] custom_status
+        #   @return [::Google::Apps::Chat::V1::CustomStatus]
+        #     Optional. The user's custom status.
+        class Availability
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Represents the current availability state of the user.
+          module State
+            # Default value. The state is unspecified.
+            STATE_UNSPECIFIED = 0
+
+            # The user is currently active, based on recent activity.
+            ACTIVE = 1
+
+            # The user is currently idle. This state indicates a period of inactivity
+            # after being ACTIVE, before potentially transitioning to AWAY.
+            IDLE = 2
+
+            # The user is currently away. This can be either automatically set after
+            # a period of inactivity in ACTIVE or IDLE state, or it can be manually set
+            # by the user. When manually set via `MarkAsAway`, this state persists
+            # regardless of user activity.
+            AWAY = 3
+
+            # The user is in Do Not Disturb state, which is manually set.
+            DO_NOT_DISTURB = 4
+          end
+        end
+
+        # Represents a user's custom status in Google Chat.
+        # This includes a short text message with an optional emoji that a user sets to
+        # give more context about their availability.
+        # @!attribute [rw] text
+        #   @return [::String]
+        #     Required. The text of the custom status. This will be a string with maximum
+        #     length of 64.
+        # @!attribute [rw] emoji
+        #   @return [::Google::Apps::Chat::V1::Emoji]
+        #     Required. The emoji of the custom status. Only Unicode emojis are
+        #     supported; custom emojis are not supported.
+        # @!attribute [rw] expire_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The timestamp when the custom status expires.
+        #
+        #     Note: The following fields are mutually exclusive: `expire_time`, `ttl`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] ttl
+        #   @return [::Google::Protobuf::Duration]
+        #     Input only. The time-to-live duration after which the custom status
+        #     expires.
+        #
+        #     Note: The following fields are mutually exclusive: `ttl`, `expire_time`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class CustomStatus
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata associated with the `DO_NOT_DISTURB` availability state,
+        # specifying when the state is set to expire.
+        # @!attribute [r] expiration_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Timestamp until which the user should be marked as
+        #     DO_NOT_DISTURB. This can be maximum of 1 year in the future.
+        class DoNotDisturbMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the `GetAvailability` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the availability to retrieve.
+        #
+        #     Format: users/\\{user}/availability
+        #
+        #     `{user}` is the id for the Person in the People API or Admin SDK directory
+        #     API. For example, `users/123456789`.
+        #
+        #     The user's email address or `me` can also be used as an alias to refer to
+        #     the caller.  For example, `users/user@example.com` or `users/me`.
+        class GetAvailabilityRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the `UpdateAvailability` method.
+        # @!attribute [rw] availability
+        #   @return [::Google::Apps::Chat::V1::Availability]
+        #     Required. The availability to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. The list of fields to update.
+        #     The only field that can be updated is `custom_status`.
+        class UpdateAvailabilityRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the `MarkAsActive` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the availability to mark as active.
+        #     Format: users/\\{user}/availability
+        #
+        #     `{user}` is the id for the Person in the People API or Admin SDK directory
+        #     API. For example, `users/123456789`.
+        #
+        #     The user's email address or `me` can also be used as an alias to refer to
+        #     the caller.  For example, `users/user@example.com` or `users/me`.
+        # @!attribute [rw] expire_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The absolute timestamp when the ACTIVE state expires.
+        #
+        #     Note: The following fields are mutually exclusive: `expire_time`, `ttl`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] ttl
+        #   @return [::Google::Protobuf::Duration]
+        #     The duration from the current time until the ACTIVE state expires.
+        #     Using a short TTL can effectively reset the user's state to be based
+        #     on activity after this brief duration.
+        #
+        #     Note: The following fields are mutually exclusive: `ttl`, `expire_time`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class MarkAsActiveRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the `MarkAsAway` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the availability to mark as away.
+        #     Format: users/\\{user}/availability
+        #
+        #     `{user}` is the id for the Person in the People API or Admin SDK directory
+        #     API. For example, `users/123456789`.
+        #
+        #     The user's email address or `me` can also be used as an alias to refer to
+        #     the caller.  For example, `users/user@example.com` or `users/me`.
+        class MarkAsAwayRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for the `MarkAsDoNotDisturb` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the availability to mark as Do Not Disturb.
+        #     Format: users/\\{user}/availability
+        #
+        #     `{user}` is the id for the Person in the People API or Admin SDK directory
+        #     API. For example, `users/123456789`.
+        #
+        #     The user's email address or `me` can also be used as an alias to refer to
+        #     the caller.  For example, `users/user@example.com` or `users/me`.
+        # @!attribute [rw] expire_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The absolute timestamp when the DND state expires.
+        #
+        #     Note: The following fields are mutually exclusive: `expire_time`, `ttl`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] ttl
+        #   @return [::Google::Protobuf::Duration]
+        #     The duration from the current time until the DND state expires.
+        #
+        #     Note: The following fields are mutually exclusive: `ttl`, `expire_time`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        class MarkAsDoNotDisturbRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/chat/v1/space.rb

@@ -259,6 +259,12 @@ module Google
           #
           #     Setting the target audience requires [user
           #     authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
+          # @!attribute [rw] access_permission_settings
+          #   @return [::Google::Apps::Chat::V1::Space::AccessPermissionSettings]
+          #     Optional. Access permission settings for the space.
+          #
+          #     To set the target audience when creating a space, specify the
+          #     `accessSettings.audience` field in your request.
           class AccessSettings
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -285,6 +291,36 @@ module Google
             end
           end
 
+          # Access permission settings for a space.
+          # @!attribute [rw] discover_space_setting
+          #   @return [::Google::Apps::Chat::V1::Space::AccessPermissionSetting]
+          #     Optional. Access permission setting for discovering the space.
+          # @!attribute [rw] join_space_setting
+          #   @return [::Google::Apps::Chat::V1::Space::AccessPermissionSetting]
+          #     Optional. Access permission setting for joining the space.
+          class AccessPermissionSettings
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # An access permission setting.
+          # @!attribute [rw] principals
+          #   @return [::Array<::Google::Apps::Chat::V1::Space::Principal>]
+          #     Optional. Unordered list. Allowed principals for this permission.
+          class AccessPermissionSetting
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # A principal representing an entity granted access.
+          # @!attribute [rw] audience
+          #   @return [::Google::Apps::Chat::V1::Audience]
+          #     An audience.
+          class Principal
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # [Permission settings](https://support.google.com/chat/answer/13340792)
           # that you can specify when updating an existing named space.
           #
@@ -659,6 +695,24 @@ module Google
         #     users](https://developers.google.com/workspace/chat/space-target-audience).
         #     `access_settings.audience` is not supported with `useAdminAccess`.
         #
+        #     `access_settings.access_permission_settings`: Updates the [access
+        #     permission
+        #     settings](https://support.google.com/chat/answer/11971020) of who can
+        #     discover and join the space where `spaceType` field is `SPACE`. Principals
+        #     allowed to join the space must also be allowed to discover it. To update
+        #     access permission settings for a space, the authenticating user must be a
+        #     space manager or assistant manager and omit all other field masks in the
+        #     request. You can't update this field if the space is in [import
+        #     mode](https://developers.google.com/workspace/chat/import-data-overview).
+        #     To learn more, see [Make a space discoverable to specific
+        #     users](https://developers.google.com/workspace/chat/space-target-audience).
+        #     `access_settings.access_permission_settings` is not supported with
+        #     `useAdminAccess`.
+        #     The supported field masks include:
+        #
+        #     - `access_settings.access_permission_settings.discoverSpaceSetting`
+        #     - `access_settings.access_permission_settings.joinSpaceSetting`
+        #
         #     `permission_settings`: Supports changing the
         #     [permission settings](https://support.google.com/chat/answer/13340792)
         #     of a space.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apps-chat-v1
 version: !ruby/object:Gem::Version
-  version: 0.24.0
+  version: 0.26.0
 platform: ruby
 authors:
 - Google LLC
@@ -85,6 +85,8 @@ files:
 - lib/google/chat/v1/action_status_pb.rb
 - lib/google/chat/v1/annotation_pb.rb
 - lib/google/chat/v1/attachment_pb.rb
+- lib/google/chat/v1/audience_pb.rb
+- lib/google/chat/v1/availability_pb.rb
 - lib/google/chat/v1/chat_service_pb.rb
 - lib/google/chat/v1/chat_service_services_pb.rb
 - lib/google/chat/v1/contextual_addon_pb.rb
@@ -116,6 +118,8 @@ files:
 - proto_docs/google/chat/v1/action_status.rb
 - proto_docs/google/chat/v1/annotation.rb
 - proto_docs/google/chat/v1/attachment.rb
+- proto_docs/google/chat/v1/audience.rb
+- proto_docs/google/chat/v1/availability.rb
 - proto_docs/google/chat/v1/contextual_addon.rb
 - proto_docs/google/chat/v1/deletion_metadata.rb
 - proto_docs/google/chat/v1/event_payload.rb