google-api-client 0.39.0 → 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/homegraph_v1/classes.rb

@@ -476,6 +476,9 @@ module Google
         attr_accessor :event_id
       
         # Token to maintain state in the follow up notification response.
+        # Deprecated. See the [notifications
+        # guide](https://developers.google.com/assistant/smarthome/develop/notifications)
+        # for details on implementing follow up notifications.
         # Corresponds to the JSON property `followUpToken`
         # @return [String]
         attr_accessor :follow_up_token

data/generated/google/apis/homegraph_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/actions/smarthome/create-app#request-sync
     module HomegraphV1
       VERSION = 'V1'
-      REVISION = '20200415'
+      REVISION = '20200522'
     end
   end
 end

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

@@ -886,10 +886,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": [
@@ -904,7 +907,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",
@@ -982,6 +987,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
@@ -1454,10 +1462,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": [
@@ -1472,7 +1483,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",
@@ -1510,8 +1523,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/iam_v1/service.rb

@@ -899,6 +899,10 @@ module Google
         # Disabling a service account that is bound to VMs, Apps, Functions, or
         # other jobs will cause those jobs to lose access to resources if they are
         # using the disabled service account.
+        # Previously issued Access tokens for a service account will be rejected
+        # while the service account is disabled but will start working again if the
+        # account is re-enabled. Issuance of new tokens will fail while the account
+        # is disabled.
         # To improve reliability of your services and avoid unexpected outages, it
         # is recommended to first disable a service account rather than delete it.
         # After disabling the service account, wait at least 24 hours to verify there
@@ -1041,6 +1045,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

data/generated/google/apis/iam_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/iam/
     module IamV1
       VERSION = 'V1'
-      REVISION = '20200221'
+      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/iamcredentials_v1/classes.rb

@@ -194,12 +194,24 @@ module Google
       class SignBlobResponse
         include Google::Apis::Core::Hashable
       
-        # The ID of the key used to sign the blob.
+        # The ID of the key used to sign the blob. The key used for signing will
+        # remain valid for at least 12 hours after the blob is signed. To verify the
+        # signature, you can retrieve the public key in several formats from the
+        # following endpoints:
+        # - RSA public key wrapped in an X.509 v3 certificate:
+        # `https://www.googleapis.com/service_accounts/v1/metadata/x509/`ACCOUNT_EMAIL``
+        # - Raw key in JSON format:
+        # `https://www.googleapis.com/service_accounts/v1/metadata/raw/`ACCOUNT_EMAIL``
+        # - JSON Web Key (JWK):
+        # `https://www.googleapis.com/service_accounts/v1/metadata/jwk/`ACCOUNT_EMAIL``
         # Corresponds to the JSON property `keyId`
         # @return [String]
         attr_accessor :key_id
       
         # The signature for the blob. Does not include the original blob.
+        # After the key pair referenced by the `key_id` response field expires,
+        # Google no longer exposes the public key that can be used to verify the
+        # blob. As a result, the receiver can no longer verify the signature.
         # Corresponds to the JSON property `signedBlob`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -257,7 +269,16 @@ module Google
       class SignJwtResponse
         include Google::Apis::Core::Hashable
       
-        # The ID of the key used to sign the JWT.
+        # The ID of the key used to sign the JWT. The key used for signing will
+        # remain valid for at least 12 hours after the JWT is signed. To verify the
+        # signature, you can retrieve the public key in several formats from the
+        # following endpoints:
+        # - RSA public key wrapped in an X.509 v3 certificate:
+        # `https://www.googleapis.com/service_accounts/v1/metadata/x509/`ACCOUNT_EMAIL``
+        # - Raw key in JSON format:
+        # `https://www.googleapis.com/service_accounts/v1/metadata/raw/`ACCOUNT_EMAIL``
+        # - JSON Web Key (JWK):
+        # `https://www.googleapis.com/service_accounts/v1/metadata/jwk/`ACCOUNT_EMAIL``
         # Corresponds to the JSON property `keyId`
         # @return [String]
         attr_accessor :key_id
@@ -265,6 +286,9 @@ module Google
         # The signed JWT. Contains the automatically generated header; the
         # client-supplied payload; and the signature, which is generated using the
         # key referenced by the `kid` field in the header.
+        # After the key pair referenced by the `key_id` response field expires,
+        # Google no longer exposes the public key that can be used to verify the JWT.
+        # As a result, the receiver can no longer verify the signature.
         # Corresponds to the JSON property `signedJwt`
         # @return [String]
         attr_accessor :signed_jwt

data/generated/google/apis/iamcredentials_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/iam/docs/creating-short-lived-service-account-credentials
     module IamcredentialsV1
       VERSION = 'V1'
-      REVISION = '20200417'
+      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/iap_v1/classes.rb

@@ -99,6 +99,12 @@ module Google
         # @return [Google::Apis::IapV1::AccessDeniedPageSettings]
         attr_accessor :access_denied_page_settings
       
+        # The Domain value to set for cookies generated by IAP. This value is not
+        # validated by the API, but will be ignored at runtime if invalid.
+        # Corresponds to the JSON property `cookieDomain`
+        # @return [String]
+        attr_accessor :cookie_domain
+      
         # Configuration for RCTokens generated for CSM workloads protected by IAP.
         # RCTokens are IAP generated JWTs that can be verified at the application. The
         # RCToken is primarily used for ISTIO deployments, and can be scoped to a
@@ -114,6 +120,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @access_denied_page_settings = args[:access_denied_page_settings] if args.key?(:access_denied_page_settings)
+          @cookie_domain = args[:cookie_domain] if args.key?(:cookie_domain)
           @csm_settings = args[:csm_settings] if args.key?(:csm_settings)
         end
       end
@@ -219,7 +226,7 @@ module Google
         attr_accessor :name
       
         # Output only. Whether the brand is only intended for usage inside the
-        # GSuite organization only.
+        # G Suite organization only.
         # Corresponds to the JSON property `orgInternalOnly`
         # @return [Boolean]
         attr_accessor :org_internal_only
@@ -431,6 +438,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).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -596,10 +606,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": [
@@ -614,7 +627,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",
@@ -687,6 +702,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
@@ -761,7 +779,7 @@ module Google
         # The location of the Policy.
         # Must be empty or "global" for Policies owned by global IAM.  Must name a
         # region from prodspec/cloud-iam-cloudspec for Regional IAM Policies, see
-        # http://go/iam-faq#where-is-iam-currently-deployed.
+        # go/iam-faq#where-is-iam-currently-deployed.
         # For Local IAM:
         # This field should be set to "local".
         # Corresponds to the JSON property `region`
@@ -876,10 +894,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": [
@@ -894,7 +915,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",

data/generated/google/apis/iap_v1/representations.rb

@@ -198,6 +198,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :access_denied_page_settings, as: 'accessDeniedPageSettings', class: Google::Apis::IapV1::AccessDeniedPageSettings, decorator: Google::Apis::IapV1::AccessDeniedPageSettings::Representation
       
+          property :cookie_domain, as: 'cookieDomain'
           property :csm_settings, as: 'csmSettings', class: Google::Apis::IapV1::CsmSettings, decorator: Google::Apis::IapV1::CsmSettings::Representation
       
         end

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

@@ -156,7 +156,7 @@ module Google
         #   Required. Path to create the client in.
         #   In the following format:
         #   projects/`project_number/id`/brands/`brand`.
-        #   The project must belong to a GSuite account.
+        #   The project must belong to a G Suite account.
         # @param [Google::Apis::IapV1::IdentityAwareProxyClient] identity_aware_proxy_client_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/iap_v1.rb

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

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

@@ -197,6 +197,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).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -218,10 +221,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": [
@@ -236,7 +242,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",
@@ -309,6 +317,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
@@ -336,10 +347,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": [
@@ -354,7 +368,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",

data/generated/google/apis/iap_v1beta1.rb

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

data/generated/google/apis/jobs_v3.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/talent-solution/job-search/docs/
     module JobsV3
       VERSION = 'V3'
-      REVISION = '20200219'
+      REVISION = '20200506'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/jobs_v3p1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/talent-solution/job-search/docs/
     module JobsV3p1beta1
       VERSION = 'V3p1beta1'
-      REVISION = '20200219'
+      REVISION = '20200506'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -26,11 +26,12 @@ module Google
       class BigQueryOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. Whether to use BigQuery's partition tables. By default, Logging
-        # creates dated tables based on the log entries' timestamps, e.g.
-        # syslog_20170523. With partitioned tables the date suffix is no longer present
-        # and special query syntax has to be used instead. In both cases, tables are
-        # sharded based on UTC timezone.
+        # Optional. Whether to use BigQuery's partition tables (https://cloud.google.com/
+        # bigquery/docs/partitioned-tables). By default, Logging creates dated tables
+        # based on the log entries' timestamps, e.g. syslog_20170523. With partitioned
+        # tables the date suffix is no longer present and special query syntax (https://
+        # cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used
+        # instead. In both cases, tables are sharded based on UTC timezone.
         # Corresponds to the JSON property `usePartitionedTables`
         # @return [Boolean]
         attr_accessor :use_partitioned_tables
@@ -119,7 +120,8 @@ module Google
       # a project, folder, organization, billing account, or flexible resource.Note:
       # CMEK for the Logs Router can currently only be configured for GCP
       # organizations. Once configured, it applies to all projects and folders in the
-      # GCP organization.See Enabling CMEK for Logs Router for more information.
+      # GCP organization.See Enabling CMEK for Logs Router (https://cloud.google.com/
+      # logging/docs/routing/managed-encryption) for more information.
       class CmekSettings
         include Google::Apis::Core::Hashable
       
@@ -135,7 +137,8 @@ module Google
         # operations will be completed using the key that was used at the time of
         # encryption unless access to that key has been revoked.To disable CMEK for the
         # Logs Router, set this field to an empty string.See Enabling CMEK for Logs
-        # Router for more information.
+        # Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for
+        # more information.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
@@ -150,7 +153,8 @@ module Google
         # assign the role roles/cloudkms.cryptoKeyEncrypterDecrypter to the service
         # account that the Logs Router will use to access your Cloud KMS key. Use
         # GetCmekSettings to obtain the service account ID.See Enabling CMEK for Logs
-        # Router for more information.
+        # Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for
+        # more information.
         # Corresponds to the JSON property `serviceAccountId`
         # @return [String]
         attr_accessor :service_account_id
@@ -491,10 +495,11 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. A filter that chooses which log entries to return. See Advanced Logs
-        # Queries. Only log entries that match the filter are returned. An empty filter
-        # matches all log entries in the resources listed in resource_names. Referencing
-        # a parent resource that is not listed in resource_names will cause the filter
-        # to return no results. The maximum length of the filter is 20000 characters.
+        # Queries (https://cloud.google.com/logging/docs/view/advanced-queries). Only
+        # log entries that match the filter are returned. An empty filter matches all
+        # log entries in the resources listed in resource_names. Referencing a parent
+        # resource that is not listed in resource_names will cause the filter to return
+        # no results. The maximum length of the filter is 20000 characters.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -887,9 +892,10 @@ module Google
         # If this field is omitted in a new log entry, then Logging assigns it the
         # current time. Timestamps have nanosecond accuracy, but trailing zeros in the
         # fractional seconds might be omitted when the timestamp is displayed.Incoming
-        # log entries must have timestamps that don't exceed the logs retention period
-        # in the past, and that don't exceed 24 hours in the future. Log entries outside
-        # those time boundaries aren't ingested by Logging.
+        # log entries must have timestamps that don't exceed the logs retention period (
+        # https://cloud.google.com/logging/quotas#logs_retention_periods) in the past,
+        # and that don't exceed 24 hours in the future. Log entries outside those time
+        # boundaries aren't ingested by Logging.
         # Corresponds to the JSON property `timestamp`
         # @return [String]
         attr_accessor :timestamp
@@ -1048,11 +1054,13 @@ module Google
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # Required. An advanced logs filter that matches the log entries to be excluded.
-        # By using the sample function, you can exclude less than 100% of the matching
-        # log entries. For example, the following query matches 99% of low-severity log
-        # entries from Google Cloud Storage buckets:"resource.type=gcs_bucket severity<
-        # ERROR sample(insertId, 0.99)"
+        # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/
+        # advanced-queries) that matches the log entries to be excluded. By using the
+        # sample function (https://cloud.google.com/logging/docs/view/advanced-queries#
+        # sample), you can exclude less than 100% of the matching log entries. For
+        # example, the following query matches 99% of low-severity log entries from
+        # Google Cloud Storage buckets:"resource.type=gcs_bucket severity<ERROR sample(
+        # insertId, 0.99)"
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -1160,7 +1168,8 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Required. An advanced logs filter which is used to match log entries. Example:
+        # Required. An advanced logs filter (https://cloud.google.com/logging/docs/view/
+        # advanced_filters) which is used to match log entries. Example:
         # "resource.type=gae_app AND severity>=ERROR"
         # The maximum length of the filter is 20000 characters.
         # Corresponds to the JSON property `filter`
@@ -1280,7 +1289,8 @@ module Google
         # "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
         # The sink's writer_identity, set when the sink is created, must have permission
         # to write to the destination or else the log entries are not exported. For more
-        # information, see Exporting Logs with Sinks.
+        # information, see Exporting Logs with Sinks (https://cloud.google.com/logging/
+        # docs/api/tasks/exporting-logs).
         # Corresponds to the JSON property `destination`
         # @return [String]
         attr_accessor :destination
@@ -1292,9 +1302,9 @@ module Google
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # Optional. An advanced logs filter. The only exported log entries are those
-        # that are in the resource owning the sink and that match the filter. For
-        # example:
+        # Optional. An advanced logs filter (https://cloud.google.com/logging/docs/view/
+        # advanced-queries). The only exported log entries are those that are in the
+        # resource owning the sink and that match the filter. For example:
         # logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
         # Corresponds to the JSON property `filter`
         # @return [String]
@@ -1326,8 +1336,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Deprecated. The log entry format to use for this sink's exported log entries.
-        # The v2 format is used by default and cannot be changed.
+        # Deprecated. This field is unused.
         # Corresponds to the JSON property `outputVersionFormat`
         # @return [String]
         attr_accessor :output_version_format
@@ -1343,7 +1352,9 @@ module Google
         # field is set by sinks.create and sinks.update based on the value of
         # unique_writer_identity in those methods.Until you grant this identity write-
         # access to the destination, log entry exports from this sink will fail. For
-        # more information, see Granting Access for a Resource. Consult the destination
+        # more information, see Granting Access for a Resource (https://cloud.google.com/
+        # iam/docs/granting-roles-to-service-accounts#
+        # granting_access_to_a_service_account_for_a_resource). Consult the destination
         # service's documentation to determine the appropriate IAM roles to assign to
         # the identity.
         # Corresponds to the JSON property `writerIdentity`
@@ -2035,10 +2046,12 @@ module Google
         # respectively. The supplied values are chosen so that, among the log entries
         # that did not supply their own values, the entries earlier in the list will
         # sort before the entries later in the list. See the entries.list method.Log
-        # entries with timestamps that are more than the logs retention period in the
-        # past or more than 24 hours in the future will not be available when calling
-        # entries.list. However, those log entries can still be exported with LogSinks.
-        # To improve throughput and to avoid exceeding the quota limit for calls to
+        # entries with timestamps that are more than the logs retention period (https://
+        # cloud.google.com/logging/quota-policy) in the past or more than 24 hours in
+        # the future will not be available when calling entries.list. However, those log
+        # entries can still be exported with LogSinks (https://cloud.google.com/logging/
+        # docs/api/tasks/exporting-logs).To improve throughput and to avoid exceeding
+        # the quota limit (https://cloud.google.com/logging/quota-policy) for calls to
         # entries.write, you should try to include several log entries in this list,
         # rather than calling this method for each individual log entry.
         # Corresponds to the JSON property `entries`