google-api-client 0.39.2 → 0.39.3

data/generated/google/apis/healthcare_v1.rb

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

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

@@ -1266,7 +1266,7 @@ 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.
@@ -1276,12 +1276,12 @@ module Google
         # 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)).
+        # logged to Cloud Logging (see [Viewing logs](/healthcare/docs/how-
+        # tos/logging)).
         # Corresponds to the JSON property `pubsubTopic`
         # @return [String]
         attr_accessor :pubsub_topic
@@ -1888,12 +1888,12 @@ module Google
         # Notifications are only sent if the topic is
         # non-empty. [Topic
         # names](https://cloud.google.com/pubsub/docs/overview#names) must be scoped
-        # to a project. cloud-healthcare@system.gserviceaccount.com must have
-        # publisher permissions on the given Cloud Pub/Sub topic. Not having adequate
+        # to a project. Cloud Healthcare API service account must have publisher
+        # permissions on the given Cloud Pub/Sub topic. Not having adequate
         # permissions causes the calls that send notifications to fail.
         # If a notification can't be published to Cloud Pub/Sub, errors are logged to
-        # Stackdriver (see [Viewing
-        # logs](/healthcare/docs/how-tos/stackdriver-logging)). If the number of
+        # Cloud Logging (see [Viewing
+        # logs](/healthcare/docs/how-tos/logging)). If the number of
         # errors exceeds a certain rate, some aren't submitted.
         # Corresponds to the JSON property `pubsubTopic`
         # @return [String]
@@ -2006,7 +2006,7 @@ module Google
       
         # A link to audit and error logs in the log viewer. Error logs are generated
         # only by some operations, listed at
-        # https://cloud.google.com/healthcare/docs/how-tos/stackdriver-logging.
+        # [Viewing logs](/healthcare/docs/how-tos/logging).
         # Corresponds to the JSON property `logsUrl`
         # @return [String]
         attr_accessor :logs_url
@@ -2106,10 +2106,13 @@ module Google
       # Google groups, and domains (such as G Suite). A `role` is a named list of
       # permissions; each `role` can be an IAM predefined role or a user-created
       # custom role.
-      # Optionally, a `binding` can specify a `condition`, which is a logical
-      # expression that allows access to a resource only if the expression evaluates
-      # to `true`. A condition can add constraints based on attributes of the
-      # request, the resource, or both.
+      # For some types of Google Cloud resources, a `binding` can also specify a
+      # `condition`, which is a logical expression that allows access to a resource
+      # only if the expression evaluates to `true`. A condition can add constraints
+      # based on attributes of the request, the resource, or both. To learn which
+      # resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # policies).
       # **JSON example:**
       # `
       # "bindings": [
@@ -2124,7 +2127,9 @@ module Google
       # `,
       # `
       # "role": "roles/resourcemanager.organizationViewer",
-      # "members": ["user:eve@example.com"],
+      # "members": [
+      # "user:eve@example.com"
+      # ],
       # "condition": `
       # "title": "expirable access",
       # "description": "Does not grant access after Sep 2020",
@@ -2202,6 +2207,9 @@ module Google
         # the conditions in the version `3` policy are lost.
         # If a policy does not include any conditions, operations on that policy may
         # specify any valid version or leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -2409,10 +2417,13 @@ module Google
         # Google groups, and domains (such as G Suite). A `role` is a named list of
         # permissions; each `role` can be an IAM predefined role or a user-created
         # custom role.
-        # Optionally, a `binding` can specify a `condition`, which is a logical
-        # expression that allows access to a resource only if the expression evaluates
-        # to `true`. A condition can add constraints based on attributes of the
-        # request, the resource, or both.
+        # For some types of Google Cloud resources, a `binding` can also specify a
+        # `condition`, which is a logical expression that allows access to a resource
+        # only if the expression evaluates to `true`. A condition can add constraints
+        # based on attributes of the request, the resource, or both. To learn which
+        # resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # **JSON example:**
         # `
         # "bindings": [
@@ -2427,7 +2438,9 @@ module Google
         # `,
         # `
         # "role": "roles/resourcemanager.organizationViewer",
-        # "members": ["user:eve@example.com"],
+        # "members": [
+        # "user:eve@example.com"
+        # ],
         # "condition": `
         # "title": "expirable access",
         # "description": "Does not grant access after Sep 2020",
@@ -2465,8 +2478,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

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

@@ -102,8 +102,8 @@ module Google
         # DICOM instances. The new de-identified dataset will not contain these
         # failed resources. Failed resource totals are tracked in
         # Operation.metadata.
-        # Error details are also logged to Stackdriver Logging. For more information,
-        # see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging).
+        # Error details are also logged to Cloud Logging. For more information,
+        # see [Viewing logs](/healthcare/docs/how-tos/logging).
         # @param [String] source_dataset
         #   Source dataset resource name. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id``.
@@ -214,6 +214,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -322,7 +325,7 @@ module Google
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
-        # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -358,7 +361,7 @@ module Google
         
         # Returns permissions that a caller has on the specified resource.
         # If the resource does not exist, this will return an empty set of
-        # permissions, not a NOT_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # Note: This operation is designed to be used for building permission-aware
         # UIs and command-line tools, not for authorization checking. This operation
         # may "fail open" without warning.
@@ -443,8 +446,8 @@ module Google
         # DICOM instances. The output DICOM store will not contain
         # these failed resources. Failed resource totals are tracked in
         # Operation.metadata.
-        # Error details are also logged to Stackdriver
-        # (see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging)).
+        # Error details are also logged to Cloud Logging
+        # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
         # @param [String] source_store
         #   Source DICOM store resource name. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -512,8 +515,8 @@ module Google
         
         # Exports data to the specified destination by copying it from the DICOM
         # store.
-        # Errors are also logged to Stackdriver Logging. For more information,
-        # see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging).
+        # Errors are also logged to Cloud Logging. For more information,
+        # see [Viewing logs](/healthcare/docs/how-tos/logging).
         # The metadata field type is
         # OperationMetadata.
         # @param [String] name
@@ -594,6 +597,9 @@ module Google
         #   Requests for policies with any conditional bindings must specify version 3.
         #   Policies without any conditional bindings may specify any valid value or
         #   leave the field unset.
+        #   To learn which resources support conditions in their IAM policies, see the
+        #   [IAM
+        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -623,8 +629,8 @@ module Google
         end
         
         # Imports data into the DICOM store by copying it from the specified source.
-        # Errors are logged to Stackdriver Logging. For more information, see
-        # [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging). The
+        # Errors are logged to Cloud Logging. For more information, see
+        # [Viewing logs](/healthcare/docs/how-tos/logging). The
         # metadata field type is
         # OperationMetadata.
         # @param [String] name
@@ -858,7 +864,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.
@@ -935,7 +941,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.
@@ -1627,8 +1633,8 @@ module Google
         # response field type is
         # DeidentifyFhirStoreSummary. If errors occur,
         # error is set.
-        # Error details are also logged to Stackdriver
-        # (see [Viewing logs](/healthcare/docs/how-tos/stackdriver-logging)).
+        # Error details are also logged to Cloud Logging
+        # (see [Viewing logs](/healthcare/docs/how-tos/logging)).
         # @param [String] source_store
         #   Source FHIR store resource name. For example,
         #   `projects/`project_id`/locations/`location_id`/datasets/`dataset_id`/
@@ -1699,8 +1705,8 @@ 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.
@@ -1784,6 +1790,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
@@ -1831,7 +1840,7 @@ module Google
         # if the input data contains invalid references or if some resources fail to
         # be imported, the FHIR store might be left in a state that violates
         # referential integrity.
-        # The import process does not trigger PubSub notification or BigQuery
+        # The import process does not trigger Pub/Sub notification or BigQuery
         # streaming update, regardless of how those are configured on the FHIR store.
         # If a resource with the specified ID already exists, the most recent
         # version of the resource is overwritten without creating a new historical
@@ -1870,8 +1879,8 @@ 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
@@ -1993,95 +2002,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches for resources in the given FHIR store according to criteria
-        # specified as query parameters.
-        # Implements the FHIR standard search interaction
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/http.html#search),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/http.html#search),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/http.html#search))
-        # using the search semantics described in the FHIR Search specification
-        # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/search.html),
-        # [STU3](http://hl7.org/implement/standards/fhir/STU3/search.html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/search.html)).
-        # Supports three methods of search defined by the specification:
-        # *  `GET [base]?[parameters]` to search across all resources.
-        # *  `GET [base]/[type]?[parameters]` to search resources of a specified
-        # type.
-        # *  `POST [base]/[type]/_search?[parameters]` as an alternate form having
-        # the same semantics as the `GET` method.
-        # The `GET` methods do not support compartment searches. The `POST` method
-        # does not support `application/x-www-form-urlencoded` search parameters.
-        # On success, the response body will contain a JSON-encoded representation
-        # of a `Bundle` resource of type `searchset`, containing the results of the
-        # search.
-        # Errors generated by the FHIR store will contain a JSON-encoded
-        # `OperationOutcome` resource describing the reason for the error. If the
-        # request cannot be mapped to a valid API method on a FHIR store, a generic
-        # GCP error might be returned instead.
-        # The server's capability statement, retrieved through
-        # capabilities, indicates what search parameters
-        # are supported on each FHIR resource. A list of all search parameters
-        # defined by the specification can be found in the FHIR Search Parameter
-        # Registry
-        # ([STU3](http://hl7.org/implement/standards/fhir/STU3/searchparameter-registry.
-        # html),
-        # [R4](http://hl7.org/implement/standards/fhir/R4/searchparameter-registry.html))
-        # .
-        # FHIR search parameters for DSTU2 can be found on each resource's definition
-        # page.
-        # Supported search modifiers: `:missing`, `:exact`, `:contains`, `:text`,
-        # `:in`, `:not-in`, `:above`, `:below`, `:[type]`, `:not`, and `:recurse`.
-        # Supported search result parameters: `_sort`, `_count`, `_include`,
-        # `_revinclude`, `_summary=text`, `_summary=data`, and `_elements`.
-        # The maximum number of search results returned defaults to 100, which can
-        # be overridden by the `_count` parameter up to a maximum limit of 1000. If
-        # there are additional results, the returned `Bundle` will contain
-        # pagination links.
-        # Resources with a total size larger than 5MB or a field count larger than
-        # 50,000 might not be fully searchable as the server might trim its generated
-        # search index in those cases.
-        # Note: FHIR resources are indexed asynchronously, so there might be a slight
-        # delay between the time a resource is created or changes and when the change
-        # is reflected in search results.
-        # @param [String] parent
-        #   Name of the FHIR store to retrieve resources from.
-        # @param [String] resource_type
-        #   The FHIR resource type to search, such as Patient or Observation. For a
-        #   complete list, see the FHIR Resource Index
-        #   ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/resourcelist.html),
-        #   [STU3](http://hl7.org/implement/standards/fhir/STU3/resourcelist.html),
-        #   [R4](http://hl7.org/implement/standards/fhir/R4/resourcelist.html)).
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::HealthcareV1::HttpBody] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::HealthcareV1::HttpBody]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def search_project_location_dataset_fhir_stores(parent, resource_type: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1/{+parent}/fhir', options)
-          command.response_representation = Google::Apis::HealthcareV1::HttpBody::Representation
-          command.response_class = Google::Apis::HealthcareV1::HttpBody
-          command.params['parent'] = parent unless parent.nil?
-          command.query['resourceType'] = resource_type unless resource_type.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
-        # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -2117,7 +2040,7 @@ module Google
         
         # Returns permissions that a caller has on the specified resource.
         # If the resource does not exist, this will return an empty set of
-        # permissions, not a NOT_FOUND error.
+        # permissions, not a `NOT_FOUND` error.
         # Note: This operation is designed to be used for building permission-aware
         # UIs and command-line tools, not for authorization checking. This operation
         # may "fail open" without warning.
@@ -2154,8 +2077,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves all the resources directly referenced by a patient, as well as
-        # all of the resources in the patient compartment.
+        # Retrieves a Patient resource and resources related to that patient.
         # Implements the FHIR extended operation Patient-everything
         # ([DSTU2](http://hl7.org/implement/standards/fhir/DSTU2/patient-operations.html#
         # everything),
@@ -2170,6 +2092,16 @@ module Google
         # `OperationOutcome` resource describing the reason for the error. If the
         # request cannot be mapped to a valid API method on a FHIR store, a generic
         # GCP error might be returned instead.
+        # The resources in scope for the response are:
+        # * The patient resource itself.
+        # * All the resources directly referenced by the patient resource.
+        # * Resources directly referencing the patient resource that meet the
+        # inclusion criteria. The inclusion criteria are based on the membership
+        # rules in the patient compartment definition
+        # ([DSTU2](http://hl7.org/fhir/DSTU2/compartment-patient.html),
+        # [STU3](http://www.hl7.org/fhir/stu3/compartmentdefinition-patient.html),
+        # [R4](http://hl7.org/fhir/R4/compartmentdefinition-patient.html)), which
+        # details the eligible resource types and referencing search parameters.
         # @param [String] name
         #   Name of the `Patient` resource for which the information is required.
         # @param [Fixnum] _count
@@ -2896,6 +2828,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
@@ -3008,7 +2943,7 @@ module Google
         
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
-        # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED
+        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified.
         #   See the operation documentation for the appropriate value for this field.
@@ -3044,7 +2979,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.

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 = '20200501'
 
       # 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

@@ -1658,7 +1658,7 @@ 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.
@@ -1668,12 +1668,12 @@ module Google
         # 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)).
+        # logged to Cloud Logging (see [Viewing logs](/healthcare/docs/how-
+        # tos/logging)).
         # Corresponds to the JSON property `pubsubTopic`
         # @return [String]
         attr_accessor :pubsub_topic
@@ -2371,12 +2371,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 +2489,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 +2596,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 +2617,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 +2697,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
@@ -3050,10 +3058,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 +3079,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 +3119,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