google-apis-healthcare_v1beta1 0.3.0 → 0.4.0

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module HealthcareV1beta1
       # Version of the google-apis-healthcare_v1beta1 gem
-      GEM_VERSION = "0.3.0"
+      GEM_VERSION = "0.4.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.1.2"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210205"
+      REVISION = "20210217"
     end
   end
 end

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

@@ -1072,11 +1072,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Checks if a particular data_id of a User data mapping in the given Consent
-        # store is consented for a given use.
+        # Checks if a particular data_id of a User data mapping in the specified consent
+        # store is consented for the specified use.
         # @param [String] consent_store
-        #   Name of the Consent store where the requested data_id is stored, of the form `
-        #   projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
+        #   Required. Name of the consent store where the requested data_id is stored, of
+        #   the form `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   consentStores/`consent_store_id``.
         # @param [Google::Apis::HealthcareV1beta1::CheckDataAccessRequest] check_data_access_request_object
         # @param [String] fields
@@ -1108,15 +1108,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new Consent store in the parent dataset. Attempting to create a
+        # Creates a new consent store in the parent dataset. Attempting to create a
         # consent store with the same ID as an existing store fails with an
         # ALREADY_EXISTS error.
         # @param [String] parent
-        #   Required. The name of the dataset this Consent store belongs to.
+        #   Required. The name of the dataset this consent store belongs to.
         # @param [Google::Apis::HealthcareV1beta1::ConsentStore] consent_store_object
         # @param [String] consent_store_id
-        #   The ID of the consent store to create. The string must match the following
-        #   regex: `[\p`L`\p`N`_\-\.]`1,256``.
+        #   Required. The ID of the consent store to create. The string must match the
+        #   following regex: `[\p`L`\p`N`_\-\.]`1,256``. Cannot be changed after creation.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1147,10 +1147,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified Consent store and removes all consent data in the
-        # specified consent store.
+        # Deletes the specified consent store and removes all the consent store's data.
         # @param [String] name
-        #   Required. The resource name of the Consent store to delete.
+        #   Required. The resource name of the consent store to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1178,12 +1177,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Evaluates the end user's Consents for all matching User data mappings. Note:
-        # User data mappings are indexed asynchronously, so there might be a slight
-        # delay between the time a mapping is created or updated and when it is included
-        # in the results of EvaluateUserConsents.
+        # Evaluates the user's Consents for all matching User data mappings. Note: User
+        # data mappings are indexed asynchronously, which can cause a slight delay
+        # between the time mappings are created or updated and when they are included in
+        # EvaluateUserConsents results.
         # @param [String] consent_store
-        #   Name of the Consent store to retrieve user data mappings from.
+        #   Required. Name of the consent store to retrieve User data mappings from.
         # @param [Google::Apis::HealthcareV1beta1::EvaluateUserConsentsRequest] evaluate_user_consents_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1214,9 +1213,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the specified Consent store.
+        # Gets the specified consent store.
         # @param [String] name
-        #   Required. The resource name of the Consent store to get.
+        #   Required. The resource name of the consent store to get.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1285,37 +1284,38 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the Consent stores in the given dataset.
+        # Lists the consent stores in the specified dataset.
         # @param [String] parent
         #   Required. Name of the dataset.
         # @param [String] filter
-        #   Restricts the stores returned to those matching a filter. The following syntax
-        #   is available: * A string field value can be written as text inside quotation
-        #   marks, for example `"query text"`. The only valid relational operation for
-        #   text fields is equality (`=`), where text is searched within the field, rather
-        #   than having the field be equal to the text. For example, `"Comment = great"`
-        #   returns messages with `great` in the comment field. * A number field value can
-        #   be written as an integer, a decimal, or an exponential. The valid relational
-        #   operators for number fields are the equality operator (`=`), along with the
+        #   Optional. Restricts the stores returned to those matching a filter. The
+        #   following syntax is available: * A string field value can be written as text
+        #   inside quotation marks, for example `"query text"`. The only valid relational
+        #   operation for text fields is equality (`=`), where text is searched within the
+        #   field, rather than having the field be equal to the text. For example, `"
+        #   Comment = great"` returns messages with `great` in the comment field. * A
+        #   number field value can be written as an integer, a decimal, or an exponential.
+        #   The valid relational operators for number fields are the equality operator (`=`
+        #   ), along with the less than/greater than operators (`<`, `<=`, `>`, `>=`).
+        #   Note that there is no inequality (`!=`) operator. You can prepend the `NOT`
+        #   operator to an expression to negate it. * A date field value must be written
+        #   in `yyyy-mm-dd` form. Fields with date and time use the RFC3339 time format.
+        #   Leading zeros are required for one-digit months and days. The valid relational
+        #   operators for date fields are the equality operator (`=`) , along with the
         #   less than/greater than operators (`<`, `<=`, `>`, `>=`). Note that there is no
         #   inequality (`!=`) operator. You can prepend the `NOT` operator to an
-        #   expression to negate it. * A date field value must be written in `yyyy-mm-dd`
-        #   form. Fields with date and time use the RFC3339 time format. Leading zeros are
-        #   required for one-digit months and days. The valid relational operators for
-        #   date fields are the equality operator (`=`) , along with the less than/greater
-        #   than operators (`<`, `<=`, `>`, `>=`). Note that there is no inequality (`!=`)
-        #   operator. You can prepend the `NOT` operator to an expression to negate it. *
-        #   Multiple field query expressions can be combined in one query by adding `AND`
-        #   or `OR` operators between the expressions. If a boolean operator appears
-        #   within a quoted string, it is not treated as special, it's just another part
-        #   of the character string to be matched. You can prepend the `NOT` operator to
-        #   an expression to negate it. Only filtering on labels is supported. For example,
-        #   `labels.key=value`.
+        #   expression to negate it. * Multiple field query expressions can be combined in
+        #   one query by adding `AND` or `OR` operators between the expressions. If a
+        #   boolean operator appears within a quoted string, it is not treated as special,
+        #   it's just another part of the character string to be matched. You can prepend
+        #   the `NOT` operator to an expression to negate it. Only filtering on labels is
+        #   supported. For example, `filter=labels.key=value`.
         # @param [Fixnum] page_size
-        #   Limit on the number of Consent stores to return in a single response. If not
-        #   specified, 100 is used. May not be larger than 1000.
+        #   Optional. Limit on the number of consent stores to return in a single response.
+        #   If not specified, 100 is used. May not be larger than 1000.
         # @param [String] page_token
-        #   Token to retrieve the next page of results or empty to get the first page.
+        #   Optional. Token to retrieve the next page of results, or empty to get the
+        #   first page.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1346,16 +1346,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified Consent store.
+        # Updates the specified consent store.
         # @param [String] name
-        #   Resource name of the Consent store, of the form `projects/`project_id`/
+        #   Resource name of the consent store, of the form `projects/`project_id`/
         #   locations/`location_id`/datasets/`dataset_id`/consentStores/`consent_store_id``
-        #   .
+        #   . Cannot be changed after creation.
         # @param [Google::Apis::HealthcareV1beta1::ConsentStore] consent_store_object
         # @param [String] update_mask
-        #   The update mask that applies to the resource. For the `FieldMask` definition,
-        #   see https://developers.google.com/protocol-buffers/docs/reference/google.
-        #   protobuf#fieldmask. The `labels` field is allowed to be updated.
+        #   Required. The update mask that applies to the resource. For the `FieldMask`
+        #   definition, see https://developers.google.com/protocol-buffers/docs/reference/
+        #   google.protobuf#fieldmask. Only the `labels`, `default_consent_ttl`, and `
+        #   enable_consent_create_on_update` fields are allowed to be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1386,27 +1387,28 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Queries all data_ids that are consented for a given use in the given Consent
-        # store and writes them to a specified destination. The returned Operation
-        # includes a progress counter for the number of User data mappings processed.
-        # Errors are logged to Cloud Logging (see [Viewing logs] (/healthcare/docs/how-
-        # tos/logging)). For example, the following sample log entry shows a `failed to
-        # evaluate consent policy` error that occurred during a QueryAccessibleData call
-        # to consent store `projects/`project_id`/locations/`location_id`/datasets/`
-        # dataset_id`/consentStores/`consent_store_id``. ```json jsonPayload: ` @type: "
-        # type.googleapis.com/google.cloud.healthcare.logging.
-        # QueryAccessibleDataLogEntry" error: ` code: 9 message: "failed to evaluate
-        # consent policy" ` resourceName: "projects/`project_id`/locations/`location_id`/
-        # datasets/`dataset_id`/consentStores/`consent_store_id`/consents/`consent_id`" `
-        # logName: "projects/`project_id`/logs/healthcare.googleapis.com%
-        # 2Fquery_accessible_data" operation: ` id: "projects/`project_id`/locations/`
-        # location_id`/datasets/`dataset_id`/operations/`operation_id`" producer: "
-        # healthcare.googleapis.com/QueryAccessibleData" ` receiveTimestamp: "TIMESTAMP"
-        # resource: ` labels: ` consent_store_id: "`consent_store_id`" dataset_id: "`
-        # dataset_id`" location: "`location_id`" project_id: "`project_id`" ` type: "
-        # healthcare_consent_store" ` severity: "ERROR" timestamp: "TIMESTAMP" ```
+        # Queries all data_ids that are consented for a specified use in the given
+        # consent store and writes them to a specified destination. The returned
+        # Operation includes a progress counter for the number of User data mappings
+        # processed. Errors are logged to Cloud Logging (see [Viewing logs] (cloud.
+        # google.com/healthcare/docs/how-tos/logging)). For example, the following
+        # sample log entry shows a `failed to evaluate consent policy` error that
+        # occurred during a QueryAccessibleData call to consent store `projects/`
+        # project_id`/locations/`location_id`/datasets/`dataset_id`/consentStores/`
+        # consent_store_id``. ```json jsonPayload: ` @type: "type.googleapis.com/google.
+        # cloud.healthcare.logging.QueryAccessibleDataLogEntry" error: ` code: 9 message:
+        # "failed to evaluate consent policy" ` resourceName: "projects/`project_id`/
+        # locations/`location_id`/datasets/`dataset_id`/consentStores/`consent_store_id`/
+        # consents/`consent_id`" ` logName: "projects/`project_id`/logs/healthcare.
+        # googleapis.com%2Fquery_accessible_data" operation: ` id: "projects/`project_id`
+        # /locations/`location_id`/datasets/`dataset_id`/operations/`operation_id`"
+        # producer: "healthcare.googleapis.com/QueryAccessibleData" ` receiveTimestamp: "
+        # TIMESTAMP" resource: ` labels: ` consent_store_id: "`consent_store_id`"
+        # dataset_id: "`dataset_id`" location: "`location_id`" project_id: "`project_id`"
+        # ` type: "healthcare_consent_store" ` severity: "ERROR" timestamp: "TIMESTAMP"
+        # ```
         # @param [String] consent_store
-        #   Name of the Consent store to retrieve user data mappings from.
+        #   Required. Name of the consent store to retrieve User data mappings from.
         # @param [Google::Apis::HealthcareV1beta1::QueryAccessibleDataRequest] query_accessible_data_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1511,7 +1513,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new Attribute definition in the parent Consent store.
+        # Creates a new Attribute definition in the parent consent store.
         # @param [String] parent
         #   Required. The name of the consent store that this Attribute definition belongs
         #   to.
@@ -1551,10 +1553,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified Attribute definition. Fails if it is referenced by any
-        # User data mapping, or the latest revision of any Consent.
+        # Deletes the specified Attribute definition. Fails if the Attribute definition
+        # is referenced by any User data mapping, or the latest revision of any Consent.
         # @param [String] name
-        #   Required. The resource name of the Attribute definition to delete.
+        #   Required. The resource name of the Attribute definition to delete. To preserve
+        #   referential integrity, Attribute definitions referenced by a User data mapping
+        #   or the latest revision of a Consent cannot be deleted.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1612,13 +1616,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the Attribute definitions in the given Consent store.
+        # Lists the Attribute definitions in the specified consent store.
         # @param [String] parent
-        #   Required. Name of the Consent store to retrieve attribute definitions from.
+        #   Required. Name of the consent store to retrieve Attribute definitions from.
         # @param [String] filter
-        #   Restricts the attributes returned to those matching a filter. The following
-        #   syntax is available: * A string field value can be written as text inside
-        #   quotation marks, for example `"query text"`. The only valid relational
+        #   Optional. Restricts the attributes returned to those matching a filter. The
+        #   following syntax is available: * A string field value can be written as text
+        #   inside quotation marks, for example `"query text"`. The only valid relational
         #   operation for text fields is equality (`=`), where text is searched within the
         #   field, rather than having the field be equal to the text. For example, `"
         #   Comment = great"` returns messages with `great` in the comment field. * A
@@ -1637,12 +1641,13 @@ module Google
         #   boolean operator appears within a quoted string, it is not treated as special,
         #   it's just another part of the character string to be matched. You can prepend
         #   the `NOT` operator to an expression to negate it. The only field available for
-        #   filtering is `category`.
+        #   filtering is `category`. For example, `filter=category=\"REQUEST\"`.
         # @param [Fixnum] page_size
-        #   Limit on the number of attribute definitions to return in a single response.
-        #   If not specified, 100 is used. May not be larger than 1000.
+        #   Optional. Limit on the number of Attribute definitions to return in a single
+        #   response. If not specified, 100 is used. May not be larger than 1000.
         # @param [String] page_token
-        #   Token to retrieve the next page of results or empty to get the first page.
+        #   Optional. Token to retrieve the next page of results or empty to get the first
+        #   page.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1675,17 +1680,18 @@ module Google
         
         # Updates the specified Attribute definition.
         # @param [String] name
-        #   Resource name of the attribute definition, of the form `projects/`project_id`/
+        #   Resource name of the Attribute definition, of the form `projects/`project_id`/
         #   locations/`location_id`/datasets/`dataset_id`/consentStores/`consent_store_id`/
-        #   attributeDefinitions/`attribute_definition_id``.
+        #   attributeDefinitions/`attribute_definition_id``. Cannot be changed after
+        #   creation.
         # @param [Google::Apis::HealthcareV1beta1::AttributeDefinition] attribute_definition_object
         # @param [String] update_mask
-        #   The update mask that applies to the resource. For the `FieldMask` definition,
-        #   see https://developers.google.com/protocol-buffers/docs/reference/google.
-        #   protobuf#fieldmask. The `description`, `allowed_values`, `
-        #   consent_default_values`, and `data_mapping_default_value` fields are allowed
-        #   to be updated. The updated `allowed_values` must contain all values from the
-        #   previous `allowed_values`.
+        #   Required. The update mask that applies to the resource. For the `FieldMask`
+        #   definition, see https://developers.google.com/protocol-buffers/docs/reference/
+        #   google.protobuf#fieldmask. Only the `description`, `allowed_values`, `
+        #   consent_default_values` and `data_mapping_default_value` fields can be updated.
+        #   The updated `allowed_values` must contain all values from the previous `
+        #   allowed_values`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1716,9 +1722,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new Consent artifact in the parent Consent store.
+        # Creates a new Consent artifact in the parent consent store.
         # @param [String] parent
-        #   Required. The name of the Consent store this consent artifact belongs to.
+        #   Required. The name of the consent store this Consent artifact belongs to.
         # @param [Google::Apis::HealthcareV1beta1::ConsentArtifact] consent_artifact_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1749,10 +1755,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified Consent artifact. Fails if it is referenced by the
-        # latest revision of any Consent.
+        # Deletes the specified Consent artifact. Fails if the artifact is referenced by
+        # the latest revision of any Consent.
         # @param [String] name
-        #   Required. The resource name of the consent artifact to delete.
+        #   Required. The resource name of the Consent artifact to delete. To preserve
+        #   referential integrity, Consent artifacts referenced by the latest revision of
+        #   a Consent cannot be deleted.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1782,7 +1790,7 @@ module Google
         
         # Gets the specified Consent artifact.
         # @param [String] name
-        #   Required. The resource name of the consent artifact to retrieve.
+        #   Required. The resource name of the Consent artifact to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1810,13 +1818,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the Consent artifacts in the given Consent store.
+        # Lists the Consent artifacts in the specified consent store.
         # @param [String] parent
-        #   Required. Name of the Consent store to retrieve consent artifacts from.
+        #   Required. Name of the consent store to retrieve consent artifacts from.
         # @param [String] filter
-        #   Restricts the artifacts returned to those matching a filter. The following
-        #   syntax is available: * A string field value can be written as text inside
-        #   quotation marks, for example `"query text"`. The only valid relational
+        #   Optional. Restricts the artifacts returned to those matching a filter. The
+        #   following syntax is available: * A string field value can be written as text
+        #   inside quotation marks, for example `"query text"`. The only valid relational
         #   operation for text fields is equality (`=`), where text is searched within the
         #   field, rather than having the field be equal to the text. For example, `"
         #   Comment = great"` returns messages with `great` in the comment field. * A
@@ -1835,13 +1843,15 @@ module Google
         #   boolean operator appears within a quoted string, it is not treated as special,
         #   it's just another part of the character string to be matched. You can prepend
         #   the `NOT` operator to an expression to negate it. The fields available for
-        #   filtering are: - user_id - consent_content_version - metadata. For example, `
-        #   Metadata("key")="value"` or `HasMetadata("key")`.
+        #   filtering are: - user_id. For example, `filter=user_id=\"user123\"`. -
+        #   consent_content_version - metadata. For example, `filter=Metadata(\"testkey\")=
+        #   \"value\"` or `filter=HasMetadata(\"testkey\")`.
         # @param [Fixnum] page_size
-        #   Limit on the number of consent artifacts to return in a single response. If
-        #   not specified, 100 is used. May not be larger than 1000.
+        #   Optional. Limit on the number of consent artifacts to return in a single
+        #   response. If not specified, 100 is used. May not be larger than 1000.
         # @param [String] page_token
-        #   The next_page_token value returned from the previous List request, if any.
+        #   Optional. The next_page_token value returned from the previous List request,
+        #   if any.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1873,12 +1883,12 @@ module Google
         end
         
         # Activates the latest revision of the specified Consent by committing a new
-        # revision with `state` updated to `ACTIVE`. If the latest revision of the given
-        # consent is in the `ACTIVE` state, no new revision is committed. A
-        # FAILED_PRECONDITION error occurs if the latest revision of the given consent
-        # is in the `REJECTED` or `REVOKED` state.
+        # revision with `state` updated to `ACTIVE`. If the latest revision of the
+        # specified Consent is in the `ACTIVE` state, no new revision is committed. A
+        # FAILED_PRECONDITION error occurs if the latest revision of the specified
+        # consent is in the `REJECTED` or `REVOKED` state.
         # @param [String] name
-        #   Required. The resource name of the consent to activate, of the form `projects/`
+        #   Required. The resource name of the Consent to activate, of the form `projects/`
         #   project_id`/locations/`location_id`/datasets/`dataset_id`/consentStores/`
         #   consent_store_id`/consents/`consent_id``. An INVALID_ARGUMENT error occurs if `
         #   revision_id` is specified in the name.
@@ -1912,7 +1922,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new Consent in the parent Consent store.
+        # Creates a new Consent in the parent consent store.
         # @param [String] parent
         #   Required. Name of the consent store.
         # @param [Google::Apis::HealthcareV1beta1::Consent] consent_object
@@ -1947,10 +1957,10 @@ module Google
         
         # Deletes the Consent and its revisions. To keep a record of the Consent but
         # mark it inactive, see [RevokeConsent]. To delete a revision of a Consent, see [
-        # DeleteConsentRevision]. This operation does not delete the related consent
+        # DeleteConsentRevision]. This operation does not delete the related Consent
         # artifact.
         # @param [String] name
-        #   Required. The resource name of the consent to delete, of the form `projects/`
+        #   Required. The resource name of the Consent to delete, of the form `projects/`
         #   project_id`/locations/`location_id`/datasets/`dataset_id`/consentStores/`
         #   consent_store_id`/consents/`consent_id``. An INVALID_ARGUMENT error occurs if `
         #   revision_id` is specified in the name.
@@ -1984,7 +1994,7 @@ module Google
         # Deletes the specified revision of a Consent. An INVALID_ARGUMENT error occurs
         # if the specified revision is the latest revision.
         # @param [String] name
-        #   Required. The resource name of the consent revision to delete, of the form `
+        #   Required. The resource name of the Consent revision to delete, of the form `
         #   projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
         #   consentStores/`consent_store_id`/consents/`consent_id`@`revision_id``. An
         #   INVALID_ARGUMENT error occurs if `revision_id` is not specified in the name.
@@ -2018,10 +2028,10 @@ module Google
         # Gets the specified revision of a Consent, or the latest revision if `
         # revision_id` is not specified in the resource name.
         # @param [String] name
-        #   Required. The resource name of the consent to retrieve, of the form `projects/`
+        #   Required. The resource name of the Consent to retrieve, of the form `projects/`
         #   project_id`/locations/`location_id`/datasets/`dataset_id`/consentStores/`
         #   consent_store_id`/consents/`consent_id``. In order to retrieve a previous
-        #   revision of the consent, also provide the revision ID: `projects/`project_id`/
+        #   revision of the Consent, also provide the revision ID: `projects/`project_id`/
         #   locations/`location_id`/datasets/`dataset_id`/consentStores/`consent_store_id`/
         #   consents/`consent_id`@`revision_id``
         # @param [String] fields
@@ -2051,14 +2061,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the Consent in the given Consent store, returning each consent's latest
+        # Lists the Consent in the given consent store, returning each Consent's latest
         # revision.
         # @param [String] parent
-        #   Required. Name of the Consent store to retrieve consents from.
+        #   Required. Name of the consent store to retrieve Consents from.
         # @param [String] filter
-        #   Restricts the consents returned to those matching a filter. The following
-        #   syntax is available: * A string field value can be written as text inside
-        #   quotation marks, for example `"query text"`. The only valid relational
+        #   Optional. Restricts the consents returned to those matching a filter. The
+        #   following syntax is available: * A string field value can be written as text
+        #   inside quotation marks, for example `"query text"`. The only valid relational
         #   operation for text fields is equality (`=`), where text is searched within the
         #   field, rather than having the field be equal to the text. For example, `"
         #   Comment = great"` returns messages with `great` in the comment field. * A
@@ -2077,13 +2087,15 @@ module Google
         #   boolean operator appears within a quoted string, it is not treated as special,
         #   it's just another part of the character string to be matched. You can prepend
         #   the `NOT` operator to an expression to negate it. The fields available for
-        #   filtering are: - user_id - consent_artifact - state - revision_create_time -
-        #   metadata. For example, `Metadata("key")="value"` or `HasMetadata("key")`.
+        #   filtering are: - user_id. For example, `filter='user_id="user123"'`. -
+        #   consent_artifact - state - revision_create_time - metadata. For example, `
+        #   filter=Metadata(\"testkey\")=\"value\"` or `filter=HasMetadata(\"testkey\")`.
         # @param [Fixnum] page_size
-        #   Limit on the number of consents to return in a single response. If not
-        #   specified, 100 is used. May not be larger than 1000.
+        #   Optional. Limit on the number of Consents to return in a single response. If
+        #   not specified, 100 is used. May not be larger than 1000.
         # @param [String] page_token
-        #   The next_page_token value returned from the previous List request, if any.
+        #   Optional. The next_page_token value returned from the previous List request,
+        #   if any.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2114,13 +2126,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the revisions of the given Consent in reverse chronological order.
+        # Lists the revisions of the specified Consent in reverse chronological order.
         # @param [String] name
-        #   Required. The resource name of the consent to retrieve revisions for.
+        #   Required. The resource name of the Consent to retrieve revisions for.
         # @param [String] filter
-        #   Restricts the revisions returned to those matching a filter. The following
-        #   syntax is available: * A string field value can be written as text inside
-        #   quotation marks, for example `"query text"`. The only valid relational
+        #   Optional. Restricts the revisions returned to those matching a filter. The
+        #   following syntax is available: * A string field value can be written as text
+        #   inside quotation marks, for example `"query text"`. The only valid relational
         #   operation for text fields is equality (`=`), where text is searched within the
         #   field, rather than having the field be equal to the text. For example, `"
         #   Comment = great"` returns messages with `great` in the comment field. * A
@@ -2139,13 +2151,15 @@ module Google
         #   boolean operator appears within a quoted string, it is not treated as special,
         #   it's just another part of the character string to be matched. You can prepend
         #   the `NOT` operator to an expression to negate it. Fields/functions available
-        #   for filtering are: - user_id - consent_artifact - state - revision_create_time
+        #   for filtering are: - user_id. For example, `filter='user_id="user123"'`. -
+        #   consent_artifact - state - revision_create_time - metadata. For example, `
+        #   filter=Metadata(\"testkey\")=\"value\"` or `filter=HasMetadata(\"testkey\")`.
         # @param [Fixnum] page_size
-        #   Limit on the number of revisions to return in a single response. If not
-        #   specified, 100 is used. May not be larger than 1000.
+        #   Optional. Limit on the number of revisions to return in a single response. If
+        #   not specified, 100 is used. May not be larger than 1000.
         # @param [String] page_token
-        #   Token to retrieve the next page of results or empty if there are no more
-        #   results in the list.
+        #   Optional. Token to retrieve the next page of results or empty if there are no
+        #   more results in the list.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2178,17 +2192,17 @@ module Google
         
         # Updates the latest revision of the specified Consent by committing a new
         # revision with the changes. A FAILED_PRECONDITION error occurs if the latest
-        # revision of the given consent is in the `REJECTED` or `REVOKED` state.
+        # revision of the specified Consent is in the `REJECTED` or `REVOKED` state.
         # @param [String] name
         #   Resource name of the Consent, of the form `projects/`project_id`/locations/`
         #   location_id`/datasets/`dataset_id`/consentStores/`consent_store_id`/consents/`
-        #   consent_id``.
+        #   consent_id``. Cannot be changed after creation.
         # @param [Google::Apis::HealthcareV1beta1::Consent] consent_object
         # @param [String] update_mask
-        #   The update mask to apply to the resource. For the `FieldMask` definition, see
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
-        #   fieldmask. The `user_id`, `policies`, and `consent_artifact` fields can be
-        #   updated.
+        #   Required. The update mask to apply to the resource. For the `FieldMask`
+        #   definition, see https://developers.google.com/protocol-buffers/docs/reference/
+        #   google.protobuf#fieldmask. Only the `user_id`, `policies`, `consent_artifact`,
+        #   and `metadata` fields can be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2221,11 +2235,11 @@ module Google
         
         # Rejects the latest revision of the specified Consent by committing a new
         # revision with `state` updated to `REJECTED`. If the latest revision of the
-        # given consent is in the `REJECTED` state, no new revision is committed. A
-        # FAILED_PRECONDITION error occurs if the latest revision of the given consent
-        # is in the `ACTIVE` or `REVOKED` state.
+        # specified Consent is in the `REJECTED` state, no new revision is committed. A
+        # FAILED_PRECONDITION error occurs if the latest revision of the specified
+        # Consent is in the `ACTIVE` or `REVOKED` state.
         # @param [String] name
-        #   Required. The resource name of the consent to reject, of the form `projects/`
+        #   Required. The resource name of the Consent to reject, of the form `projects/`
         #   project_id`/locations/`location_id`/datasets/`dataset_id`/consentStores/`
         #   consent_store_id`/consents/`consent_id``. An INVALID_ARGUMENT error occurs if `
         #   revision_id` is specified in the name.
@@ -2261,11 +2275,11 @@ module Google
         
         # Revokes the latest revision of the specified Consent by committing a new
         # revision with `state` updated to `REVOKED`. If the latest revision of the
-        # given consent is in the `REVOKED` state, no new revision is committed. A
+        # specified Consent is in the `REVOKED` state, no new revision is committed. A
         # FAILED_PRECONDITION error occurs if the latest revision of the given consent
         # is in `DRAFT` or `REJECTED` state.
         # @param [String] name
-        #   Required. The resource name of the consent to revoke, of the form `projects/`
+        #   Required. The resource name of the Consent to revoke, of the form `projects/`
         #   project_id`/locations/`location_id`/datasets/`dataset_id`/consentStores/`
         #   consent_store_id`/consents/`consent_id``. An INVALID_ARGUMENT error occurs if `
         #   revision_id` is specified in the name.
@@ -2301,7 +2315,7 @@ module Google
         
         # Archives the specified User data mapping.
         # @param [String] name
-        #   The resource name of the user data mapping to archive.
+        #   Required. The resource name of the User data mapping to archive.
         # @param [Google::Apis::HealthcareV1beta1::ArchiveUserDataMappingRequest] archive_user_data_mapping_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -2332,7 +2346,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new User data mapping in the parent Consent store.
+        # Creates a new User data mapping in the parent consent store.
         # @param [String] parent
         #   Required. Name of the consent store.
         # @param [Google::Apis::HealthcareV1beta1::UserDataMapping] user_data_mapping_object
@@ -2367,7 +2381,7 @@ module Google
         
         # Deletes the specified User data mapping.
         # @param [String] name
-        #   Required. The resource name of the user data mapping to delete.
+        #   Required. The resource name of the User data mapping to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2397,7 +2411,7 @@ module Google
         
         # Gets the specified User data mapping.
         # @param [String] name
-        #   Required. The resource name of the user data mapping to retrieve.
+        #   Required. The resource name of the User data mapping to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2425,37 +2439,39 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the User data mappings in the given Consent store.
+        # Lists the User data mappings in the specified consent store.
         # @param [String] parent
-        #   Required. Name of the Consent store to retrieve user data mappings from.
+        #   Required. Name of the consent store to retrieve User data mappings from.
         # @param [String] filter
-        #   Restricts the user data mappings returned to those matching a filter. The
-        #   following syntax is available: * A string field value can be written as text
-        #   inside quotation marks, for example `"query text"`. The only valid relational
-        #   operation for text fields is equality (`=`), where text is searched within the
-        #   field, rather than having the field be equal to the text. For example, `"
-        #   Comment = great"` returns messages with `great` in the comment field. * A
-        #   number field value can be written as an integer, a decimal, or an exponential.
-        #   The valid relational operators for number fields are the equality operator (`=`
-        #   ), along with the less than/greater than operators (`<`, `<=`, `>`, `>=`).
-        #   Note that there is no inequality (`!=`) operator. You can prepend the `NOT`
-        #   operator to an expression to negate it. * A date field value must be written
-        #   in `yyyy-mm-dd` form. Fields with date and time use the RFC3339 time format.
-        #   Leading zeros are required for one-digit months and days. The valid relational
-        #   operators for date fields are the equality operator (`=`) , along with the
-        #   less than/greater than operators (`<`, `<=`, `>`, `>=`). Note that there is no
-        #   inequality (`!=`) operator. You can prepend the `NOT` operator to an
-        #   expression to negate it. * Multiple field query expressions can be combined in
-        #   one query by adding `AND` or `OR` operators between the expressions. If a
+        #   Optional. Restricts the user data mappings returned to those matching a filter.
+        #   The following syntax is available: * A string field value can be written as
+        #   text inside quotation marks, for example `"query text"`. The only valid
+        #   relational operation for text fields is equality (`=`), where text is searched
+        #   within the field, rather than having the field be equal to the text. For
+        #   example, `"Comment = great"` returns messages with `great` in the comment
+        #   field. * A number field value can be written as an integer, a decimal, or an
+        #   exponential. The valid relational operators for number fields are the equality
+        #   operator (`=`), along with the less than/greater than operators (`<`, `<=`, `>`
+        #   , `>=`). Note that there is no inequality (`!=`) operator. You can prepend the
+        #   `NOT` operator to an expression to negate it. * A date field value must be
+        #   written in `yyyy-mm-dd` form. Fields with date and time use the RFC3339 time
+        #   format. Leading zeros are required for one-digit months and days. The valid
+        #   relational operators for date fields are the equality operator (`=`) , along
+        #   with the less than/greater than operators (`<`, `<=`, `>`, `>=`). Note that
+        #   there is no inequality (`!=`) operator. You can prepend the `NOT` operator to
+        #   an expression to negate it. * Multiple field query expressions can be combined
+        #   in one query by adding `AND` or `OR` operators between the expressions. If a
         #   boolean operator appears within a quoted string, it is not treated as special,
         #   it's just another part of the character string to be matched. You can prepend
         #   the `NOT` operator to an expression to negate it. The fields available for
-        #   filtering are: - data_id - user_id - archived - archive_time
+        #   filtering are: - data_id - user_id. For example, `filter=user_id=\"user123\"`.
+        #   - archived - archive_time
         # @param [Fixnum] page_size
-        #   Limit on the number of user data mappings to return in a single response. If
-        #   not specified, 100 is used. May not be larger than 1000.
+        #   Optional. Limit on the number of User data mappings to return in a single
+        #   response. If not specified, 100 is used. May not be larger than 1000.
         # @param [String] page_token
-        #   Token to retrieve the next page of results or empty to get the first page.
+        #   Optional. Token to retrieve the next page of results, or empty to get the
+        #   first page.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2493,9 +2509,10 @@ module Google
         #   userDataMappings/`user_data_mapping_id``.
         # @param [Google::Apis::HealthcareV1beta1::UserDataMapping] user_data_mapping_object
         # @param [String] update_mask
-        #   The update mask that applies to the resource. For the `FieldMask` definition,
-        #   see https://developers.google.com/protocol-buffers/docs/reference/google.
-        #   protobuf#fieldmask.
+        #   Required. The update mask that applies to the resource. For the `FieldMask`
+        #   definition, see https://developers.google.com/protocol-buffers/docs/reference/
+        #   google.protobuf#fieldmask. Only the `data_id`, `user_id` and `
+        #   resource_attributes` fields can be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user