google-apis-healthcare_v1beta1 0.63.0 → 0.64.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6dd1a7b2281688d59ad62cac008717d8bb065c4a61e6253825896368cbe0e38
-  data.tar.gz: 01e6b45df447b7dd7517685fb49dd646b4f43b77ab4ce64328d3d69fd6efbc9d
+  metadata.gz: 59a773a1c1b8ab09ac70379834d54a1ffbea9e39cce0ef454d89170926f844c3
+  data.tar.gz: 2474550488557db1c92f7cd64406b0c78015197e87eab88180f215d2be1bed77
 SHA512:
-  metadata.gz: a0cd97bd660d806843839dc7407916bb7cbf528c9ceb22dd32019e31b48af35814f9b3cbb1137f9459ef3e06c67791efda80bf9ac4faa585603a1d2b0e7592d8
-  data.tar.gz: 71850d20f3193e83b597ad8dc5f3df9ce428a4c3650ac3a543e13ec47b0cdae2fea9323a82d4559c4478c86387b5cddeca96564d9f0545aaeace38f9523c2519
+  metadata.gz: 694f9d301318d1a5693749641fb0bd3773ee40240488cf1215f29e71c4d27df4a16ae889d99307934e975794562fe05d8f4147fae5eb3940c51ff7757214df47
+  data.tar.gz: cb7afd95ca4aefbfa4ad99a5dca6ca45cb6261696d1e4e962535df66b3458184cff9db859dc4f135d42f6633663a3573a367f84e4edc655a4d0857bc58985b75

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-healthcare_v1beta1
 
+### v0.64.0 (2024-02-11)
+
+* Regenerated from discovery document revision 20240130
+
 ### v0.63.0 (2024-01-28)
 
 * Regenerated from discovery document revision 20240112

data/lib/google/apis/healthcare_v1beta1/classes.rb

@@ -277,9 +277,9 @@ module Google
         # @return [Google::Apis::HealthcareV1beta1::ImageAnnotation]
         attr_accessor :image_annotation
       
-        # Resource name of the Annotation, of the form `projects/`project_id`/locations/`
-        # location_id`/datasets/`dataset_id`/annotationStores/`annotation_store_id`/
-        # annotations/`annotation_id``.
+        # Identifier. Resource name of the Annotation, of the form `projects/`project_id`
+        # /locations/`location_id`/datasets/`dataset_id`/annotationStores/`
+        # annotation_store_id`/annotations/`annotation_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -377,8 +377,8 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Resource name of the Annotation store, of the form `projects/`project_id`/
-        # locations/`location_id`/datasets/`dataset_id`/annotationStores/`
+        # Identifier. Resource name of the Annotation store, of the form `projects/`
+        # project_id`/locations/`location_id`/datasets/`dataset_id`/annotationStores/`
         # annotation_store_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -839,7 +839,10 @@ module Google
         attr_accessor :members
       
         # Role that is assigned to the list of `members`, or principals. For example, `
-        # roles/viewer`, `roles/editor`, or `roles/owner`.
+        # roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM
+        # roles and permissions, see the [IAM documentation](https://cloud.google.com/
+        # iam/docs/roles-overview). For a list of the available pre-defined roles, see [
+        # here](https://cloud.google.com/iam/docs/understanding-roles).
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -1178,9 +1181,9 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :metadata
       
-        # Resource name of the Consent, of the form `projects/`project_id`/locations/`
-        # location_id`/datasets/`dataset_id`/consentStores/`consent_store_id`/consents/`
-        # consent_id``. Cannot be changed after creation.
+        # Identifier. Resource name of the Consent, of the form `projects/`project_id`/
+        # locations/`location_id`/datasets/`dataset_id`/consentStores/`consent_store_id`/
+        # consents/`consent_id``. Cannot be changed after creation.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1237,6 +1240,41 @@ module Google
         end
       end
       
+      # The accessor scope that describes who can access, for what purpose, in which
+      # environment.
+      class ConsentAccessorScope
+        include Google::Apis::Core::Hashable
+      
+        # An individual, group, or access role that identifies the accessor or a
+        # characteristic of the accessor. This can be a resource ID (such as ``
+        # resourceType`/`id``) or an external URI. This value must be present.
+        # Corresponds to the JSON property `actor`
+        # @return [String]
+        attr_accessor :actor
+      
+        # An abstract identifier that describes the environment or conditions under
+        # which the accessor is acting. Can be “*” if it applies to all environments.
+        # Corresponds to the JSON property `environment`
+        # @return [String]
+        attr_accessor :environment
+      
+        # The intent of data use. Can be “*” if it applies to all purposes.
+        # Corresponds to the JSON property `purpose`
+        # @return [String]
+        attr_accessor :purpose
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @actor = args[:actor] if args.key?(:actor)
+          @environment = args[:environment] if args.key?(:environment)
+          @purpose = args[:purpose] if args.key?(:purpose)
+        end
+      end
+      
       # Documentation of a user's consent.
       class ConsentArtifact
         include Google::Apis::Core::Hashable
@@ -1568,8 +1606,8 @@ module Google
       class Dataset
         include Google::Apis::Core::Hashable
       
-        # Resource name of the dataset, of the form `projects/`project_id`/locations/`
-        # location_id`/datasets/`dataset_id``.
+        # Identifier. Resource name of the dataset, of the form `projects/`project_id`/
+        # locations/`location_id`/datasets/`dataset_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2357,9 +2395,9 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :golden_info_type_mapping
       
-        # The Annotation store to use as ground truth, in the format of `projects/`
-        # project_id`/locations/`location_id`/datasets/`dataset_id`/annotationStores/`
-        # annotation_store_id``.
+        # Required. The Annotation store to use as ground truth, in the format of `
+        # projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        # annotationStores/`annotation_store_id``.
         # Corresponds to the JSON property `goldenStore`
         # @return [String]
         attr_accessor :golden_store
@@ -2486,6 +2524,138 @@ module Google
         end
       end
       
+      # The enforcing consent's metadata.
+      class ExplainDataAccessConsentInfo
+        include Google::Apis::Core::Hashable
+      
+        # The compartment base resources that matched a cascading policy. Each resource
+        # has the following format: `projects/`project_id`/locations/`location_id`/
+        # datasets/`dataset_id`/fhirStores/`fhir_store_id`/fhir/`resource_type`/`
+        # resource_id``
+        # Corresponds to the JSON property `cascadeOrigins`
+        # @return [Array<String>]
+        attr_accessor :cascade_origins
+      
+        # The resource name of this consent resource. Format: `projects/`projectId`/
+        # datasets/`datasetId`/fhirStores/`fhirStoreId`/fhir/`resourceType`/`id``.
+        # Corresponds to the JSON property `consentResource`
+        # @return [String]
+        attr_accessor :consent_resource
+      
+        # Last enforcement timestamp of this consent resource.
+        # Corresponds to the JSON property `enforcementTime`
+        # @return [String]
+        attr_accessor :enforcement_time
+      
+        # A list of all the matching accessor scopes of this consent policy that
+        # enforced ExplainDataAccessConsentScope.accessor_scope.
+        # Corresponds to the JSON property `matchingAccessorScopes`
+        # @return [Array<Google::Apis::HealthcareV1beta1::ConsentAccessorScope>]
+        attr_accessor :matching_accessor_scopes
+      
+        # The patient owning the consent (only applicable for patient consents), in the
+        # format: `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        # fhirStores/`fhir_store_id`/fhir/Patient/`patient_id``
+        # Corresponds to the JSON property `patientConsentOwner`
+        # @return [String]
+        attr_accessor :patient_consent_owner
+      
+        # The policy type of consent resource (e.g. PATIENT, ADMIN).
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # The consent's variant combinations. A single consent may have multiple
+        # variants.
+        # Corresponds to the JSON property `variants`
+        # @return [Array<String>]
+        attr_accessor :variants
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cascade_origins = args[:cascade_origins] if args.key?(:cascade_origins)
+          @consent_resource = args[:consent_resource] if args.key?(:consent_resource)
+          @enforcement_time = args[:enforcement_time] if args.key?(:enforcement_time)
+          @matching_accessor_scopes = args[:matching_accessor_scopes] if args.key?(:matching_accessor_scopes)
+          @patient_consent_owner = args[:patient_consent_owner] if args.key?(:patient_consent_owner)
+          @type = args[:type] if args.key?(:type)
+          @variants = args[:variants] if args.key?(:variants)
+        end
+      end
+      
+      # A single consent scope that provides info on who has access to the requested
+      # resource scope for a particular purpose and environment, enforced by which
+      # consent.
+      class ExplainDataAccessConsentScope
+        include Google::Apis::Core::Hashable
+      
+        # The accessor scope that describes who can access, for what purpose, in which
+        # environment.
+        # Corresponds to the JSON property `accessorScope`
+        # @return [Google::Apis::HealthcareV1beta1::ConsentAccessorScope]
+        attr_accessor :accessor_scope
+      
+        # Whether the current consent scope is permitted or denied access on the
+        # requested resource.
+        # Corresponds to the JSON property `decision`
+        # @return [String]
+        attr_accessor :decision
+      
+        # Metadata of the consent resources that enforce the consent scope's access.
+        # Corresponds to the JSON property `enforcingConsents`
+        # @return [Array<Google::Apis::HealthcareV1beta1::ExplainDataAccessConsentInfo>]
+        attr_accessor :enforcing_consents
+      
+        # Other consent scopes that created exceptions within this scope.
+        # Corresponds to the JSON property `exceptions`
+        # @return [Array<Google::Apis::HealthcareV1beta1::ExplainDataAccessConsentScope>]
+        attr_accessor :exceptions
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @accessor_scope = args[:accessor_scope] if args.key?(:accessor_scope)
+          @decision = args[:decision] if args.key?(:decision)
+          @enforcing_consents = args[:enforcing_consents] if args.key?(:enforcing_consents)
+          @exceptions = args[:exceptions] if args.key?(:exceptions)
+        end
+      end
+      
+      # List of consent scopes that are applicable to the explained access on a given
+      # resource.
+      class ExplainDataAccessResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of applicable consent scopes. Sorted in order of actor such that scopes
+        # belonging to the same actor will be adjacent to each other in the list.
+        # Corresponds to the JSON property `consentScopes`
+        # @return [Array<Google::Apis::HealthcareV1beta1::ExplainDataAccessConsentScope>]
+        attr_accessor :consent_scopes
+      
+        # Warnings associated with this response. It inform user with exceeded scope
+        # limit errors.
+        # Corresponds to the JSON property `warning`
+        # @return [String]
+        attr_accessor :warning
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @consent_scopes = args[:consent_scopes] if args.key?(:consent_scopes)
+          @warning = args[:warning] if args.key?(:warning)
+        end
+      end
+      
       # Request to export Annotations. The export operation is not atomic. If a
       # failure occurs, any annotations already exported are not removed.
       class ExportAnnotationsRequest
@@ -3032,11 +3202,9 @@ module Google
         attr_accessor :disable_resource_versioning
         alias_method :disable_resource_versioning?, :disable_resource_versioning
       
-        # Optional. Whether to allow the [ImportResourcesHistory] and [ExecuteBundle]
-        # APIs to accept history bundles, and directly insert and overwrite historical
-        # resource versions into the FHIR store. Importing resource histories creates
-        # resource interactions that have occurred in the past that clients might not
-        # allow. If set to false, using history bundles fail with an error.
+        # Optional. Whether to allow ExecuteBundle to accept history bundles, and
+        # directly insert and overwrite historical resource versions into the FHIR store.
+        # If set to false, using history bundles fails with an error.
         # Corresponds to the JSON property `enableHistoryModifications`
         # @return [Boolean]
         attr_accessor :enable_history_modifications
@@ -4155,8 +4323,9 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Resource name of the HL7v2 store, of the form `projects/`project_id`/locations/
-        # `location_id`/datasets/`dataset_id`/hl7V2Stores/`hl7v2_store_id``.
+        # Identifier. Resource name of the HL7v2 store, of the form `projects/`
+        # project_id`/locations/`location_id`/datasets/`dataset_id`/hl7V2Stores/`
+        # hl7v2_store_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -5247,7 +5416,7 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # Raw message bytes.
+        # Required. Raw message bytes.
         # Corresponds to the JSON property `data`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -5269,9 +5438,9 @@ module Google
         # @return [String]
         attr_accessor :message_type
       
-        # Resource name of the Message, of the form `projects/`project_id`/locations/`
-        # location_id`/datasets/`dataset_id`/hl7V2Stores/`hl7_v2_store_id`/messages/`
-        # message_id``. Assigned by the server.
+        # Output only. Resource name of the Message, of the form `projects/`project_id`/
+        # locations/`location_id`/datasets/`dataset_id`/hl7V2Stores/`hl7_v2_store_id`/
+        # messages/`message_id``. Assigned by the server.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name

data/lib/google/apis/healthcare_v1beta1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module HealthcareV1beta1
       # Version of the google-apis-healthcare_v1beta1 gem
-      GEM_VERSION = "0.63.0"
+      GEM_VERSION = "0.64.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.13.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240112"
+      REVISION = "20240130"
     end
   end
 end

data/lib/google/apis/healthcare_v1beta1/representations.rb

@@ -238,6 +238,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ConsentAccessorScope
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ConsentArtifact
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -448,6 +454,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ExplainDataAccessConsentInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ExplainDataAccessConsentScope
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ExplainDataAccessResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ExportAnnotationsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1646,6 +1670,15 @@ module Google
         end
       end
       
+      class ConsentAccessorScope
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :actor, as: 'actor'
+          property :environment, as: 'environment'
+          property :purpose, as: 'purpose'
+        end
+      end
+      
       class ConsentArtifact
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1996,6 +2029,42 @@ module Google
         end
       end
       
+      class ExplainDataAccessConsentInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :cascade_origins, as: 'cascadeOrigins'
+          property :consent_resource, as: 'consentResource'
+          property :enforcement_time, as: 'enforcementTime'
+          collection :matching_accessor_scopes, as: 'matchingAccessorScopes', class: Google::Apis::HealthcareV1beta1::ConsentAccessorScope, decorator: Google::Apis::HealthcareV1beta1::ConsentAccessorScope::Representation
+      
+          property :patient_consent_owner, as: 'patientConsentOwner'
+          property :type, as: 'type'
+          collection :variants, as: 'variants'
+        end
+      end
+      
+      class ExplainDataAccessConsentScope
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :accessor_scope, as: 'accessorScope', class: Google::Apis::HealthcareV1beta1::ConsentAccessorScope, decorator: Google::Apis::HealthcareV1beta1::ConsentAccessorScope::Representation
+      
+          property :decision, as: 'decision'
+          collection :enforcing_consents, as: 'enforcingConsents', class: Google::Apis::HealthcareV1beta1::ExplainDataAccessConsentInfo, decorator: Google::Apis::HealthcareV1beta1::ExplainDataAccessConsentInfo::Representation
+      
+          collection :exceptions, as: 'exceptions', class: Google::Apis::HealthcareV1beta1::ExplainDataAccessConsentScope, decorator: Google::Apis::HealthcareV1beta1::ExplainDataAccessConsentScope::Representation
+      
+        end
+      end
+      
+      class ExplainDataAccessResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :consent_scopes, as: 'consentScopes', class: Google::Apis::HealthcareV1beta1::ExplainDataAccessConsentScope, decorator: Google::Apis::HealthcareV1beta1::ExplainDataAccessConsentScope::Representation
+      
+          property :warning, as: 'warning'
+        end
+      end
+      
       class ExportAnnotationsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/healthcare_v1beta1/service.rb

@@ -128,12 +128,12 @@ module Google
         # interface which returns either an `Operation.response` which contains a
         # Dataset or `Operation.error`. The metadata field type is OperationMetadata.
         # @param [String] parent
-        #   The name of the project where the server creates the dataset. For example, `
-        #   projects/`project_id`/locations/`location_id``.
+        #   Required. The name of the project where the server creates the dataset. For
+        #   example, `projects/`project_id`/locations/`location_id``.
         # @param [Google::Apis::HealthcareV1beta1::Dataset] dataset_object
         # @param [String] dataset_id
-        #   The ID of the dataset that is being created. The string must match the
-        #   following regex: `[\p`L`\p`N`_\-\.]`1,256``.
+        #   Required. The ID of the dataset that is being created. The string must match
+        #   the following regex: `[\p`L`\p`N`_\-\.]`1,256``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -209,8 +209,8 @@ module Google
         # Deleting a dataset does not affect the sources from which the dataset was
         # imported (if any).
         # @param [String] name
-        #   The name of the dataset to delete. For example, `projects/`project_id`/
-        #   locations/`location_id`/datasets/`dataset_id``.
+        #   Required. The name of the dataset to delete. For example, `projects/`
+        #   project_id`/locations/`location_id`/datasets/`dataset_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -240,8 +240,8 @@ module Google
         
         # Gets any metadata associated with a dataset.
         # @param [String] name
-        #   The name of the dataset to read. For example, `projects/`project_id`/locations/
-        #   `location_id`/datasets/`dataset_id``.
+        #   Required. The name of the dataset to read. For example, `projects/`project_id`/
+        #   locations/`location_id`/datasets/`dataset_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -316,8 +316,8 @@ module Google
         
         # Lists the health datasets in the current project.
         # @param [String] parent
-        #   The name of the project whose datasets should be listed. For example, `
-        #   projects/`project_id`/locations/`location_id``.
+        #   Required. The name of the project whose datasets should be listed. For example,
+        #   `projects/`project_id`/locations/`location_id``.
         # @param [Fixnum] page_size
         #   The maximum number of items to return. If not specified, 100 is used. May not
         #   be larger than 1000.
@@ -354,13 +354,13 @@ module Google
         
         # Updates dataset metadata.
         # @param [String] name
-        #   Resource name of the dataset, of the form `projects/`project_id`/locations/`
-        #   location_id`/datasets/`dataset_id``.
+        #   Identifier. Resource name of the dataset, of the form `projects/`project_id`/
+        #   locations/`location_id`/datasets/`dataset_id``.
         # @param [Google::Apis::HealthcareV1beta1::Dataset] dataset_object
         # @param [String] update_mask
-        #   The update mask applies to the resource. For the `FieldMask` definition, see
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
-        #   fieldmask
+        #   Required. The update mask applies to the resource. For the `FieldMask`
+        #   definition, see https://developers.google.com/protocol-buffers/docs/reference/
+        #   google.protobuf#fieldmask
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -469,11 +469,11 @@ module Google
         
         # Creates a new Annotation store within the parent dataset.
         # @param [String] parent
-        #   The name of the dataset this Annotation store belongs to.
+        #   Required. The name of the dataset this Annotation store belongs to.
         # @param [Google::Apis::HealthcareV1beta1::AnnotationStore] annotation_store_object
         # @param [String] annotation_store_id
-        #   The ID of the Annotation store that is being created. The string must match
-        #   the following regex: `[\p`L`\p`N`_\-\.]`1,256``.
+        #   Required. The ID of the Annotation store that is being created. The string
+        #   must match the following regex: `[\p`L`\p`N`_\-\.]`1,256``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -507,7 +507,7 @@ module Google
         # Deletes the specified Annotation store and removes all annotations that are
         # contained within it.
         # @param [String] name
-        #   The resource name of the Annotation store to delete.
+        #   Required. The resource name of the Annotation store to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -542,8 +542,8 @@ module Google
         # error logs in Cloud Logging](https://cloud.google.com/healthcare/docs/how-tos/
         # logging)).
         # @param [String] name
-        #   The Annotation store to compare against `golden_store`, in the format of `
-        #   projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   Required. The Annotation store to compare against `golden_store`, in the
+        #   format of `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   annotationStores/`annotation_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::EvaluateAnnotationStoreRequest] evaluate_annotation_store_request_object
         # @param [String] fields
@@ -581,8 +581,8 @@ module Google
         # OperationMetadata. Errors are logged to Cloud Logging (see [Viewing error logs
         # in Cloud Logging](https://cloud.google.com/healthcare/docs/how-tos/logging)).
         # @param [String] name
-        #   The name of the Annotation store to export annotations to, in the format of `
-        #   projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   Required. The name of the Annotation store to export annotations to, in the
+        #   format of `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   annotationStores/`annotation_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::ExportAnnotationsRequest] export_annotations_request_object
         # @param [String] fields
@@ -616,7 +616,7 @@ module Google
         
         # Gets the specified Annotation store or returns NOT_FOUND if it does not exist.
         # @param [String] name
-        #   The resource name of the Annotation store to get.
+        #   Required. The resource name of the Annotation store to get.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -696,9 +696,9 @@ module Google
         # logged to Cloud Logging (see [Viewing error logs in Cloud Logging](https://
         # cloud.google.com/healthcare/docs/how-tos/logging)).
         # @param [String] name
-        #   The name of the Annotation store to which the server imports annotations, in
-        #   the format `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`
-        #   /annotationStores/`annotation_store_id``.
+        #   Required. The name of the Annotation store to which the server imports
+        #   annotations, in the format `projects/`project_id`/locations/`location_id`/
+        #   datasets/`dataset_id`/annotationStores/`annotation_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::ImportAnnotationsRequest] import_annotations_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -731,7 +731,7 @@ module Google
         
         # Lists the Annotation stores in the given dataset for a source store.
         # @param [String] parent
-        #   Name of the dataset.
+        #   Required. Name of the dataset.
         # @param [String] filter
         #   Restricts stores returned to those matching a filter. The following syntax is
         #   available: * A string field value can be written as text inside quotation
@@ -792,14 +792,14 @@ module Google
         
         # Updates the specified Annotation store.
         # @param [String] name
-        #   Resource name of the Annotation store, of the form `projects/`project_id`/
-        #   locations/`location_id`/datasets/`dataset_id`/annotationStores/`
+        #   Identifier. Resource name of the Annotation store, of the form `projects/`
+        #   project_id`/locations/`location_id`/datasets/`dataset_id`/annotationStores/`
         #   annotation_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::AnnotationStore] annotation_store_object
         # @param [String] update_mask
-        #   The update mask applies to the resource. For the `FieldMask` definition, see
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
-        #   fieldmask
+        #   Required. The update mask applies to the resource. For the `FieldMask`
+        #   definition, see https://developers.google.com/protocol-buffers/docs/reference/
+        #   google.protobuf#fieldmask
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -910,9 +910,9 @@ module Google
         # the same source more than once since a unique ID is assigned to each record by
         # this service.
         # @param [String] parent
-        #   The name of the Annotation store this annotation belongs to. For example, `
-        #   projects/my-project/locations/us-central1/datasets/mydataset/annotationStores/
-        #   myannotationstore`.
+        #   Required. The name of the Annotation store this annotation belongs to. For
+        #   example, `projects/my-project/locations/us-central1/datasets/mydataset/
+        #   annotationStores/myannotationstore`.
         # @param [Google::Apis::HealthcareV1beta1::Annotation] annotation_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -945,7 +945,7 @@ module Google
         
         # Deletes an Annotation or returns NOT_FOUND if it does not exist.
         # @param [String] name
-        #   The resource name of the Annotation to delete.
+        #   Required. The resource name of the Annotation to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -975,7 +975,7 @@ module Google
         
         # Gets an Annotation.
         # @param [String] name
-        #   The resource name of the Annotation to retrieve.
+        #   Required. The resource name of the Annotation to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1005,7 +1005,7 @@ module Google
         
         # Lists the Annotations in the given Annotation store for a source resource.
         # @param [String] parent
-        #   Name of the Annotation store to retrieve Annotations from.
+        #   Required. Name of the Annotation store to retrieve Annotations from.
         # @param [String] filter
         #   Restricts Annotations returned to those matching a filter. Functions available
         #   for filtering are: - `matches("annotation_source.cloud_healthcare_source.name",
@@ -1054,14 +1054,14 @@ module Google
         
         # Updates the Annotation.
         # @param [String] name
-        #   Resource name of the Annotation, of the form `projects/`project_id`/locations/`
-        #   location_id`/datasets/`dataset_id`/annotationStores/`annotation_store_id`/
-        #   annotations/`annotation_id``.
+        #   Identifier. Resource name of the Annotation, of the form `projects/`project_id`
+        #   /locations/`location_id`/datasets/`dataset_id`/annotationStores/`
+        #   annotation_store_id`/annotations/`annotation_id``.
         # @param [Google::Apis::HealthcareV1beta1::Annotation] annotation_object
         # @param [String] update_mask
-        #   The update mask applies to the resource. For the `FieldMask` definition, see
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
-        #   fieldmask
+        #   Required. The update mask applies to the resource. For the `FieldMask`
+        #   definition, see https://developers.google.com/protocol-buffers/docs/reference/
+        #   google.protobuf#fieldmask
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2223,9 +2223,9 @@ module Google
         # revision with the changes. A FAILED_PRECONDITION error occurs if the latest
         # revision of the specified Consent is in the `REJECTED` or `REVOKED` state.
         # @param [String] name
-        #   Resource name of the Consent, of the form `projects/`project_id`/locations/`
-        #   location_id`/datasets/`dataset_id`/consentStores/`consent_store_id`/consents/`
-        #   consent_id``. Cannot be changed after creation.
+        #   Identifier. Resource name of the Consent, of the form `projects/`project_id`/
+        #   locations/`location_id`/datasets/`dataset_id`/consentStores/`consent_store_id`/
+        #   consents/`consent_id``. Cannot be changed after creation.
         # @param [Google::Apis::HealthcareV1beta1::Consent] consent_object
         # @param [String] update_mask
         #   Required. The update mask to apply to the resource. For the `FieldMask`
@@ -4375,6 +4375,43 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Explains all the permitted/denied actor, purpose and environment for a given
+        # resource.
+        # @param [String] name
+        #   Required. The name of the FHIR store to enforce, in the format `projects/`
+        #   project_id`/locations/`location_id`/datasets/`dataset_id`/fhirStores/`
+        #   fhir_store_id``.
+        # @param [String] resource_id
+        #   Required. The ID (``resourceType`/`id``) of the resource to explain data
+        #   access on.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::HealthcareV1beta1::ExplainDataAccessResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::HealthcareV1beta1::ExplainDataAccessResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def explain_project_location_dataset_fhir_store_data_access(name, resource_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+name}:explainDataAccess', options)
+          command.response_representation = Google::Apis::HealthcareV1beta1::ExplainDataAccessResponse::Representation
+          command.response_class = Google::Apis::HealthcareV1beta1::ExplainDataAccessResponse
+          command.params['name'] = name unless name.nil?
+          command.query['resourceId'] = resource_id unless resource_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Export resources from the FHIR store to the specified destination. This method
         # returns an Operation that can be used to track the status of the export by
         # calling GetOperation. Immediate fatal errors appear in the error field, errors
@@ -6162,11 +6199,11 @@ module Google
         
         # Creates a new HL7v2 store within the parent dataset.
         # @param [String] parent
-        #   The name of the dataset this HL7v2 store belongs to.
+        #   Required. The name of the dataset this HL7v2 store belongs to.
         # @param [Google::Apis::HealthcareV1beta1::Hl7V2Store] hl7_v2_store_object
         # @param [String] hl7_v2_store_id
-        #   The ID of the HL7v2 store that is being created. The string must match the
-        #   following regex: `[\p`L`\p`N`_\-\.]`1,256``.
+        #   Required. The ID of the HL7v2 store that is being created. The string must
+        #   match the following regex: `[\p`L`\p`N`_\-\.]`1,256``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -6199,7 +6236,7 @@ module Google
         
         # Deletes the specified HL7v2 store and removes all messages that it contains.
         # @param [String] name
-        #   The resource name of the HL7v2 store to delete.
+        #   Required. The resource name of the HL7v2 store to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -6235,8 +6272,9 @@ module Google
         # response of type ExportMessagesResponse is returned in the response field. The
         # metadata field type for this operation is OperationMetadata.
         # @param [String] name
-        #   The name of the source HL7v2 store, in the format `projects/`project_id`/
-        #   locations/`location_id`/datasets/`dataset_id`/hl7v2Stores/`hl7v2_store_id``
+        #   Required. The name of the source HL7v2 store, in the format `projects/`
+        #   project_id`/locations/`location_id`/datasets/`dataset_id`/hl7v2Stores/`
+        #   hl7v2_store_id``
         # @param [Google::Apis::HealthcareV1beta1::ExportMessagesRequest] export_messages_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -6269,7 +6307,7 @@ module Google
         
         # Gets the specified HL7v2 store.
         # @param [String] name
-        #   The resource name of the HL7v2 store to get.
+        #   Required. The resource name of the HL7v2 store to get.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -6299,8 +6337,8 @@ module Google
         
         # Gets metrics associated with the HL7v2 store.
         # @param [String] name
-        #   The resource name of the HL7v2 store to get metrics for, in the format `
-        #   projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   Required. The resource name of the HL7v2 store to get metrics for, in the
+        #   format `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   hl7V2Stores/`hl7v2_store_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -6399,8 +6437,9 @@ module Google
         # the response field. The metadata field type for this operation is
         # OperationMetadata.
         # @param [String] name
-        #   The name of the target HL7v2 store, in the format `projects/`project_id`/
-        #   locations/`location_id`/datasets/`dataset_id`/hl7v2Stores/`hl7v2_store_id``
+        #   Required. The name of the target HL7v2 store, in the format `projects/`
+        #   project_id`/locations/`location_id`/datasets/`dataset_id`/hl7v2Stores/`
+        #   hl7v2_store_id``
         # @param [Google::Apis::HealthcareV1beta1::ImportMessagesRequest] import_messages_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -6433,7 +6472,7 @@ module Google
         
         # Lists the HL7v2 stores in the given dataset.
         # @param [String] parent
-        #   Name of the dataset.
+        #   Required. Name of the dataset.
         # @param [String] filter
         #   Restricts stores returned to those matching a filter. The following syntax is
         #   available: * A string field value can be written as text inside quotation
@@ -6494,13 +6533,14 @@ module Google
         
         # Updates the HL7v2 store.
         # @param [String] name
-        #   Resource name of the HL7v2 store, of the form `projects/`project_id`/locations/
-        #   `location_id`/datasets/`dataset_id`/hl7V2Stores/`hl7v2_store_id``.
+        #   Identifier. Resource name of the HL7v2 store, of the form `projects/`
+        #   project_id`/locations/`location_id`/datasets/`dataset_id`/hl7V2Stores/`
+        #   hl7v2_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::Hl7V2Store] hl7_v2_store_object
         # @param [String] update_mask
-        #   The update mask applies to the resource. For the `FieldMask` definition, see
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
-        #   fieldmask
+        #   Required. The update mask applies to the resource. For the `FieldMask`
+        #   definition, see https://developers.google.com/protocol-buffers/docs/reference/
+        #   google.protobuf#fieldmask
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -6609,9 +6649,9 @@ module Google
         
         # Gets multiple messages in the given HL7v2 store.
         # @param [String] parent
-        #   Name of the HL7v2 store to retrieve messages from, in the format: `projects/`
-        #   project_id`/locations/`location_id`/datasets/`dataset_id`/hl7v2Stores/`
-        #   hl7v2_store_id``.
+        #   Required. Name of the HL7v2 store to retrieve messages from, in the format: `
+        #   projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   hl7v2Stores/`hl7v2_store_id``.
         # @param [Array<String>, String] ids
         #   The resource id of the HL7v2 messages to retrieve in the format: ``message_id``
         #   , where the full resource name is ``parent`/messages/`message_id`` A maximum
@@ -6654,7 +6694,7 @@ module Google
         # adapter is configured to listen to a Pub/Sub topic, the adapter transmits the
         # message when a notification is received.
         # @param [String] parent
-        #   The name of the HL7v2 store this message belongs to.
+        #   Required. The name of the HL7v2 store this message belongs to.
         # @param [Google::Apis::HealthcareV1beta1::CreateMessageRequest] create_message_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -6687,7 +6727,7 @@ module Google
         
         # Deletes an HL7v2 message.
         # @param [String] name
-        #   The resource name of the HL7v2 message to delete.
+        #   Required. The resource name of the HL7v2 message to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -6717,7 +6757,7 @@ module Google
         
         # Gets an HL7v2 message.
         # @param [String] name
-        #   The resource name of the HL7v2 message to retrieve.
+        #   Required. The resource name of the HL7v2 message to retrieve.
         # @param [String] view
         #   Specifies which parts of the Message resource to return in the response. When
         #   unspecified, equivalent to FULL.
@@ -6759,7 +6799,7 @@ module Google
         # message. This behavior is suitable for replying to HL7v2 interface systems
         # that expect these acknowledgments.
         # @param [String] parent
-        #   The name of the HL7v2 store this message belongs to.
+        #   Required. The name of the HL7v2 store this message belongs to.
         # @param [Google::Apis::HealthcareV1beta1::IngestMessageRequest] ingest_message_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -6795,7 +6835,7 @@ module Google
         # delay between the time a message is created and when it can be found through a
         # filter.
         # @param [String] parent
-        #   Name of the HL7v2 store to retrieve messages from.
+        #   Required. Name of the HL7v2 store to retrieve messages from.
         # @param [String] filter
         #   Restricts messages returned to those matching a filter. The following syntax
         #   is available: * A string field value can be written as text inside quotation
@@ -6886,14 +6926,14 @@ module Google
         # are merged with the existing set of labels. Existing labels with the same keys
         # are updated.
         # @param [String] name
-        #   Resource name of the Message, of the form `projects/`project_id`/locations/`
-        #   location_id`/datasets/`dataset_id`/hl7V2Stores/`hl7_v2_store_id`/messages/`
-        #   message_id``. Assigned by the server.
+        #   Output only. Resource name of the Message, of the form `projects/`project_id`/
+        #   locations/`location_id`/datasets/`dataset_id`/hl7V2Stores/`hl7_v2_store_id`/
+        #   messages/`message_id``. Assigned by the server.
         # @param [Google::Apis::HealthcareV1beta1::Message] message_object
         # @param [String] update_mask
-        #   The update mask applies to the resource. For the `FieldMask` definition, see
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
-        #   fieldmask
+        #   Required. The update mask applies to the resource. For the `FieldMask`
+        #   definition, see https://developers.google.com/protocol-buffers/docs/reference/
+        #   google.protobuf#fieldmask
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-healthcare_v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.63.0
+  version: 0.64.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-28 00:00:00.000000000 Z
+date: 2024-02-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-healthcare_v1beta1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-healthcare_v1beta1/v0.63.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-healthcare_v1beta1/v0.64.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-healthcare_v1beta1
 post_install_message: 
 rdoc_options: []