google-api-client 0.39.2 → 0.40.1

data/generated/google/apis/healthcare_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/healthcare
     module HealthcareV1
       VERSION = 'V1'
-      REVISION = '20200414'
+      REVISION = '20200525'
 
       # 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_v1/classes.rb

@@ -258,8 +258,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::HealthcareV1::Message]
         attr_accessor :message
@@ -306,7 +307,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]
@@ -616,7 +617,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`
@@ -729,9 +730,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 ExportResourcesResponse
         include Google::Apis::Core::Hashable
       
@@ -977,6 +978,8 @@ module Google
         # Supported types are: AdministrativeGenderCode, Code, Date, DateTime,
         # Decimal, HumanName, Id, LanguageCode, Markdown, Oid, String, Uri, Uuid,
         # Xhtml.
+        # Base64Binary is also supported, but may only be kept as-is or have all
+        # the content removed.
         # Corresponds to the JSON property `paths`
         # @return [Array<String>]
         attr_accessor :paths
@@ -1153,7 +1156,7 @@ module Google
         # @return [String]
         attr_accessor :dataset_uri
       
-        # If this flag is `TRUE`, all tables will be deleted from the dataset before
+        # If this flag is `TRUE`, all tables are deleted from the dataset before
         # the new exported tables are written. If the flag is not set and the
         # destination dataset contains tables, the export call returns an error.
         # Corresponds to the JSON property `force`
@@ -1183,9 +1186,9 @@ module Google
       class GoogleCloudHealthcareV1FhirGcsDestination
         include Google::Apis::Core::Hashable
       
-        # 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.
+        # URI for a Cloud Storage directory where result files should be written, in
+        # the format of `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`
@@ -1243,7 +1246,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
@@ -1266,22 +1269,25 @@ module Google
         # @return [String]
         attr_accessor :filter
       
-        # The [Cloud Pubsub](https://cloud.google.com/pubsub/docs/) topic that
-        # notifications of changes are published on. Supplied by the client. The
-        # notification is a `PubsubMessage` with the following fields:
+        # The [Cloud Pub/Sub](https://cloud.google.com/pubsub/docs/) topic that
+        # notifications of changes are published on. Supplied by the client.
+        # The notification is a `PubsubMessage` with the following fields:
         # *  `PubsubMessage.Data` contains the resource name.
-        # *  `PubsubMessage.MessageId` is the ID of this notification. It is
+        # *  `PubsubMessage.MessageId` is the ID of this notification. It's
         # 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@system.gserviceaccount.com must
-        # have publisher permissions on the given Pubsub topic. Not having adequate
+        # scoped to a project.
+        # The Cloud Healthcare API service account,
+        # service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com,
+        # 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 Stackdriver (see [Viewing logs](/healthcare/docs/how-
-        # tos/stackdriver-logging)).
+        # If a notification cannot 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
@@ -1314,7 +1320,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]
@@ -1334,7 +1340,7 @@ module Google
         # @return [Google::Apis::HealthcareV1::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
@@ -1506,9 +1512,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 ImportResourcesResponse
         include Google::Apis::Core::Hashable
       
@@ -1587,8 +1593,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::HealthcareV1::Message]
         attr_accessor :message
@@ -1615,8 +1622,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::HealthcareV1::Message]
         attr_accessor :message
@@ -1794,8 +1802,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
       
@@ -1888,12 +1897,12 @@ module Google
         # 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@system.gserviceaccount.com must have
-        # publisher permissions on the given Cloud Pub/Sub topic. Not having adequate
+        # to a project. Cloud Healthcare API service account must have publisher
+        # permissions on the given Cloud Pub/Sub topic. Not having adequate
         # permissions causes the calls that send notifications to fail.
         # If a notification can't be published to Cloud Pub/Sub, errors are logged to
-        # Stackdriver (see [Viewing
-        # logs](/healthcare/docs/how-tos/stackdriver-logging)). If the number of
+        # Cloud Logging (see [Viewing
+        # logs](/healthcare/docs/how-tos/logging)). If the number of
         # errors exceeds a certain rate, some aren't submitted.
         # Corresponds to the JSON property `pubsubTopic`
         # @return [String]
@@ -2006,7 +2015,7 @@ module Google
       
         # A link to audit and error logs in the log viewer. Error logs are generated
         # only by some operations, listed at
-        # https://cloud.google.com/healthcare/docs/how-tos/stackdriver-logging.
+        # [Viewing logs](/healthcare/docs/how-tos/logging).
         # Corresponds to the JSON property `logsUrl`
         # @return [String]
         attr_accessor :logs_url
@@ -2106,10 +2115,13 @@ module Google
       # Google groups, and domains (such as G Suite). A `role` is a named list of
       # permissions; each `role` can be an IAM predefined role or a user-created
       # custom role.
-      # Optionally, a `binding` can specify a `condition`, which is a logical
-      # expression that allows access to a resource only if the expression evaluates
-      # to `true`. A condition can add constraints based on attributes of the
-      # request, the resource, or both.
+      # For some types of Google Cloud resources, a `binding` can also specify a
+      # `condition`, which is a logical expression that allows access to a resource
+      # only if the expression evaluates to `true`. A condition can add constraints
+      # based on attributes of the request, the resource, or both. To learn which
+      # resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # policies).
       # **JSON example:**
       # `
       # "bindings": [
@@ -2124,7 +2136,9 @@ module Google
       # `,
       # `
       # "role": "roles/resourcemanager.organizationViewer",
-      # "members": ["user:eve@example.com"],
+      # "members": [
+      # "user:eve@example.com"
+      # ],
       # "condition": `
       # "title": "expirable access",
       # "description": "Does not grant access after Sep 2020",
@@ -2202,6 +2216,9 @@ module Google
         # the conditions in the version `3` policy are lost.
         # If a policy does not include any conditions, operations on that policy may
         # specify any valid version or leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -2409,10 +2426,13 @@ module Google
         # Google groups, and domains (such as G Suite). A `role` is a named list of
         # permissions; each `role` can be an IAM predefined role or a user-created
         # custom role.
-        # Optionally, a `binding` can specify a `condition`, which is a logical
-        # expression that allows access to a resource only if the expression evaluates
-        # to `true`. A condition can add constraints based on attributes of the
-        # request, the resource, or both.
+        # For some types of Google Cloud resources, a `binding` can also specify a
+        # `condition`, which is a logical expression that allows access to a resource
+        # only if the expression evaluates to `true`. A condition can add constraints
+        # based on attributes of the request, the resource, or both. To learn which
+        # resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # **JSON example:**
         # `
         # "bindings": [
@@ -2427,7 +2447,9 @@ module Google
         # `,
         # `
         # "role": "roles/resourcemanager.organizationViewer",
-        # "members": ["user:eve@example.com"],
+        # "members": [
+        # "user:eve@example.com"
+        # ],
         # "condition": `
         # "title": "expirable access",
         # "description": "Does not grant access after Sep 2020",
@@ -2465,8 +2487,7 @@ module Google
         # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
         # the fields in the mask will be modified. If no mask is provided, the
         # following default mask is used:
-        # paths: "bindings, etag"
-        # This field is only used by Cloud IAM.
+        # `paths: "bindings, etag"`
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -2521,7 +2542,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
       

data/generated/google/apis/healthcare_v1/service.rb

@@ -102,8 +102,8 @@ module Google
         # DICOM instances. The new de-identified dataset will not contain these
         # failed resources. Failed resource totals are tracked in
         # Operation.metadata.
-        # Error details are also logged to Stackdriver Logging. For more information,
-        # see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging).
+        # Error details are also logged to Cloud Logging. For more information,
+        # see [Viewing logs](/healthcare/docs/how-tos/logging).
         # @param [String] source_dataset
         #   Source dataset resource name. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id``.
@@ -214,6 +214,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -282,7 +285,7 @@ module Google
         
         # Updates dataset metadata.
         # @param [String] name
-        #   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``.
         # @param [Google::Apis::HealthcareV1::Dataset] dataset_object
         # @param [String] update_mask
@@ -322,7 +325,7 @@ module Google
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
-        # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -358,7 +361,7 @@ module Google
         
         # Returns permissions that a caller has on the specified resource.
         # If the resource does not exist, this will return an empty set of
-        # permissions, not a NOT_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # Note: This operation is designed to be used for building permission-aware
         # UIs and command-line tools, not for authorization checking. This operation
         # may "fail open" without warning.
@@ -443,8 +446,8 @@ module Google
         # DICOM instances. The output DICOM store will not contain
         # these failed resources. Failed resource totals are tracked in
         # Operation.metadata.
-        # Error details are also logged to Stackdriver
-        # (see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging)).
+        # Error details are also logged to Cloud Logging
+        # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
         # @param [String] source_store
         #   Source DICOM store resource name. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -512,8 +515,8 @@ module Google
         
         # Exports data to the specified destination by copying it from the DICOM
         # store.
-        # Errors are also logged to Stackdriver Logging. For more information,
-        # see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging).
+        # Errors are also logged to Cloud Logging. For more information,
+        # see [Viewing logs](/healthcare/docs/how-tos/logging).
         # The metadata field type is
         # OperationMetadata.
         # @param [String] name
@@ -594,6 +597,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -623,8 +629,8 @@ module Google
         end
         
         # Imports data into the DICOM store by copying it from the specified source.
-        # Errors are logged to Stackdriver Logging. For more information, see
-        # [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging). The
+        # Errors are logged to Cloud Logging. For more information, see
+        # [Viewing logs](/healthcare/docs/how-tos/logging). The
         # metadata field type is
         # OperationMetadata.
         # @param [String] name
@@ -706,7 +712,7 @@ module Google
         
         # Updates the specified DICOM store.
         # @param [String] name
-        #   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``.
         # @param [Google::Apis::HealthcareV1::DicomStore] dicom_store_object
@@ -746,7 +752,9 @@ module Google
         end
         
         # SearchForInstances returns a list of matching instances. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [Search Transaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -784,7 +792,9 @@ module Google
         end
         
         # SearchForSeries returns a list of matching series. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [Search Transaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -821,7 +831,9 @@ module Google
         end
         
         # SearchForStudies returns a list of matching studies. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [Search Transaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -858,7 +870,7 @@ module Google
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
-        # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -894,7 +906,9 @@ module Google
         
         # StoreInstances stores DICOM instances associated with study instance unique
         # identifiers (SUID). See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5.
+        # [Store Transaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -935,7 +949,7 @@ module Google
         
         # Returns permissions that a caller has on the specified resource.
         # If the resource does not exist, this will return an empty set of
-        # permissions, not a NOT_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # Note: This operation is designed to be used for building permission-aware
         # UIs and command-line tools, not for authorization checking. This operation
         # may "fail open" without warning.
@@ -1009,7 +1023,9 @@ module Google
         
         # RetrieveStudyMetadata returns instance associated with the given study
         # presented as metadata with the bulk data removed. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1046,7 +1062,9 @@ module Google
         end
         
         # RetrieveStudy returns all instances within the given study. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1083,7 +1101,9 @@ module Google
         end
         
         # SearchForInstances returns a list of matching instances. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [Search Transaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1121,7 +1141,9 @@ module Google
         end
         
         # SearchForSeries returns a list of matching series. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [Search Transaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1159,7 +1181,9 @@ module Google
         
         # StoreInstances stores DICOM instances associated with study instance unique
         # identifiers (SUID). See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5.
+        # [Store Transaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.5)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1240,7 +1264,9 @@ module Google
         
         # RetrieveSeriesMetadata returns instance associated with the given study and
         # series, presented as metadata with the bulk data removed. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1277,7 +1303,9 @@ module Google
         end
         
         # RetrieveSeries returns all instances within the given study and series. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1314,7 +1342,9 @@ module Google
         end
         
         # SearchForInstances returns a list of matching instances. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6.
+        # [Search Transaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.6)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1391,7 +1421,9 @@ module Google
         
         # RetrieveInstance returns instance associated with the given study, series,
         # and SOP Instance UID. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1430,7 +1462,9 @@ module Google
         # RetrieveInstanceMetadata returns instance associated with the given study,
         # series, and SOP Instance UID presented as metadata with the bulk data
         # removed. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1468,7 +1502,9 @@ module Google
         
         # RetrieveRenderedInstance returns instance associated with the given study,
         # series, and SOP Instance UID in an acceptable Rendered Media Type. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1506,7 +1542,9 @@ module Google
         
         # RetrieveFrames returns instances associated with the given study, series,
         # SOP Instance UID and frame numbers. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4`
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1546,7 +1584,9 @@ module Google
         # RetrieveRenderedFrames returns instances associated with the given study,
         # series, SOP Instance UID and frame numbers in an acceptable Rendered Media
         # Type. See
-        # http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.
+        # [RetrieveTransaction]
+        # (http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4)
+        # .
         # @param [String] parent
         #   The name of the DICOM store that is being accessed. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1627,8 +1667,8 @@ module Google
         # response field type is
         # DeidentifyFhirStoreSummary. If errors occur,
         # error is set.
-        # Error details are also logged to Stackdriver
-        # (see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging)).
+        # Error details are also logged to Cloud Logging
+        # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
         # @param [String] source_store
         #   Source FHIR store resource name. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1699,16 +1739,15 @@ module Google
         # GetOperation.
         # Immediate fatal errors appear in the
         # error field, errors are also logged
-        # to Stackdriver (see [Viewing
-        # logs](/healthcare/docs/how-tos/stackdriver-logging)).
+        # to Cloud Logging (see [Viewing
+        # logs](/healthcare/docs/how-tos/logging)).
         # Otherwise, when the operation finishes, a detailed response of type
         # ExportResourcesResponse is returned in the
         # response field.
         # The metadata field type for this
         # operation is OperationMetadata.
         # @param [String] name
-        #   The name of the FHIR store to export resource from. The name should be in
-        #   the format of
+        #   The name of the FHIR store to export resource from, in the format of
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   fhirStores/`fhir_store_id``.
         # @param [Google::Apis::HealthcareV1::ExportResourcesRequest] export_resources_request_object
@@ -1784,6 +1823,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1812,15 +1854,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Import resources to the FHIR store by loading data from the specified
+        # Imports resources to the FHIR store by loading data from the specified
         # sources. This method is optimized to load large quantities of data using
         # import semantics that ignore some FHIR store configuration options and are
         # not suitable for all use cases. It is primarily intended to load data into
         # an empty FHIR store that is not being used by other clients. In cases
         # where this method is not appropriate, consider using ExecuteBundle to
         # load data.
-        # Every resource in the input must contain a client-supplied ID, and will be
-        # stored using that ID regardless of the
+        # Every resource in the input must contain a client-supplied ID. Each
+        # resource is stored using the supplied ID regardless of the
         # enable_update_create setting on the FHIR
         # store.
         # The import process does not enforce referential integrity, regardless of
@@ -1831,21 +1873,21 @@ module Google
         # if the input data contains invalid references or if some resources fail to
         # be imported, the FHIR store might be left in a state that violates
         # referential integrity.
-        # The import process does not trigger PubSub notification or BigQuery
+        # The import process does not trigger Pub/Sub notification or BigQuery
         # streaming update, regardless of how those are configured on the FHIR store.
         # If a resource with the specified ID already exists, the most recent
         # version of the resource is overwritten without creating a new historical
         # version, regardless of the
         # disable_resource_versioning
         # setting on the FHIR store. If transient failures occur during the import,
-        # it is possible that successfully imported resources will be overwritten
+        # it's possible that successfully imported resources will be overwritten
         # more than once.
         # The import operation is idempotent unless the input data contains multiple
         # valid resources with the same ID but different contents. In that case,
-        # after the import completes, the store will contain exactly one resource
+        # after the import completes, the store contains exactly one resource
         # with that ID but there is no ordering guarantee on which version of the
         # contents it will have. The operation result counters do not count
-        # duplicate IDs as an error and will count one success for each resource in
+        # duplicate IDs as an error and count one success for each resource in
         # the input, which might result in a success count larger than the number
         # of resources in the FHIR store. This often occurs when importing data
         # organized in bundles produced by Patient-everything
@@ -1870,15 +1912,14 @@ module Google
         # GetOperation.
         # Immediate fatal errors appear in the
         # error field, errors are also logged
-        # to Stackdriver (see [Viewing
-        # logs](/healthcare/docs/how-tos/stackdriver-logging)). Otherwise, when the
+        # to Cloud Logging (see [Viewing
+        # logs](/healthcare/docs/how-tos/logging)). Otherwise, when the
         # operation finishes, a detailed response of type ImportResourcesResponse
         # is returned in the response field.
         # The metadata field type for this
         # operation is OperationMetadata.
         # @param [String] name
-        #   The name of the FHIR store to import FHIR resources to. The name should be
-        #   in the format of
+        #   The name of the FHIR store to import FHIR resources to, in the format of
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   fhirStores/`fhir_store_id``.
         # @param [Google::Apis::HealthcareV1::ImportResourcesRequest] import_resources_request_object
@@ -1993,95 +2034,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches for resources in the given FHIR store according to criteria
-        # specified as query parameters.
-        # Implements the FHIR standard search interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#search),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#search),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#search))
-        # using the search semantics described in the FHIR Search specification
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/search.html),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/search.html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/search.html)).
-        # Supports three methods of search defined by the specification:
-        # *  `GET [base]?[parameters]` to search across all resources.
-        # *  `GET [base]/[type]?[parameters]` to search resources of a specified
-        # type.
-        # *  `POST [base]/[type]/_search?[parameters]` as an alternate form having
-        # the same semantics as the `GET` method.
-        # The `GET` methods do not support compartment searches. The `POST` method
-        # does not support `application/x-www-form-urlencoded` search parameters.
-        # On success, the response body will contain a JSON-encoded representation
-        # of a `Bundle` resource of type `searchset`, containing the results of the
-        # search.
-        # Errors generated by the FHIR store will contain a JSON-encoded
-        # `OperationOutcome` resource describing the reason for the error. If the
-        # request cannot be mapped to a valid API method on a FHIR store, a generic
-        # GCP error might be returned instead.
-        # The server's capability statement, retrieved through
-        # capabilities, indicates what search parameters
-        # are supported on each FHIR resource. A list of all search parameters
-        # defined by the specification can be found in the FHIR Search Parameter
-        # Registry
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/searchparameter-registry.
-        # html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/searchparameter-registry.html))
-        # .
-        # FHIR search parameters for DSTU2 can be found on each resource's definition
-        # page.
-        # Supported search modifiers: `:missing`, `:exact`, `:contains`, `:text`,
-        # `:in`, `:not-in`, `:above`, `:below`, `:[type]`, `:not`, and `:recurse`.
-        # Supported search result parameters: `_sort`, `_count`, `_include`,
-        # `_revinclude`, `_summary=text`, `_summary=data`, and `_elements`.
-        # The maximum number of search results returned defaults to 100, which can
-        # be overridden by the `_count` parameter up to a maximum limit of 1000. If
-        # there are additional results, the returned `Bundle` will contain
-        # pagination links.
-        # Resources with a total size larger than 5MB or a field count larger than
-        # 50,000 might not be fully searchable as the server might trim its generated
-        # search index in those cases.
-        # Note: FHIR resources are indexed asynchronously, so there might be a slight
-        # delay between the time a resource is created or changes and when the change
-        # is reflected in search results.
-        # @param [String] parent
-        #   Name of the FHIR store to retrieve resources from.
-        # @param [String] resource_type
-        #   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)).
-        # @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::HealthcareV1::HttpBody] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::HealthcareV1::HttpBody]
-        #
-        # @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 search_project_location_dataset_fhir_stores(parent, resource_type: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1/{+parent}/fhir', options)
-          command.response_representation = Google::Apis::HealthcareV1::HttpBody::Representation
-          command.response_class = Google::Apis::HealthcareV1::HttpBody
-          command.params['parent'] = parent unless parent.nil?
-          command.query['resourceType'] = resource_type unless resource_type.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
-        # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -2117,7 +2072,7 @@ module Google
         
         # Returns permissions that a caller has on the specified resource.
         # If the resource does not exist, this will return an empty set of
-        # permissions, not a NOT_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # Note: This operation is designed to be used for building permission-aware
         # UIs and command-line tools, not for authorization checking. This operation
         # may "fail open" without warning.
@@ -2154,8 +2109,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves all the resources directly referenced by a patient, as well as
-        # all of the resources in the patient compartment.
+        # Retrieves a Patient resource and resources related to that patient.
         # Implements the FHIR extended operation Patient-everything
         # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/patient-operations.html#
         # everything),
@@ -2170,6 +2124,16 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # The resources in scope for the response are:
+        # * The patient resource itself.
+        # * All the resources directly referenced by the patient resource.
+        # * Resources directly referencing the patient resource that meet the
+        # inclusion criteria. The inclusion criteria are based on the membership
+        # rules in the patient compartment definition
+        # ([DSTU2](http://hl7.org/fhir/DSTU2/compartment-patient.html),
+        # [STU3](http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html),
+        # [R4](http://hl7.org/fhir/R4/compartmentdefinition-patient.html)), which
+        # details the eligible resource types and referencing search parameters.
         # @param [String] name
         #   Name of the `Patient` resource for which the information is required.
         # @param [Fixnum] _count
@@ -2822,8 +2786,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified HL7v2 store and removes all messages that are
-        # contained within it.
+        # Deletes the specified HL7v2 store and removes all messages that it
+        # contains.
         # @param [String] name
         #   The resource name of the HL7v2 store to delete.
         # @param [String] fields
@@ -2896,6 +2860,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2968,7 +2935,7 @@ module Google
         
         # Updates the HL7v2 store.
         # @param [String] name
-        #   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``.
         # @param [Google::Apis::HealthcareV1::Hl7V2Store] hl7_v2_store_object
         # @param [String] update_mask
@@ -3008,7 +2975,7 @@ module Google
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
-        # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -3044,7 +3011,7 @@ module Google
         
         # Returns permissions that a caller has on the specified resource.
         # If the resource does not exist, this will return an empty set of
-        # permissions, not a NOT_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # Note: This operation is designed to be used for building permission-aware
         # UIs and command-line tools, not for authorization checking. This operation
         # may "fail open" without warning.