google-api-client 0.39.4 → 0.41.0

data/generated/google/apis/healthcare_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/healthcare
     module HealthcareV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200501'
+      REVISION = '20200605'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -22,6 +22,151 @@ module Google
   module Apis
     module HealthcareV1beta1
       
+      # An annotation record.
+      class Annotation
+        include Google::Apis::Core::Hashable
+      
+        # AnnotationSource holds the source information of the annotation.
+        # Corresponds to the JSON property `annotationSource`
+        # @return [Google::Apis::HealthcareV1beta1::AnnotationSource]
+        attr_accessor :annotation_source
+      
+        # Additional information for this annotation record, such as annotator and
+        # verifier information or study campaign.
+        # Corresponds to the JSON property `customData`
+        # @return [Hash<String,String>]
+        attr_accessor :custom_data
+      
+        # Image annotation.
+        # Corresponds to the JSON property `imageAnnotation`
+        # @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``.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Resource level annotation.
+        # Corresponds to the JSON property `resourceAnnotation`
+        # @return [Google::Apis::HealthcareV1beta1::ResourceAnnotation]
+        attr_accessor :resource_annotation
+      
+        # A TextAnnotation specifies a text range that includes sensitive information.
+        # Corresponds to the JSON property `textAnnotation`
+        # @return [Google::Apis::HealthcareV1beta1::SensitiveTextAnnotation]
+        attr_accessor :text_annotation
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @annotation_source = args[:annotation_source] if args.key?(:annotation_source)
+          @custom_data = args[:custom_data] if args.key?(:custom_data)
+          @image_annotation = args[:image_annotation] if args.key?(:image_annotation)
+          @name = args[:name] if args.key?(:name)
+          @resource_annotation = args[:resource_annotation] if args.key?(:resource_annotation)
+          @text_annotation = args[:text_annotation] if args.key?(:text_annotation)
+        end
+      end
+      
+      # Specifies how to store annotations during de-identification operation.
+      class AnnotationConfig
+        include Google::Apis::Core::Hashable
+      
+        # The name of the annotation store, in the form
+        # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        # annotationStores/`annotation_store_id``).
+        # * The destination annotation store must be in the same project as the
+        # source data. De-identifying data across multiple projects is not
+        # supported.
+        # * The destination annotation store must exist when using
+        # DeidentifyDicomStore or
+        # DeidentifyFhirStore.
+        # DeidentifyDataset
+        # automatically creates the destination annotation store.
+        # Corresponds to the JSON property `annotationStoreName`
+        # @return [String]
+        attr_accessor :annotation_store_name
+      
+        # If set to true, the sensitive texts are included in
+        # SensitiveTextAnnotation
+        # of Annotation.
+        # Corresponds to the JSON property `storeQuote`
+        # @return [Boolean]
+        attr_accessor :store_quote
+        alias_method :store_quote?, :store_quote
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @annotation_store_name = args[:annotation_store_name] if args.key?(:annotation_store_name)
+          @store_quote = args[:store_quote] if args.key?(:store_quote)
+        end
+      end
+      
+      # AnnotationSource holds the source information of the annotation.
+      class AnnotationSource
+        include Google::Apis::Core::Hashable
+      
+        # Cloud Healthcare API resource.
+        # Corresponds to the JSON property `cloudHealthcareSource`
+        # @return [Google::Apis::HealthcareV1beta1::CloudHealthcareSource]
+        attr_accessor :cloud_healthcare_source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cloud_healthcare_source = args[:cloud_healthcare_source] if args.key?(:cloud_healthcare_source)
+        end
+      end
+      
+      # An Annotation store that can store annotation resources such as
+      # labels and tags for text, image and audio.
+      class AnnotationStore
+        include Google::Apis::Core::Hashable
+      
+        # Optional. User-supplied key-value pairs used to organize Annotation stores.
+        # Label keys must be between 1 and 63 characters long, have a UTF-8 encoding
+        # of maximum 128 bytes, and must conform to the
+        # following PCRE regular expression:
+        # \p`Ll`\p`Lo``0,62`
+        # Label values must be between 1 and 63 characters long, have
+        # a UTF-8 encoding of maximum 128 bytes, and must conform to the
+        # following PCRE regular expression: [\p`Ll`\p`Lo`\p`N`_-]`0,63`
+        # No more than 64 labels can be associated with a given store.
+        # Corresponds to the JSON property `labels`
+        # @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/`annotation_store_id``.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @labels = args[:labels] if args.key?(:labels)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Specifies the audit configuration for a service.
       # The configuration determines which permission types are logged, and what
       # identities, if any, are exempted from logging.
@@ -221,6 +366,31 @@ module Google
         end
       end
       
+      # A bounding polygon for the detected image annotation.
+      class BoundingPoly
+        include Google::Apis::Core::Hashable
+      
+        # A description of this polygon.
+        # Corresponds to the JSON property `label`
+        # @return [String]
+        attr_accessor :label
+      
+        # List of the vertices of this polygon.
+        # Corresponds to the JSON property `vertices`
+        # @return [Array<Google::Apis::HealthcareV1beta1::Vertex>]
+        attr_accessor :vertices
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @label = args[:label] if args.key?(:label)
+          @vertices = args[:vertices] if args.key?(:vertices)
+        end
+      end
+      
       # The request message for Operations.CancelOperation.
       class CancelOperationRequest
         include Google::Apis::Core::Hashable
@@ -253,13 +423,33 @@ module Google
         end
       end
       
+      # Cloud Healthcare API resource.
+      class CloudHealthcareSource
+        include Google::Apis::Core::Hashable
+      
+        # Full path of a Cloud Healthcare API resource.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Creates a new message.
       class CreateMessageRequest
         include Google::Apis::Core::Hashable
       
         # A complete HL7v2 message.
-        # See http://www.hl7.org/implement/standards/index.cfm?ref=common for details
-        # on the standard.
+        # See [Introduction to HL7 Standards]
+        # (https://www.hl7.org/implement/standards/index.cfm?ref=common) for
+        # details on the standard.
         # Corresponds to the JSON property `message`
         # @return [Google::Apis::HealthcareV1beta1::Message]
         attr_accessor :message
@@ -276,8 +466,8 @@ module Google
       
       # Pseudonymization method that generates surrogates via cryptographic hashing.
       # Uses SHA-256.
-      # Outputs a base64-encoded representation of the hashed output
-      # (for example, `L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=`).
+      # Outputs a base64-encoded representation of the hashed output.
+      # For example, `L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=`.
       class CryptoHashConfig
         include Google::Apis::Core::Hashable
       
@@ -306,7 +496,7 @@ module Google
       class Dataset
         include Google::Apis::Core::Hashable
       
-        # Output only. Resource name of the dataset, of the form
+        # 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]
@@ -361,6 +551,11 @@ module Google
       class DeidentifyConfig
         include Google::Apis::Core::Hashable
       
+        # Specifies how to store annotations during de-identification operation.
+        # Corresponds to the JSON property `annotation`
+        # @return [Google::Apis::HealthcareV1beta1::AnnotationConfig]
+        attr_accessor :annotation
+      
         # Specifies the parameters needed for de-identification of DICOM stores.
         # Corresponds to the JSON property `dicom`
         # @return [Google::Apis::HealthcareV1beta1::DicomConfig]
@@ -388,6 +583,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @annotation = args[:annotation] if args.key?(:annotation)
           @dicom = args[:dicom] if args.key?(:dicom)
           @fhir = args[:fhir] if args.key?(:fhir)
           @image = args[:image] if args.key?(:image)
@@ -584,6 +780,25 @@ module Google
         end
       end
       
+      # Contains multiple sensitive information findings for each resource slice.
+      class Detail
+        include Google::Apis::Core::Hashable
+      
+        # 
+        # Corresponds to the JSON property `findings`
+        # @return [Array<Google::Apis::HealthcareV1beta1::Finding>]
+        attr_accessor :findings
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @findings = args[:findings] if args.key?(:findings)
+        end
+      end
+      
       # Specifies the parameters needed for de-identification of DICOM stores.
       class DicomConfig
         include Google::Apis::Core::Hashable
@@ -674,7 +889,7 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Output only. Resource name of the DICOM store, of the form
+        # Resource name of the DICOM store, of the form
         # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         # dicomStores/`dicom_store_id``.
         # Corresponds to the JSON property `name`
@@ -749,6 +964,209 @@ module Google
         end
       end
       
+      # Request to evaluate an Annotation store against a
+      # ground truth [Annotation store].
+      class EvaluateAnnotationStoreRequest
+        include Google::Apis::Core::Hashable
+      
+        # The BigQuery table for export.
+        # Corresponds to the JSON property `bigqueryDestination`
+        # @return [Google::Apis::HealthcareV1beta1::GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination]
+        attr_accessor :bigquery_destination
+      
+        # Optional. InfoType mapping for `eval_store`. Different resources can map to
+        # the same infoType. For example, `PERSON_NAME`, `PERSON`, `NAME`, and
+        # `HUMAN` are different. To map all of these into a single
+        # infoType (such as `PERSON_NAME`), specify the following mapping:
+        # ```
+        # info_type_mapping["PERSON"] = "PERSON_NAME"
+        # info_type_mapping["NAME"] = "PERSON_NAME"
+        # info_type_mapping["HUMAN"] = "PERSON_NAME"
+        # ```
+        # Unmentioned infoTypes, such as `DATE`, are treated as identity
+        # mapping. For example:
+        # ```
+        # info_type_mapping["DATE"] = "DATE"
+        # ```
+        # InfoTypes are case-insensitive.
+        # Corresponds to the JSON property `evalInfoTypeMapping`
+        # @return [Hash<String,String>]
+        attr_accessor :eval_info_type_mapping
+      
+        # Optional. Similar to `eval_info_type_mapping`, infoType mapping for
+        # `golden_store`.
+        # Corresponds to the JSON property `goldenInfoTypeMapping`
+        # @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``.
+        # Corresponds to the JSON property `goldenStore`
+        # @return [String]
+        attr_accessor :golden_store
+      
+        # Specifies how to use infoTypes for evaluation. For example, a user might
+        # only want to evaluate `PERSON`, `LOCATION`, and `AGE`.
+        # Corresponds to the JSON property `infoTypeConfig`
+        # @return [Google::Apis::HealthcareV1beta1::InfoTypeConfig]
+        attr_accessor :info_type_config
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bigquery_destination = args[:bigquery_destination] if args.key?(:bigquery_destination)
+          @eval_info_type_mapping = args[:eval_info_type_mapping] if args.key?(:eval_info_type_mapping)
+          @golden_info_type_mapping = args[:golden_info_type_mapping] if args.key?(:golden_info_type_mapping)
+          @golden_store = args[:golden_store] if args.key?(:golden_store)
+          @info_type_config = args[:info_type_config] if args.key?(:info_type_config)
+        end
+      end
+      
+      # Response for successful Annotation store evaluation operations. This
+      # structure is included in the
+      # response upon operation completion.
+      class EvaluateAnnotationStoreResponse
+        include Google::Apis::Core::Hashable
+      
+        # The evaluated Annotation store, in the format of
+        # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        # annotationStores/`annotation_store_id``.
+        # Corresponds to the JSON property `evalStore`
+        # @return [String]
+        attr_accessor :eval_store
+      
+        # The number of Annotations in the ground
+        # truth Annotation store successfully
+        # processed.
+        # Corresponds to the JSON property `goldenCount`
+        # @return [Fixnum]
+        attr_accessor :golden_count
+      
+        # The ground truth Annotation store, 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
+      
+        # The number of Annotations
+        # in the eval store that match with corresponding annotations
+        # in the ground truth Annotation store. Two matched
+        # annotations both annotate the same resource defined in
+        # AnnotationSource.
+        # Corresponds to the JSON property `matchedCount`
+        # @return [Fixnum]
+        attr_accessor :matched_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @eval_store = args[:eval_store] if args.key?(:eval_store)
+          @golden_count = args[:golden_count] if args.key?(:golden_count)
+          @golden_store = args[:golden_store] if args.key?(:golden_store)
+          @matched_count = args[:matched_count] if args.key?(:matched_count)
+        end
+      end
+      
+      # Response for failed annotation export operations. This structure is
+      # included in error
+      # details upon operation completion.
+      class ExportAnnotationsErrorDetails
+        include Google::Apis::Core::Hashable
+      
+        # The annotation_store used for the export operation, in the format of
+        # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        # annotationStores/`annotation_store_id``.
+        # Corresponds to the JSON property `annotationStore`
+        # @return [String]
+        attr_accessor :annotation_store
+      
+        # The number of annotations that had error.
+        # Corresponds to the JSON property `errorCount`
+        # @return [Fixnum]
+        attr_accessor :error_count
+      
+        # The number of annotations successfully exported.
+        # Corresponds to the JSON property `successCount`
+        # @return [Fixnum]
+        attr_accessor :success_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @annotation_store = args[:annotation_store] if args.key?(:annotation_store)
+          @error_count = args[:error_count] if args.key?(:error_count)
+          @success_count = args[:success_count] if args.key?(:success_count)
+        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
+        include Google::Apis::Core::Hashable
+      
+        # The BigQuery table for export.
+        # Corresponds to the JSON property `bigqueryDestination`
+        # @return [Google::Apis::HealthcareV1beta1::GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination]
+        attr_accessor :bigquery_destination
+      
+        # The Cloud Storage location for export.
+        # Corresponds to the JSON property `gcsDestination`
+        # @return [Google::Apis::HealthcareV1beta1::GoogleCloudHealthcareV1beta1AnnotationGcsDestination]
+        attr_accessor :gcs_destination
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bigquery_destination = args[:bigquery_destination] if args.key?(:bigquery_destination)
+          @gcs_destination = args[:gcs_destination] if args.key?(:gcs_destination)
+        end
+      end
+      
+      # Response for successful annotation export operations. This structure is
+      # included in response upon operation
+      # completion.
+      class ExportAnnotationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The annotation_store used for the export operation, in the format of
+        # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        # annotationStores/`annotation_store_id``.
+        # Corresponds to the JSON property `annotationStore`
+        # @return [String]
+        attr_accessor :annotation_store
+      
+        # The total number of annotations successfully exported.
+        # Corresponds to the JSON property `successCount`
+        # @return [Fixnum]
+        attr_accessor :success_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @annotation_store = args[:annotation_store] if args.key?(:annotation_store)
+          @success_count = args[:success_count] if args.key?(:success_count)
+        end
+      end
+      
       # Exports data from the specified DICOM store.
       # If a given resource, such as a DICOM object with the same SOPInstance UID,
       # already exists in the output, it is overwritten with the version
@@ -1063,22 +1481,185 @@ module Google
         # @return [Fixnum]
         attr_accessor :min_occurs
       
-        # The name of the field. For example, "PID-1" or just "1".
-        # Corresponds to the JSON property `name`
+        # The name of the field. For example, "PID-1" or just "1".
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The HL7v2 table this field refers to. For example, PID-15 (Patient's
+        # Primary Language) usually refers to table "0296".
+        # Corresponds to the JSON property `table`
+        # @return [String]
+        attr_accessor :table
+      
+        # The type of this field. A Type with this name must be defined in an
+        # Hl7TypesConfig.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_occurs = args[:max_occurs] if args.key?(:max_occurs)
+          @min_occurs = args[:min_occurs] if args.key?(:min_occurs)
+          @name = args[:name] if args.key?(:name)
+          @table = args[:table] if args.key?(:table)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # Specifies FHIR paths to match, and how to handle de-identification of
+      # matching fields.
+      class FieldMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Deidentify action for one field.
+        # Corresponds to the JSON property `action`
+        # @return [String]
+        attr_accessor :action
+      
+        # List of paths to FHIR fields to redact. Each path is a
+        # period-separated list where each component is either a field name or
+        # FHIR type name. All types begin with an upper case letter. For example,
+        # the resource field "Patient.Address.city", which uses a string type,
+        # can be matched by "Patient.Address.String". Path also supports partial
+        # matching. For example, "Patient.Address.city" can be matched by
+        # "Address.city" (Patient omitted). Partial matching and type matching
+        # can be combined. For example, "Patient.Address.city" can be matched by
+        # "Address.String". For "choice" types (those defined in the FHIR spec
+        # with the form: field[x]), use two separate components. For example,
+        # "deceasedAge.unit" is matched by "Deceased.Age.unit". Supported types
+        # are: AdministrativeGenderCode, Code, Date, DateTime, Decimal,
+        # HumanName, Id, LanguageCode, Markdown, Oid, String, Uri, Uuid, Xhtml.
+        # The sub-type for HumanName, such as HumanName.given or
+        # HumanName.family, can be omitted.
+        # Corresponds to the JSON property `paths`
+        # @return [Array<String>]
+        attr_accessor :paths
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @action = args[:action] if args.key?(:action)
+          @paths = args[:paths] if args.key?(:paths)
+        end
+      end
+      
+      # List of infoTypes to be filtered.
+      class FilterList
+        include Google::Apis::Core::Hashable
+      
+        # These infoTypes are based on after the `eval_info_type_mapping` and
+        # `golden_info_type_mapping`.
+        # Corresponds to the JSON property `infoTypes`
+        # @return [Array<String>]
+        attr_accessor :info_types
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @info_types = args[:info_types] if args.key?(:info_types)
+        end
+      end
+      
+      # 
+      class Finding
+        include Google::Apis::Core::Hashable
+      
+        # Zero-based ending index of the found text, exclusively.
+        # Corresponds to the JSON property `end`
+        # @return [Fixnum]
+        attr_accessor :end
+      
+        # The type of information stored in this text range. For example,
+        # HumanName, BirthDate, or Address.
+        # Corresponds to the JSON property `infoType`
+        # @return [String]
+        attr_accessor :info_type
+      
+        # The snippet of the sensitive text. This field is only populated during
+        # deidentification if `store_quote` is set to true in DeidentifyConfig.
+        # Corresponds to the JSON property `quote`
+        # @return [String]
+        attr_accessor :quote
+      
+        # Zero-based starting index of the found text, inclusively.
+        # Corresponds to the JSON property `start`
+        # @return [Fixnum]
+        attr_accessor :start
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end = args[:end] if args.key?(:end)
+          @info_type = args[:info_type] if args.key?(:info_type)
+          @quote = args[:quote] if args.key?(:quote)
+          @start = args[:start] if args.key?(:start)
+        end
+      end
+      
+      # The BigQuery table for export.
+      class GoogleCloudHealthcareV1beta1AnnotationBigQueryDestination
+        include Google::Apis::Core::Hashable
+      
+        # If the destination table already exists and this flag is `TRUE`, the table
+        # is overwritten by the contents of the input store. If the flag is not
+        # set and the destination table already exists, the export call returns an
+        # error.
+        # Corresponds to the JSON property `force`
+        # @return [Boolean]
+        attr_accessor :force
+        alias_method :force?, :force
+      
+        # Specifies the schema format to export.
+        # Corresponds to the JSON property `schemaType`
         # @return [String]
-        attr_accessor :name
+        attr_accessor :schema_type
       
-        # The HL7v2 table this field refers to. For example, PID-15 (Patient's
-        # Primary Language) usually refers to table "0296".
-        # Corresponds to the JSON property `table`
+        # BigQuery URI to a table, up to 2000 characters long, must be of the form
+        # bq://projectId.bqDatasetId.tableId.
+        # Corresponds to the JSON property `tableUri`
         # @return [String]
-        attr_accessor :table
+        attr_accessor :table_uri
       
-        # The type of this field. A Type with this name must be defined in an
-        # Hl7TypesConfig.
-        # Corresponds to the JSON property `type`
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @force = args[:force] if args.key?(:force)
+          @schema_type = args[:schema_type] if args.key?(:schema_type)
+          @table_uri = args[:table_uri] if args.key?(:table_uri)
+        end
+      end
+      
+      # The Cloud Storage location for export.
+      class GoogleCloudHealthcareV1beta1AnnotationGcsDestination
+        include Google::Apis::Core::Hashable
+      
+        # The Cloud Storage destination to export to.
+        # URI for a Cloud Storage directory where the server writes result files, in
+        # the format `gs://`bucket-id`/`path/to/destination/dir``. If there is no
+        # trailing slash, the service appends one when composing the object path.
+        # The user is responsible for creating the Cloud Storage bucket referenced in
+        # `uri_prefix`.
+        # Corresponds to the JSON property `uriPrefix`
         # @return [String]
-        attr_accessor :type
+        attr_accessor :uri_prefix
       
         def initialize(**args)
            update!(**args)
@@ -1086,42 +1667,34 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @max_occurs = args[:max_occurs] if args.key?(:max_occurs)
-          @min_occurs = args[:min_occurs] if args.key?(:min_occurs)
-          @name = args[:name] if args.key?(:name)
-          @table = args[:table] if args.key?(:table)
-          @type = args[:type] if args.key?(:type)
+          @uri_prefix = args[:uri_prefix] if args.key?(:uri_prefix)
         end
       end
       
-      # Specifies FHIR paths to match, and how to handle de-identification of
-      # matching fields.
-      class FieldMetadata
+      # Specifies the configuration for importing data from Cloud Storage.
+      class GoogleCloudHealthcareV1beta1AnnotationGcsSource
         include Google::Apis::Core::Hashable
       
-        # Deidentify action for one field.
-        # Corresponds to the JSON property `action`
+        # Points to a Cloud Storage URI containing file(s) with
+        # content only. The URI must be in the following format:
+        # `gs://`bucket_id`/`object_id``. The URI can include wildcards in
+        # `object_id` and thus identify multiple files. Supported wildcards:
+        # '*' to match 0 or more non-separator characters
+        # '**' to match 0 or more characters (including separators). Must be used
+        # at
+        # the end of a path and with no other wildcards in the
+        # path. Can also be used with a file extension (such as .dcm), which
+        # imports all files with the extension in the specified directory and
+        # its sub-directories. For example,
+        # `gs://my-bucket/my-directory/**.json` imports all files with .json
+        # extensions in `my-directory/` and its sub-directories.
+        # '?' to match 1 character
+        # All other URI formats are invalid.
+        # Files matching the wildcard are expected to contain content only, no
+        # metadata.
+        # Corresponds to the JSON property `uri`
         # @return [String]
-        attr_accessor :action
-      
-        # List of paths to FHIR fields to redact. Each path is a
-        # period-separated list where each component is either a field name or
-        # FHIR type name. All types begin with an upper case letter. For example,
-        # the resource field "Patient.Address.city", which uses a string type,
-        # can be matched by "Patient.Address.String". Path also supports partial
-        # matching. For example, "Patient.Address.city" can be matched by
-        # "Address.city" (Patient omitted). Partial matching and type matching
-        # can be combined, for example "Patient.Address.city" can be matched by
-        # "Address.String". For "choice" types (those defined in the FHIR spec
-        # with the form: field[x]), use two separate components. For example,
-        # "deceasedAge.unit" is matched by "Deceased.Age.unit". Supported types
-        # are: AdministrativeGenderCode, Code, Date, DateTime, Decimal,
-        # HumanName, Id, LanguageCode, Markdown, Oid, String, Uri, Uuid, Xhtml.
-        # The sub-type for HumanName(for example HumanName.given,
-        # HumanName.family) can be omitted.
-        # Corresponds to the JSON property `paths`
-        # @return [Array<String>]
-        attr_accessor :paths
+        attr_accessor :uri
       
         def initialize(**args)
            update!(**args)
@@ -1129,8 +1702,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @action = args[:action] if args.key?(:action)
-          @paths = args[:paths] if args.key?(:paths)
+          @uri = args[:uri] if args.key?(:uri)
         end
       end
       
@@ -1385,9 +1957,9 @@ module Google
       end
       
       # Response when all resources export successfully.
-      # This structure will be included in the
+      # This structure is included in the
       # response to describe the detailed
-      # outcome. It will only be included when the operation finishes successfully.
+      # outcome after the operation finishes successfully.
       class GoogleCloudHealthcareV1beta1FhirRestExportResourcesResponse
         include Google::Apis::Core::Hashable
       
@@ -1421,7 +1993,7 @@ module Google
       
         # URI for a Cloud Storage directory where result files should be written (in
         # the format `gs://`bucket-id`/`path/to/destination/dir``). If there is no
-        # trailing slash, the service will append one when composing the object path.
+        # trailing slash, the service appends one when composing the object path.
         # The user is responsible for creating the Cloud Storage bucket referenced in
         # `uri_prefix`.
         # Corresponds to the JSON property `uriPrefix`
@@ -1472,10 +2044,10 @@ module Google
       end
       
       # Error response of importing resources.
-      # This structure will be included in the
+      # This structure is included in the
       # error
-      # details to describe the detailed error. It will
-      # only be included when the operation finishes with some failure.
+      # details to describe the detailed error
+      # after the operation finishes with some failure.
       class GoogleCloudHealthcareV1beta1FhirRestImportResourcesErrorDetails
         include Google::Apis::Core::Hashable
       
@@ -1517,9 +2089,9 @@ module Google
       end
       
       # Final response of importing resources.
-      # This structure will be included in the
+      # This structure is included in the
       # response to describe the detailed
-      # outcome. It will only be included when the operation finishes successfully.
+      # outcome after the operation finishes successfully.
       class GoogleCloudHealthcareV1beta1FhirRestImportResourcesResponse
         include Google::Apis::Core::Hashable
       
@@ -1635,7 +2207,7 @@ module Google
         # Restricts notifications sent for messages matching a filter. If this is
         # empty, all messages are matched. Syntax:
         # https://cloud.google.com/appengine/docs/standard/python/search/query_strings
-        # Fields/functions available for filtering are:
+        # The following fields and functions are available for filtering:
         # *  `message_type`, from the MSH-9.1 field. For example,
         # `NOT message_type = "ADT"`.
         # *  `send_date` or `sendDate`, the YYYY-MM-DD date the message was sent in
@@ -1664,16 +2236,16 @@ module Google
         # *  `PubsubMessage.Data` contains the resource name.
         # *  `PubsubMessage.MessageId` is the ID of this notification. It is
         # guaranteed to be unique within the topic.
-        # *  `PubsubMessage.PublishTime` is the time at which the message was
+        # *  `PubsubMessage.PublishTime` is the time when the message was
         # published.
         # Note that notifications are only sent if the topic is non-empty. [Topic
         # names](https://cloud.google.com/pubsub/docs/overview#names) must be
         # scoped to a project. Cloud Healthcare API service account must have
         # publisher permissions on the given Pub/Sub topic. Not having adequate
         # permissions causes the calls that send notifications to fail.
-        # If a notification cannot be published to Cloud Pub/Sub, errors will be
-        # logged to Cloud Logging (see [Viewing logs](/healthcare/docs/how-
-        # tos/logging)).
+        # If a notification can't be published to Cloud Pub/Sub, errors are
+        # logged to Cloud Logging. For more information, see
+        # [Viewing error logs in Cloud Logging](/healthcare/docs/how-tos/logging).
         # Corresponds to the JSON property `pubsubTopic`
         # @return [String]
         attr_accessor :pubsub_topic
@@ -1706,7 +2278,7 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Output only. Resource name of the HL7v2 store, of the form
+        # Resource name of the HL7v2 store, of the form
         # `projects/`project_id`/datasets/`dataset_id`/hl7V2Stores/`hl7v2_store_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -1731,7 +2303,7 @@ module Google
         # @return [Google::Apis::HealthcareV1beta1::ParserConfig]
         attr_accessor :parser_config
       
-        # Determines whether duplicate messages should be rejected. A duplicate
+        # Determines whether to reject duplicate messages. A duplicate
         # message is a message with the same raw bytes as a message that has already
         # been ingested/created in this HL7v2 store.
         # The default value is false, meaning that the store accepts the duplicate
@@ -1823,6 +2395,32 @@ module Google
         end
       end
       
+      # Image annotation.
+      class ImageAnnotation
+        include Google::Apis::Core::Hashable
+      
+        # The list of polygons outlining the sensitive regions in the image.
+        # Corresponds to the JSON property `boundingPolys`
+        # @return [Array<Google::Apis::HealthcareV1beta1::BoundingPoly>]
+        attr_accessor :bounding_polys
+      
+        # 0-based index of the image frame. For example, an image frame in a DICOM
+        # instance.
+        # Corresponds to the JSON property `frameIndex`
+        # @return [Fixnum]
+        attr_accessor :frame_index
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bounding_polys = args[:bounding_polys] if args.key?(:bounding_polys)
+          @frame_index = args[:frame_index] if args.key?(:frame_index)
+        end
+      end
+      
       # Specifies how to handle de-identification of image pixels.
       class ImageConfig
         include Google::Apis::Core::Hashable
@@ -1842,6 +2440,101 @@ module Google
         end
       end
       
+      # Final response of importing
+      # Annotations in
+      # partial or total failure case. This structure is included in the
+      # error
+      # details. It is only included when the operation
+      # finishes.
+      class ImportAnnotationsErrorDetails
+        include Google::Apis::Core::Hashable
+      
+        # The annotation_store that the annotations were imported to. The name
+        # is in the format
+        # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        # annotationStores/`annotation_store_id``.
+        # Corresponds to the JSON property `annotationStore`
+        # @return [String]
+        attr_accessor :annotation_store
+      
+        # The number of annotations that had errors.
+        # Corresponds to the JSON property `errorCount`
+        # @return [Fixnum]
+        attr_accessor :error_count
+      
+        # The number of annotations that have been imported.
+        # Corresponds to the JSON property `successCount`
+        # @return [Fixnum]
+        attr_accessor :success_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @annotation_store = args[:annotation_store] if args.key?(:annotation_store)
+          @error_count = args[:error_count] if args.key?(:error_count)
+          @success_count = args[:success_count] if args.key?(:success_count)
+        end
+      end
+      
+      # Request to import
+      # Annotations. The
+      # Annotations to be imported must have client-supplied resource names which
+      # indicate the annotation resource. The import operation is not atomic. If a
+      # failure occurs, any annotations already imported are not removed.
+      class ImportAnnotationsRequest
+        include Google::Apis::Core::Hashable
+      
+        # Specifies the configuration for importing data from Cloud Storage.
+        # Corresponds to the JSON property `gcsSource`
+        # @return [Google::Apis::HealthcareV1beta1::GoogleCloudHealthcareV1beta1AnnotationGcsSource]
+        attr_accessor :gcs_source
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @gcs_source = args[:gcs_source] if args.key?(:gcs_source)
+        end
+      end
+      
+      # Final response of importing
+      # Annotations in
+      # successful case. This structure is included in the
+      # response. It is only included
+      # when the operation finishes.
+      class ImportAnnotationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The annotation_store that the annotations were imported to. The name
+        # is in the format
+        # `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        # annotationStores/`annotation_store_id``.
+        # Corresponds to the JSON property `annotationStore`
+        # @return [String]
+        attr_accessor :annotation_store
+      
+        # The number of the input annotations. All input have been imported
+        # successfully.
+        # Corresponds to the JSON property `successCount`
+        # @return [Fixnum]
+        attr_accessor :success_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @annotation_store = args[:annotation_store] if args.key?(:annotation_store)
+          @success_count = args[:success_count] if args.key?(:success_count)
+        end
+      end
+      
       # Returns the errors encountered during DICOM store import.
       class ImportDicomDataErrorDetails
         include Google::Apis::Core::Hashable
@@ -1924,6 +2617,59 @@ module Google
         end
       end
       
+      # Specifies how to use infoTypes for evaluation. For example, a user might
+      # only want to evaluate `PERSON`, `LOCATION`, and `AGE`.
+      class InfoTypeConfig
+        include Google::Apis::Core::Hashable
+      
+        # List of infoTypes to be filtered.
+        # Corresponds to the JSON property `evaluateList`
+        # @return [Google::Apis::HealthcareV1beta1::FilterList]
+        attr_accessor :evaluate_list
+      
+        # List of infoTypes to be filtered.
+        # Corresponds to the JSON property `ignoreList`
+        # @return [Google::Apis::HealthcareV1beta1::FilterList]
+        attr_accessor :ignore_list
+      
+        # If `TRUE`, infoTypes described by `filter` are used for evaluation.
+        # Otherwise, infoTypes are not considered for evaluation.
+        # For example:
+        # * Annotated text:
+        # "Toronto is a location"
+        # * Finding 1:
+        # ``"infoType": "PERSON", "quote": "Toronto", "start": 0, "end": 7``
+        # * Finding 2:
+        # ``"infoType": "CITY", "quote": "Toronto", "start": 0, "end": 7``
+        # * Finding 3:
+        # ````
+        # * Ground truth:
+        # ``"infoType": "LOCATION", "quote": "Toronto", "start": 0, "end": 7``
+        # When `strict_matching` is `TRUE`:
+        # * Finding 1: 1 false positive
+        # * Finding 2: 1 false positive
+        # * Finding 3: 1 false negative
+        # When `strict_matching` is `FALSE`:
+        # * Finding 1: 1 true positive
+        # * Finding 2: 1 true positive
+        # * Finding 3: 1 false negative
+        # Corresponds to the JSON property `strictMatching`
+        # @return [Boolean]
+        attr_accessor :strict_matching
+        alias_method :strict_matching?, :strict_matching
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @evaluate_list = args[:evaluate_list] if args.key?(:evaluate_list)
+          @ignore_list = args[:ignore_list] if args.key?(:ignore_list)
+          @strict_matching = args[:strict_matching] if args.key?(:strict_matching)
+        end
+      end
+      
       # A transformation to apply to text that is identified as a specific
       # info_type.
       class InfoTypeTransformation
@@ -1936,8 +2682,8 @@ module Google
       
         # Pseudonymization method that generates surrogates via cryptographic hashing.
         # Uses SHA-256.
-        # Outputs a base64-encoded representation of the hashed output
-        # (for example, `L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=`).
+        # Outputs a base64-encoded representation of the hashed output.
+        # For example, `L7k0BHmF1ha5U3NfGykjro4xWi1MPVQPjhMAZbSV9mM=`.
         # Corresponds to the JSON property `cryptoHashConfig`
         # @return [Google::Apis::HealthcareV1beta1::CryptoHashConfig]
         attr_accessor :crypto_hash_config
@@ -1991,8 +2737,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A complete HL7v2 message.
-        # See http://www.hl7.org/implement/standards/index.cfm?ref=common for details
-        # on the standard.
+        # See [Introduction to HL7 Standards]
+        # (https://www.hl7.org/implement/standards/index.cfm?ref=common) for
+        # details on the standard.
         # Corresponds to the JSON property `message`
         # @return [Google::Apis::HealthcareV1beta1::Message]
         attr_accessor :message
@@ -2019,8 +2766,9 @@ module Google
         attr_accessor :hl7_ack
       
         # A complete HL7v2 message.
-        # See http://www.hl7.org/implement/standards/index.cfm?ref=common for details
-        # on the standard.
+        # See [Introduction to HL7 Standards]
+        # (https://www.hl7.org/implement/standards/index.cfm?ref=common) for
+        # details on the standard.
         # Corresponds to the JSON property `message`
         # @return [Google::Apis::HealthcareV1beta1::Message]
         attr_accessor :message
@@ -2036,6 +2784,63 @@ module Google
         end
       end
       
+      # Lists the Annotation stores
+      # in the given dataset.
+      class ListAnnotationStoresResponse
+        include Google::Apis::Core::Hashable
+      
+        # The returned Annotation stores. Won't be more Annotation stores than the
+        # value of page_size in the request.
+        # Corresponds to the JSON property `annotationStores`
+        # @return [Array<Google::Apis::HealthcareV1beta1::AnnotationStore>]
+        attr_accessor :annotation_stores
+      
+        # Token to retrieve the next page of results or empty if there are no more
+        # results in the list.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @annotation_stores = args[:annotation_stores] if args.key?(:annotation_stores)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # Lists the Annotations in the specified
+      # Annotation store.
+      class ListAnnotationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The returned Annotations. Won't be more values than the value of
+        # page_size in the request. See `AnnotationView` in the request for
+        # populated fields.
+        # Corresponds to the JSON property `annotations`
+        # @return [Array<Google::Apis::HealthcareV1beta1::Annotation>]
+        attr_accessor :annotations
+      
+        # Token to retrieve the next page of results or empty if there are no more
+        # results in the list.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @annotations = args[:annotations] if args.key?(:annotations)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Lists the available datasets.
       class ListDatasetsResponse
         include Google::Apis::Core::Hashable
@@ -2270,8 +3075,9 @@ module Google
       end
       
       # A complete HL7v2 message.
-      # See http://www.hl7.org/implement/standards/index.cfm?ref=common for details
-      # on the standard.
+      # See [Introduction to HL7 Standards]
+      # (https://www.hl7.org/implement/standards/index.cfm?ref=common) for
+      # details on the standard.
       class Message
         include Google::Apis::Core::Hashable
       
@@ -2780,6 +3586,25 @@ module Google
         end
       end
       
+      # Resource level annotation.
+      class ResourceAnnotation
+        include Google::Apis::Core::Hashable
+      
+        # A description of the annotation record.
+        # Corresponds to the JSON property `label`
+        # @return [String]
+        attr_accessor :label
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @label = args[:label] if args.key?(:label)
+        end
+      end
+      
       # A list of FHIR resources.
       class Resources
         include Google::Apis::Core::Hashable
@@ -2987,9 +3812,9 @@ module Google
       
         # The FHIR resource type to search, such as Patient or Observation. For a
         # complete list, see the FHIR Resource Index
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
         # Corresponds to the JSON property `resourceType`
         # @return [String]
         attr_accessor :resource_type
@@ -3047,6 +3872,27 @@ module Google
         end
       end
       
+      # A TextAnnotation specifies a text range that includes sensitive information.
+      class SensitiveTextAnnotation
+        include Google::Apis::Core::Hashable
+      
+        # Maps from a resource slice. For example, FHIR resource field path to a set
+        # of sensitive text findings. For example,
+        # Appointment.Narrative text1 --> `findings_1, findings_2, findings_3`
+        # Corresponds to the JSON property `details`
+        # @return [Hash<String,Google::Apis::HealthcareV1beta1::Detail>]
+        attr_accessor :details
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @details = args[:details] if args.key?(:details)
+        end
+      end
+      
       # Request message for `SetIamPolicy` method.
       class SetIamPolicyRequest
         include Google::Apis::Core::Hashable
@@ -3174,7 +4020,7 @@ module Google
         end
       end
       
-      # This structure contains configuration for streaming FHIR export.
+      # Contains configuration for streaming FHIR export.
       class StreamConfig
         include Google::Apis::Core::Hashable
       
@@ -3210,7 +4056,7 @@ module Google
         # Tags to be filtered. Tags must be DICOM Data Elements, File Meta
         # Elements, or Directory Structuring Elements, as defined at:
         # http://dicom.nema.org/medical/dicom/current/output/html/part06.html#table_6-1,.
-        # They may be provided by "Keyword" or "Tag". For example "PatientID",
+        # They may be provided by "Keyword" or "Tag". For example, "PatientID",
         # "00100010".
         # Corresponds to the JSON property `tags`
         # @return [Array<String>]
@@ -3345,6 +4191,31 @@ module Google
           @value = args[:value] if args.key?(:value)
         end
       end
+      
+      # A 2D coordinate in an image. The origin is the top-left.
+      class Vertex
+        include Google::Apis::Core::Hashable
+      
+        # X coordinate.
+        # Corresponds to the JSON property `x`
+        # @return [Float]
+        attr_accessor :x
+      
+        # Y coordinate.
+        # Corresponds to the JSON property `y`
+        # @return [Float]
+        attr_accessor :y
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @x = args[:x] if args.key?(:x)
+          @y = args[:y] if args.key?(:y)
+        end
+      end
     end
   end
 end