google-api-client 0.39.1 → 0.40.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 = '20200414'
+      REVISION = '20200515'
 
       # 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

@@ -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::HealthcareV1beta1::Message]
         attr_accessor :message
@@ -276,8 +277,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
       
@@ -1111,14 +1112,14 @@ module Google
         # 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
+        # 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.
+        # 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
@@ -1385,9 +1386,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 +1422,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 +1473,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 +1518,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 +1636,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
@@ -1658,22 +1659,22 @@ module Google
         # @return [String]
         attr_accessor :filter
       
-        # The [Cloud Pubsub](https://cloud.google.com/pubsub/docs/) topic that
+        # 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
         # 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. 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 Stackdriver (see [Viewing logs](/healthcare/docs/how-
-        # tos/stackdriver-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
@@ -1731,7 +1732,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
@@ -1936,8 +1937,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 +1992,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 +2021,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
@@ -2270,8 +2273,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
       
@@ -2371,12 +2375,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]
@@ -2489,7 +2493,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
@@ -2596,10 +2600,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": [
@@ -2614,7 +2621,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",
@@ -2692,6 +2701,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
@@ -2979,9 +2991,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
@@ -3050,10 +3062,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": [
@@ -3068,7 +3083,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",
@@ -3106,8 +3123,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
@@ -3162,7 +3178,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
       
@@ -3198,7 +3214,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>]

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

@@ -174,8 +174,8 @@ module Google
         # DICOM instances. The new de-identified dataset will not contain these
         # failed resources. Failed resource totals are tracked in
         # DeidentifySummary.failure_resource_count.
-        # 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``.
@@ -286,6 +286,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
@@ -394,7 +397,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.
@@ -430,7 +433,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.
@@ -480,6 +483,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
@@ -510,7 +516,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.
@@ -546,7 +552,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.
@@ -633,8 +639,8 @@ module Google
         # DICOM instances. The output DICOM store will not contain
         # these failed resources. Failed resource totals are tracked in
         # DeidentifySummary.failure_resource_count.
-        # 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`/
@@ -702,8 +708,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
@@ -784,6 +790,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
@@ -815,9 +824,8 @@ module Google
         # Imports data into the DICOM store by copying it from the specified source.
         # For errors, the Operation is populated with error details (in the form
         # of ImportDicomDataErrorDetails in error.details), which hold
-        # finer-grained error information. Errors are also logged to Stackdriver
-        # Logging. For more information,
-        # see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging).
+        # finer-grained error information. 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
@@ -939,7 +947,8 @@ 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.
+        # [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`/
@@ -977,7 +986,8 @@ 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.
+        # [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`/
@@ -1014,7 +1024,8 @@ 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.
+        # [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`/
@@ -1051,7 +1062,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.
@@ -1087,7 +1098,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`/
@@ -1128,7 +1141,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.
@@ -1200,7 +1213,8 @@ 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`/
@@ -1237,7 +1251,8 @@ 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`/
@@ -1274,7 +1289,8 @@ 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.
+        # [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`/
@@ -1312,7 +1328,8 @@ 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.
+        # [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`/
@@ -1350,7 +1367,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`/
@@ -1429,7 +1448,8 @@ 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`/
@@ -1466,7 +1486,8 @@ 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`/
@@ -1503,7 +1524,8 @@ 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.
+        # [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`/
@@ -1580,7 +1602,8 @@ 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`/
@@ -1619,7 +1642,8 @@ 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`/
@@ -1657,7 +1681,8 @@ 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`/
@@ -1695,7 +1720,8 @@ 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`/
@@ -1735,7 +1761,8 @@ 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`/
@@ -1818,8 +1845,8 @@ module Google
         # error
         # details field type is
         # DeidentifyErrorDetails.
-        # Errors are also logged to Stackdriver
-        # (see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging)).
+        # Errors 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`/
@@ -1890,16 +1917,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::HealthcareV1beta1::ExportResourcesRequest] export_resources_request_object
@@ -1975,6 +2001,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
@@ -2010,8 +2039,8 @@ module Google
         # 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
@@ -2033,10 +2062,10 @@ module Google
         # 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
@@ -2061,15 +2090,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::HealthcareV1beta1::ImportResourcesRequest] import_resources_request_object
@@ -2184,95 +2212,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::HealthcareV1beta1::HttpBody] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::HealthcareV1beta1::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, 'v1beta1/{+parent}/fhir', options)
-          command.response_representation = Google::Apis::HealthcareV1beta1::HttpBody::Representation
-          command.response_class = Google::Apis::HealthcareV1beta1::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.
@@ -2308,7 +2250,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.
@@ -2463,9 +2405,9 @@ module Google
         # search criteria specified as query parameters, grouped by
         # `Observation.code`, sorted from most recent to oldest.
         # Implements the FHIR extended operation Observation-lastn
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/observation-operations.
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/observation-operations.
         # html#lastn),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/observation-operations.html#
+        # [R4](https://hl7.org/implement/standards/fhir/R4/observation-operations.html#
         # lastn)).
         # DSTU2 doesn't define the Observation-lastn method, but the server supports
         # it the same way it supports STU3.
@@ -2483,10 +2425,10 @@ module Google
         # grouping and limiting the results with `max`. To stay within the limit,
         # constrain these searches using Observation search parameters such as
         # `_lastUpdated` or `date`.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of a `Bundle` resource of type `searchset`, containing the results of the
         # operation.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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.
@@ -2519,30 +2461,39 @@ 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#
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/patient-operations.
+        # html#everything),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/patient-operations.html#
         # everything),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/patient-operations.html#
-        # everything),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/patient-operations.html#
+        # [R4](https://hl7.org/implement/standards/fhir/R4/patient-operations.html#
         # everything)).
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of a `Bundle` resource of type `searchset`, containing the results of the
         # operation.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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 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](https://hl7.org/fhir/DSTU2/compartment-patient.html),
+        # [STU3](http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html),
+        # [R4](https://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
         #   Maximum number of resources in a page. Defaults to 100.
         # @param [String] _page_token
         #   Used to retrieve the next or previous page of results
-        #   when using pagination. Value should be set to the value of page_token set
-        #   in next or previous page links' urls. Next and previous page are returned
+        #   when using pagination. Value should be set to the value of `page_token` set
+        #   in next or previous page links' URLs. Next and previous page are returned
         #   in the response bundle's links field, where `link.relation` is "previous"
         #   or "next".
         #   Omit `page_token` if no previous request has been made.
@@ -2617,20 +2568,21 @@ module Google
         end
         
         # Gets the FHIR capability statement
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/capabilitystatement.html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/capabilitystatement.html)),
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/capabilitystatement.html)
+        # ,
+        # [R4](https://hl7.org/implement/standards/fhir/R4/capabilitystatement.html)),
         # or the [conformance
-        # statement](http://hl7.org/implement/standards/fhir/DSTU2/conformance.html)
+        # statement](https://hl7.org/implement/standards/fhir/DSTU2/conformance.html)
         # in the DSTU2 case for the store, which contains a description of
         # functionality supported by the server.
         # Implements the FHIR standard capabilities interaction
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#capabilities),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#capabilities)),
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#capabilities),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#capabilities)),
         # or the [conformance
-        # interaction](http://hl7.org/implement/standards/fhir/DSTU2/http.html#
+        # interaction](https://hl7.org/implement/standards/fhir/DSTU2/http.html#
         # conformance)
         # in the DSTU2 case.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of a `CapabilityStatement` resource.
         # @param [String] name
         #   Name of the FHIR store to retrieve the capabilities for.
@@ -2663,26 +2615,28 @@ module Google
         
         # Deletes FHIR resources that match a search query.
         # Implements the FHIR standard conditional delete interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.12.1),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.13.1),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#3.1.0.7.1)).
-        # If multiple resources match, all of them will be deleted.
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.12.1),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.13.1),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#3.1.0.7.1)).
+        # If multiple resources match, all matching resources are deleted.
         # Search terms are provided as query parameters following the same pattern as
         # the search method.
         # Note: Unless resource versioning is disabled by setting the
         # disable_resource_versioning flag
-        # on the FHIR store, the deleted resources will be moved to a history
+        # on the FHIR store, the deleted resources are moved to a history
         # repository that can still be retrieved through vread
         # and related methods, unless they are removed by the
         # purge method.
+        # This method requires the`healthcare.fhirStores.searchResources` and
+        # `healthcare.fhirResources.delete` permissions on the parent FHIR store.
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
         #   The FHIR resource type to delete, 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)).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2715,30 +2669,33 @@ module Google
         # parameters, updates part of that resource by applying the operations
         # specified in a [JSON Patch](http://jsonpatch.com/) document.
         # Implements the FHIR standard conditional patch interaction
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#patch),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#patch)).
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#patch),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#patch)).
         # DSTU2 doesn't define a conditional patch method, but the server supports it
         # in the same way it supports STU3.
         # Search terms are provided as query parameters following the same pattern as
         # the search method.
-        # If the search criteria identify more than one match, the request will
-        # return a `412 Precondition Failed` error.
+        # If the search criteria identify more than one match, the request
+        # returns a `412 Precondition Failed` error.
         # The request body must contain a JSON Patch document, and the request
         # headers must contain `Content-Type: application/json-patch+json`.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of the updated resource, including the server-assigned version ID.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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.
+        # This method requires the`healthcare.fhirStores.searchResources` permission
+        # on the parent FHIR store and the `healthcare.fhirResources.patch`
+        # permission on the requested FHIR store resource.
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
         #   The FHIR resource type to update, 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)).
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2773,36 +2730,38 @@ module Google
         # If a resource is found based on the search criteria specified in the query
         # parameters, updates the entire contents of that resource.
         # Implements the FHIR standard conditional update interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.10.2),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#cond-update),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#cond-update)).
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.10.2),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#cond-update),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#cond-update)).
         # Search terms are provided as query parameters following the same pattern as
         # the search method.
-        # If the search criteria identify more than one match, the request will
-        # return a `412 Precondition Failed` error.
+        # If the search criteria identify more than one match, the request
+        # returns a `412 Precondition Failed` error.
         # If the search criteria identify zero matches, and the supplied resource
         # body contains an `id`, and the FHIR store has
         # enable_update_create set, creates the
         # resource with the client-specified ID. If the search criteria identify zero
         # matches, and the supplied resource body does not contain an `id`, the
-        # resource will be created with a server-assigned ID as per the
+        # resource is created with a server-assigned ID as per the
         # create method.
         # The request body must contain a JSON-encoded FHIR resource, and the request
         # headers must contain `Content-Type: application/fhir+json`.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of the updated resource, including the server-assigned version ID.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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.
+        # This method requires the`healthcare.fhirStores.searchResources` and
+        # `healthcare.fhirResources.update` permissions on the parent FHIR store.
         # @param [String] parent
         #   The name of the FHIR store this resource belongs to.
         # @param [String] type
         #   The FHIR resource type to update, 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)).
         #   Must match the resource type in the provided content.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
         # @param [String] fields
@@ -2837,23 +2796,23 @@ module Google
         
         # Creates a FHIR resource.
         # Implements the FHIR standard create interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#create),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#create),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#create)),
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#create),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#create),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#create)),
         # which creates a new resource with a server-assigned resource ID.
         # Also supports the FHIR standard conditional create interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#ccreate),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#ccreate),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#ccreate)),
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#ccreate),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#ccreate),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#ccreate)),
         # specified by supplying an `If-None-Exist` header containing a FHIR search
         # query. If no resources match this search query, the server processes the
         # create operation as normal.
         # The request body must contain a JSON-encoded FHIR resource, and the request
         # headers must contain `Content-Type: application/fhir+json`.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of the resource as it was created on the server, including the
         # server-assigned resource ID and version ID.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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.
@@ -2862,9 +2821,9 @@ module Google
         # @param [String] type
         #   The FHIR resource type to create, 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)).
         #   Must match the resource type in the provided content.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
         # @param [String] fields
@@ -2899,12 +2858,12 @@ module Google
         
         # Deletes a FHIR resource.
         # Implements the FHIR standard delete interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#delete),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#delete),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#delete)).
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#delete),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#delete),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#delete)).
         # Note: Unless resource versioning is disabled by setting the
         # disable_resource_versioning flag
-        # on the FHIR store, the deleted resources will be moved to a history
+        # on the FHIR store, the deleted resources are moved to a history
         # repository that can still be retrieved through vread
         # and related methods, unless they are removed by the
         # purge method.
@@ -2939,29 +2898,35 @@ module Google
         
         # Executes all the requests in the given Bundle.
         # Implements the FHIR standard batch/transaction interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#transaction),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#transaction),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#transaction)).
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#transaction),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#transaction),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#transaction)).
         # Supports all interactions within a bundle, except search. This method
         # accepts Bundles of type `batch` and `transaction`, processing them
         # according to the batch processing rules
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.1),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.1),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#brules))
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.1),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.1),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#brules))
         # and transaction processing rules
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.2),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.2),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#trules)).
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#2.1.0.16.2),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#2.21.0.17.2),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#trules)).
         # The request body must contain a JSON-encoded FHIR `Bundle` resource, and
         # the request headers must contain `Content-Type: application/fhir+json`.
-        # For a batch bundle or a successful transaction the response body will
-        # contain a JSON-encoded representation of a `Bundle` resource of type
+        # For a batch bundle or a successful transaction the response body
+        # contains a JSON-encoded representation of a `Bundle` resource of type
         # `batch-response` or `transaction-response` containing one entry for each
         # entry in the request, with the outcome of processing the entry. In the
-        # case of an error for a transaction bundle, the response body will contain
+        # case of an error for a transaction bundle, the response body contains
         # 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.
+        # This method requires permission for executing the requests in the bundle.
+        # The `executeBundle` permission grants permission to execute the request in
+        # the bundle but you must grant sufficient permissions to execute the
+        # individual requests in the bundle. For example, if the bundle contains a
+        # `create` request, you must have permission to execute the `create` request.
+        # Logging is available for the `executeBundle` permission.
         # @param [String] parent
         #   Name of the FHIR store in which this bundle will be executed.
         # @param [Google::Apis::HealthcareV1beta1::HttpBody] http_body_object
@@ -2997,13 +2962,13 @@ module Google
         # Lists all the versions of a resource (including the current version and
         # deleted versions) from the FHIR store.
         # Implements the per-resource form of the FHIR standard history interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#history),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#history),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#history)).
-        # On success, the response body will contain a JSON-encoded representation
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#history),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#history),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#history)).
+        # On success, the response body contains a JSON-encoded representation
         # of a `Bundle` resource of type `history`, containing the version history
         # sorted from most recent to oldest versions.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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.
@@ -3067,15 +3032,15 @@ module Google
         # Updates part of an existing resource by applying the operations specified
         # in a [JSON Patch](http://jsonpatch.com/) document.
         # Implements the FHIR standard patch interaction
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#patch),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#patch)).
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#patch),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#patch)).
         # DSTU2 doesn't define a patch method, but the server supports it in the same
         # way it supports STU3.
         # The request body must contain a JSON Patch document, and the request
         # headers must contain `Content-Type: application/json-patch+json`.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of the updated resource, including the server-assigned version ID.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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.
@@ -3113,18 +3078,18 @@ module Google
         
         # Gets the contents of a FHIR resource.
         # Implements the FHIR standard read interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#read),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#read),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#read)).
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#read),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#read),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#read)).
         # Also supports the FHIR standard conditional read interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#cread),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#cread),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#cread))
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#cread),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#cread),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#cread))
         # specified by supplying an `If-Modified-Since` header with a date/time value
         # or an `If-None-Match` header with an ETag value.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of the resource.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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.
@@ -3160,13 +3125,13 @@ module Google
         # 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))
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#search),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#search),
+        # [R4](https://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)).
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/search.html),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/search.html),
+        # [R4](https://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
@@ -3175,10 +3140,10 @@ module Google
         # 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
+        # On success, the response body contains 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
+        # Errors generated by the FHIR store 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.
@@ -3187,10 +3152,10 @@ module Google
         # 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.
+        # ([STU3](https://hl7.org/implement/standards/fhir/STU3/searchparameter-registry.
         # html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/searchparameter-registry.html))
-        # .
+        # [R4](https://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`,
@@ -3199,7 +3164,7 @@ module Google
         # `_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
+        # there are additional results, the returned `Bundle` contains
         # 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
@@ -3241,9 +3206,9 @@ module Google
         
         # Updates the entire contents of a resource.
         # Implements the FHIR standard update interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#update),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#update),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#update)).
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#update),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#update),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#update)).
         # If the specified resource does
         # not exist and the FHIR store has
         # enable_update_create set, creates the
@@ -3252,9 +3217,9 @@ module Google
         # headers must contain `Content-Type: application/fhir+json`. The resource
         # must contain an `id` element having an identical value to the ID in the
         # REST path of the request.
-        # On success, the response body will contain a JSON-encoded representation
+        # On success, the response body contains a JSON-encoded representation
         # of the updated resource, including the server-assigned version ID.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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.
@@ -3293,12 +3258,12 @@ module Google
         # Gets the contents of a version (current or historical) of a FHIR resource
         # by version ID.
         # Implements the FHIR standard vread interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#vread),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#vread),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#vread)).
-        # On success, the response body will contain a JSON-encoded representation
+        # ([DSTU2](https://hl7.org/implement/standards/fhir/DSTU2/http.html#vread),
+        # [STU3](https://hl7.org/implement/standards/fhir/STU3/http.html#vread),
+        # [R4](https://hl7.org/implement/standards/fhir/R4/http.html#vread)).
+        # On success, the response body contains a JSON-encoded representation
         # of the resource.
-        # Errors generated by the FHIR store will contain a JSON-encoded
+        # Errors generated by the FHIR store 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.
@@ -3368,8 +3333,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
@@ -3442,6 +3407,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
@@ -3554,7 +3522,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.
@@ -3590,7 +3558,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.
@@ -3773,7 +3741,7 @@ module Google
         # @param [String] filter
         #   Restricts messages returned to those matching a filter. 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
@@ -3840,7 +3808,7 @@ module Google
         
         # Update the message.
         # The contents of the message in Message.data and data extracted from
-        # the contents such as Message.create_time cannot be altered. Only the
+        # the contents such as Message.create_time can't be altered. Only the
         # Message.labels field is allowed to be updated. The labels in the
         # request are merged with the existing set of labels. Existing labels with
         # the same keys are updated.