google-apps-meet-v2beta 0.4.0 → 0.5.0

data/lib/google/apps/meet/v2beta/spaces_service/rest/client.rb

@@ -83,6 +83,14 @@ module Google
 
                   default_config.rpcs.end_active_conference.timeout = 60.0
 
+                  default_config.rpcs.create_member.timeout = 60.0
+
+                  default_config.rpcs.get_member.timeout = 60.0
+
+                  default_config.rpcs.list_members.timeout = 60.0
+
+                  default_config.rpcs.delete_member.timeout = 60.0
+
                   default_config
                 end
                 yield @configure if block_given?
@@ -188,7 +196,6 @@ module Google
               # Service calls
 
               ##
-              # [Developer Preview](https://developers.google.com/workspace/preview).
               # Creates a space.
               #
               # @overload create_space(request, options = nil)
@@ -268,8 +275,10 @@ module Google
               end
 
               ##
-              # [Developer Preview](https://developers.google.com/workspace/preview).
-              # Gets a space by `space_id` or `meeting_code`.
+              # Gets details about a meeting space.
+              #
+              # For an example, see [Get a meeting
+              # space](https://developers.google.com/meet/api/guides/meeting-spaces#get-meeting-space).
               #
               # @overload get_space(request, options = nil)
               #   Pass arguments to `get_space` via a request object, either of type
@@ -288,6 +297,24 @@ module Google
               #
               #   @param name [::String]
               #     Required. Resource name of the space.
+              #
+              #     Format: `spaces/{space}` or `spaces/{meetingCode}`.
+              #
+              #     `{space}` is the resource identifier for the space. It's a unique,
+              #     server-generated ID and is case sensitive. For example, `jQCFfuBOdN5z`.
+              #
+              #     `{meetingCode}` is an alias for the space. It's a typeable, unique
+              #     character string and is non-case sensitive. For example, `abc-mnop-xyz`.
+              #     The maximum length is 128 characters.
+              #
+              #     A `meetingCode` shouldn't be stored long term as it can become
+              #     dissociated from a meeting space and can be reused for different meeting
+              #     spaces in the future. Generally, a `meetingCode` expires 365 days after
+              #     last use. For more information, see [Learn about meeting codes in Google
+              #     Meet](https://support.google.com/meet/answer/10710509).
+              #
+              #     For more information, see [How Meet identifies a meeting
+              #     space](https://developers.google.com/meet/api/guides/meeting-spaces#identify-meeting-space).
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Apps::Meet::V2beta::Space]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -347,8 +374,10 @@ module Google
               end
 
               ##
-              # [Developer Preview](https://developers.google.com/workspace/preview).
-              # Updates a space.
+              # Updates details about a meeting space.
+              #
+              # For an example, see [Update a meeting
+              # space](https://developers.google.com/meet/api/guides/meeting-spaces#update-meeting-space).
               #
               # @overload update_space(request, options = nil)
               #   Pass arguments to `update_space` via a request object, either of type
@@ -369,9 +398,11 @@ module Google
               #     Required. Space to be updated.
               #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
               #     Optional. Field mask used to specify the fields to be updated in the space.
-              #     If update_mask isn't provided, it defaults to '*' and updates all
-              #     fields provided in the request, including deleting fields not set in the
+              #     If update_mask isn't provided(not set, set with empty paths, or only has ""
+              #     as paths), it defaults to update all fields provided with values in the
               #     request.
+              #     Using "*" as update_mask will update all fields, including deleting fields
+              #     not set in the request.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Apps::Meet::V2beta::Space]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -431,8 +462,10 @@ module Google
               end
 
               ##
-              # [Developer Preview](https://developers.google.com/workspace/preview).
-              # Ends an active conference (if there is one).
+              # Ends an active conference (if there's one).
+              #
+              # For an example, see [End active
+              # conference](https://developers.google.com/meet/api/guides/meeting-spaces#end-active-conference).
               #
               # @overload end_active_conference(request, options = nil)
               #   Pass arguments to `end_active_conference` via a request object, either of type
@@ -451,6 +484,14 @@ module Google
               #
               #   @param name [::String]
               #     Required. Resource name of the space.
+              #
+              #     Format: `spaces/{space}`.
+              #
+              #     `{space}` is the resource identifier for the space. It's a unique,
+              #     server-generated ID and is case sensitive. For example, `jQCFfuBOdN5z`.
+              #
+              #     For more information, see [How Meet identifies a meeting
+              #     space](https://developers.google.com/meet/api/guides/meeting-spaces#identify-meeting-space).
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Protobuf::Empty]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -509,6 +550,352 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # [Developer Preview](https://developers.google.com/workspace/preview):
+              # Create a member.
+              #
+              # This API supports the `fields` parameter in
+              # [SystemParameterContext](https://cloud.google.com/apis/docs/system-parameters).
+              # When the `fields` parameter is omitted, this API response will default to
+              # "name,email,role,user".
+              #
+              # @overload create_member(request, options = nil)
+              #   Pass arguments to `create_member` via a request object, either of type
+              #   {::Google::Apps::Meet::V2beta::CreateMemberRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Apps::Meet::V2beta::CreateMemberRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload create_member(parent: nil, member: nil)
+              #   Pass arguments to `create_member` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param parent [::String]
+              #     Required. Format: spaces/\\{space}
+              #   @param member [::Google::Apps::Meet::V2beta::Member, ::Hash]
+              #     Required. The member to be created.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Apps::Meet::V2beta::Member]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Apps::Meet::V2beta::Member]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/apps/meet/v2beta"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Apps::Meet::V2beta::SpacesService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Apps::Meet::V2beta::CreateMemberRequest.new
+              #
+              #   # Call the create_member method.
+              #   result = client.create_member request
+              #
+              #   # The returned object is of type Google::Apps::Meet::V2beta::Member.
+              #   p result
+              #
+              def create_member request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Apps::Meet::V2beta::CreateMemberRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.create_member.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Apps::Meet::V2beta::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.create_member.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.create_member.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @spaces_service_stub.create_member request, options do |result, operation|
+                  yield result, operation if block_given?
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # [Developer Preview](https://developers.google.com/workspace/preview):
+              # Get a member.
+              #
+              # This API supports the `fields` parameter in
+              # [SystemParameterContext](https://cloud.google.com/apis/docs/system-parameters).
+              # When the `fields` parameter is omitted, this API response will default to
+              # "name,email,role,user".
+              #
+              # @overload get_member(request, options = nil)
+              #   Pass arguments to `get_member` via a request object, either of type
+              #   {::Google::Apps::Meet::V2beta::GetMemberRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Apps::Meet::V2beta::GetMemberRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload get_member(name: nil)
+              #   Pass arguments to `get_member` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param name [::String]
+              #     Required. Format: “spaces/\\{space}/members/\\{member}”
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Apps::Meet::V2beta::Member]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Apps::Meet::V2beta::Member]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/apps/meet/v2beta"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Apps::Meet::V2beta::SpacesService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Apps::Meet::V2beta::GetMemberRequest.new
+              #
+              #   # Call the get_member method.
+              #   result = client.get_member request
+              #
+              #   # The returned object is of type Google::Apps::Meet::V2beta::Member.
+              #   p result
+              #
+              def get_member request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Apps::Meet::V2beta::GetMemberRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.get_member.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Apps::Meet::V2beta::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.get_member.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.get_member.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @spaces_service_stub.get_member request, options do |result, operation|
+                  yield result, operation if block_given?
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # [Developer Preview](https://developers.google.com/workspace/preview):
+              # List members.
+              #
+              # This API supports the `fields` parameter in
+              # [SystemParameterContext](https://cloud.google.com/apis/docs/system-parameters).
+              # When the `fields` parameter is omitted this API response will default to
+              # "name,email,role,user".
+              #
+              # @overload list_members(request, options = nil)
+              #   Pass arguments to `list_members` via a request object, either of type
+              #   {::Google::Apps::Meet::V2beta::ListMembersRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Apps::Meet::V2beta::ListMembersRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload list_members(parent: nil, page_size: nil, page_token: nil)
+              #   Pass arguments to `list_members` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param parent [::String]
+              #     Required. Format: spaces/\\{space}
+              #   @param page_size [::Integer]
+              #     Optional. Maximum number of members to return. The service might return
+              #     fewer than this value. If unspecified, at most 25 members are returned. The
+              #     maximum value is 100; values above 100 are coerced to 100. Maximum might
+              #     change in the future.
+              #   @param page_token [::String]
+              #     Optional. Page token returned from previous List Call.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Apps::Meet::V2beta::Member>]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Gapic::Rest::PagedEnumerable<::Google::Apps::Meet::V2beta::Member>]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/apps/meet/v2beta"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Apps::Meet::V2beta::SpacesService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Apps::Meet::V2beta::ListMembersRequest.new
+              #
+              #   # Call the list_members method.
+              #   result = client.list_members request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Apps::Meet::V2beta::Member.
+              #     p item
+              #   end
+              #
+              def list_members request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Apps::Meet::V2beta::ListMembersRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.list_members.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Apps::Meet::V2beta::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.list_members.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.list_members.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @spaces_service_stub.list_members request, options do |result, operation|
+                  result = ::Gapic::Rest::PagedEnumerable.new @spaces_service_stub, :list_members, "members", request, result, options
+                  yield result, operation if block_given?
+                  throw :response, result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # [Developer Preview](https://developers.google.com/workspace/preview):
+              # Delete the member who was previously assigned roles in the space.
+              #
+              # @overload delete_member(request, options = nil)
+              #   Pass arguments to `delete_member` via a request object, either of type
+              #   {::Google::Apps::Meet::V2beta::DeleteMemberRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Apps::Meet::V2beta::DeleteMemberRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload delete_member(name: nil)
+              #   Pass arguments to `delete_member` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param name [::String]
+              #     Required. Format: “spaces/\\{space}/members/\\{member}”
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Protobuf::Empty]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Protobuf::Empty]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/apps/meet/v2beta"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Apps::Meet::V2beta::SpacesService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Apps::Meet::V2beta::DeleteMemberRequest.new
+              #
+              #   # Call the delete_member method.
+              #   result = client.delete_member request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
+              def delete_member request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Apps::Meet::V2beta::DeleteMemberRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.delete_member.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Apps::Meet::V2beta::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.delete_member.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.delete_member.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @spaces_service_stub.delete_member request, options do |result, operation|
+                  yield result, operation if block_given?
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Configuration class for the SpacesService REST API.
               #
@@ -551,6 +938,13 @@ module Google
               #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
               #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
               #    *  (`nil`) indicating no credentials
+              #
+              #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+              #   external source for authentication to Google Cloud, you must validate it before
+              #   providing it to a Google API client library. Providing an unvalidated credential
+              #   configuration to Google APIs can compromise the security of your systems and data.
+              #   For more information, refer to [Validate credential configurations from external
+              #   sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
               #   @return [::Object]
               # @!attribute [rw] scope
               #   The OAuth scopes
@@ -668,6 +1062,26 @@ module Google
                   # @return [::Gapic::Config::Method]
                   #
                   attr_reader :end_active_conference
+                  ##
+                  # RPC-specific configuration for `create_member`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :create_member
+                  ##
+                  # RPC-specific configuration for `get_member`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :get_member
+                  ##
+                  # RPC-specific configuration for `list_members`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :list_members
+                  ##
+                  # RPC-specific configuration for `delete_member`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :delete_member
 
                   # @private
                   def initialize parent_rpcs = nil
@@ -679,6 +1093,14 @@ module Google
                     @update_space = ::Gapic::Config::Method.new update_space_config
                     end_active_conference_config = parent_rpcs.end_active_conference if parent_rpcs.respond_to? :end_active_conference
                     @end_active_conference = ::Gapic::Config::Method.new end_active_conference_config
+                    create_member_config = parent_rpcs.create_member if parent_rpcs.respond_to? :create_member
+                    @create_member = ::Gapic::Config::Method.new create_member_config
+                    get_member_config = parent_rpcs.get_member if parent_rpcs.respond_to? :get_member
+                    @get_member = ::Gapic::Config::Method.new get_member_config
+                    list_members_config = parent_rpcs.list_members if parent_rpcs.respond_to? :list_members
+                    @list_members = ::Gapic::Config::Method.new list_members_config
+                    delete_member_config = parent_rpcs.delete_member if parent_rpcs.respond_to? :delete_member
+                    @delete_member = ::Gapic::Config::Method.new delete_member_config
 
                     yield self if block_given?
                   end