google-api-client 0.41.1 → 0.41.2

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

@@ -0,0 +1,236 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module GmailpostmastertoolsV1beta1
+      # Gmail Postmaster Tools API
+      #
+      # The Gmail Postmaster API is a RESTful API that provides programmatic access to
+      #  email traffic metrics (like spam reports, delivery errors etc) otherwise
+      #  available through the Gmail Postmaster Tools UI currently.
+      #
+      # @example
+      #    require 'google/apis/gmailpostmastertools_v1beta1'
+      #
+      #    Gmailpostmastertools = Google::Apis::GmailpostmastertoolsV1beta1 # Alias the module
+      #    service = Gmailpostmastertools::PostmasterToolsService.new
+      #
+      # @see https://developers.google.com/gmail/postmaster
+      class PostmasterToolsService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  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.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://gmailpostmastertools.googleapis.com/', '')
+          @batch_path = 'batch'
+        end
+        
+        # Gets a specific domain registered by the client.
+        # Returns NOT_FOUND if the domain does not exist.
+        # @param [String] name
+        #   The resource name of the domain. It should have the form
+        #   `domains/`domain_name``, where domain_name is the fully qualified
+        #   domain name.
+        # @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::GmailpostmastertoolsV1beta1::Domain] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailpostmastertoolsV1beta1::Domain]
+        #
+        # @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 get_domain(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+name}', options)
+          command.response_representation = Google::Apis::GmailpostmastertoolsV1beta1::Domain::Representation
+          command.response_class = Google::Apis::GmailpostmastertoolsV1beta1::Domain
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists the domains that have been registered by the client. The order of
+        # domains in the response is unspecified and non-deterministic. Newly created
+        # domains will not necessarily be added to the end of this list.
+        # @param [Fixnum] page_size
+        #   Requested page size. Server may return fewer domains than requested.
+        #   If unspecified, server will pick an appropriate default.
+        # @param [String] page_token
+        #   The next_page_token value returned from a previous List request, if any.
+        #   This is the value of
+        #   ListDomainsResponse.next_page_token
+        #   returned from the previous call to `ListDomains` method.
+        # @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::GmailpostmastertoolsV1beta1::ListDomainsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailpostmastertoolsV1beta1::ListDomainsResponse]
+        #
+        # @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 list_domains(page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/domains', options)
+          command.response_representation = Google::Apis::GmailpostmastertoolsV1beta1::ListDomainsResponse::Representation
+          command.response_class = Google::Apis::GmailpostmastertoolsV1beta1::ListDomainsResponse
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Get traffic statistics for a domain on a specific date.
+        # Returns PERMISSION_DENIED if user does not have permission to access
+        # TrafficStats for the domain.
+        # @param [String] name
+        #   The resource name of the traffic statistics to get.
+        #   E.g., domains/mymail.mydomain.com/trafficStats/20160807.
+        # @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::GmailpostmastertoolsV1beta1::TrafficStats] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailpostmastertoolsV1beta1::TrafficStats]
+        #
+        # @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 get_domain_traffic_stat(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+name}', options)
+          command.response_representation = Google::Apis::GmailpostmastertoolsV1beta1::TrafficStats::Representation
+          command.response_class = Google::Apis::GmailpostmastertoolsV1beta1::TrafficStats
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # List traffic statistics for all available days.
+        # Returns PERMISSION_DENIED if user does not have permission to access
+        # TrafficStats for the domain.
+        # @param [String] parent
+        #   The resource name of the domain whose traffic statistics we'd like to list.
+        #   It should have the form `domains/`domain_name``, where domain_name is
+        #   the fully qualified domain name.
+        # @param [Fixnum] end_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month, or 0
+        #   if specifying a year by itself or a year and month where the day is not
+        #   significant.
+        # @param [Fixnum] end_date_month
+        #   Month of year. Must be from 1 to 12, or 0 if specifying a year without a
+        #   month and day.
+        # @param [Fixnum] end_date_year
+        #   Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+        #   a year.
+        # @param [Fixnum] page_size
+        #   Requested page size. Server may return fewer TrafficStats than
+        #   requested. If unspecified, server will pick an appropriate default.
+        # @param [String] page_token
+        #   The next_page_token value returned from a previous List request, if any.
+        #   This is the value of
+        #   ListTrafficStatsResponse.next_page_token
+        #   returned from the previous call to `ListTrafficStats` method.
+        # @param [Fixnum] start_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month, or 0
+        #   if specifying a year by itself or a year and month where the day is not
+        #   significant.
+        # @param [Fixnum] start_date_month
+        #   Month of year. Must be from 1 to 12, or 0 if specifying a year without a
+        #   month and day.
+        # @param [Fixnum] start_date_year
+        #   Year of date. Must be from 1 to 9999, or 0 if specifying a date without
+        #   a year.
+        # @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::GmailpostmastertoolsV1beta1::ListTrafficStatsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::GmailpostmastertoolsV1beta1::ListTrafficStatsResponse]
+        #
+        # @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 list_domain_traffic_stats(parent, end_date_day: nil, end_date_month: nil, end_date_year: nil, page_size: nil, page_token: nil, start_date_day: nil, start_date_month: nil, start_date_year: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta1/{+parent}/trafficStats', options)
+          command.response_representation = Google::Apis::GmailpostmastertoolsV1beta1::ListTrafficStatsResponse::Representation
+          command.response_class = Google::Apis::GmailpostmastertoolsV1beta1::ListTrafficStatsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['endDate.day'] = end_date_day unless end_date_day.nil?
+          command.query['endDate.month'] = end_date_month unless end_date_month.nil?
+          command.query['endDate.year'] = end_date_year unless end_date_year.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['startDate.day'] = start_date_day unless start_date_day.nil?
+          command.query['startDate.month'] = start_date_month unless start_date_month.nil?
+          command.query['startDate.year'] = start_date_year unless start_date_year.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/managedidentities_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/managed-microsoft-ad/
     module ManagedidentitiesV1
       VERSION = 'V1'
-      REVISION = '20200415'
+      REVISION = '20200622'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -542,6 +542,12 @@ module Google
         # @return [Hash<String,Google::Apis::ManagedidentitiesV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule>]
         attr_accessor :maintenance_schedules
       
+        # Maintenance settings associated with instance. Allows service producers and
+        # end users to assign settings that controls maintenance on this instance.
+        # Corresponds to the JSON property `maintenanceSettings`
+        # @return [Google::Apis::ManagedidentitiesV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings]
+        attr_accessor :maintenance_settings
+      
         # Unique name of the resource. It uses the form:
         # `projects/`project_id`/locations/`location_id`/instances/`instance_id``
         # Corresponds to the JSON property `name`
@@ -609,6 +615,7 @@ module Google
           @labels = args[:labels] if args.key?(:labels)
           @maintenance_policy_names = args[:maintenance_policy_names] if args.key?(:maintenance_policy_names)
           @maintenance_schedules = args[:maintenance_schedules] if args.key?(:maintenance_schedules)
+          @maintenance_settings = args[:maintenance_settings] if args.key?(:maintenance_settings)
           @name = args[:name] if args.key?(:name)
           @producer_metadata = args[:producer_metadata] if args.key?(:producer_metadata)
           @provisioned_resources = args[:provisioned_resources] if args.key?(:provisioned_resources)
@@ -664,6 +671,30 @@ module Google
         end
       end
       
+      # Maintenance settings associated with instance. Allows service producers and
+      # end users to assign settings that controls maintenance on this instance.
+      class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Exclude instance from maintenance. When true, rollout service will
+        # not
+        # attempt maintenance on the instance. Rollout service will include the
+        # instance in reported rollout progress as not attempted.
+        # Corresponds to the JSON property `exclude`
+        # @return [Boolean]
+        attr_accessor :exclude
+        alias_method :exclude?, :exclude
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @exclude = args[:exclude] if args.key?(:exclude)
+        end
+      end
+      
       # Node information for custom per-node SLO implementations.
       # SSA does not support per-node SLO, but producers can populate per-node
       # information in SloMetadata for custom precomputations.
@@ -1128,10 +1159,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": [
@@ -1146,7 +1180,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",
@@ -1219,6 +1255,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
@@ -1310,10 +1349,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": [
@@ -1328,7 +1370,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/managedidentities_v1/representations.rb

@@ -94,6 +94,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -332,6 +338,8 @@ module Google
           hash :maintenance_policy_names, as: 'maintenancePolicyNames'
           hash :maintenance_schedules, as: 'maintenanceSchedules', class: Google::Apis::ManagedidentitiesV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule, decorator: Google::Apis::ManagedidentitiesV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule::Representation
       
+          property :maintenance_settings, as: 'maintenanceSettings', class: Google::Apis::ManagedidentitiesV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings, decorator: Google::Apis::ManagedidentitiesV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings::Representation
+      
           property :name, as: 'name'
           hash :producer_metadata, as: 'producerMetadata'
           collection :provisioned_resources, as: 'provisionedResources', class: Google::Apis::ManagedidentitiesV1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource, decorator: Google::Apis::ManagedidentitiesV1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource::Representation
@@ -356,6 +364,13 @@ module Google
         end
       end
       
+      class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :exclude, as: 'exclude'
+        end
+      end
+      
       class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -311,6 +311,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/managedidentities_v1alpha1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/managed-microsoft-ad/
     module ManagedidentitiesV1alpha1
       VERSION = 'V1alpha1'
-      REVISION = '20200415'
+      REVISION = '20200622'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -550,6 +550,12 @@ module Google
         # @return [Hash<String,Google::Apis::ManagedidentitiesV1alpha1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule>]
         attr_accessor :maintenance_schedules
       
+        # Maintenance settings associated with instance. Allows service producers and
+        # end users to assign settings that controls maintenance on this instance.
+        # Corresponds to the JSON property `maintenanceSettings`
+        # @return [Google::Apis::ManagedidentitiesV1alpha1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings]
+        attr_accessor :maintenance_settings
+      
         # Unique name of the resource. It uses the form:
         # `projects/`project_id`/locations/`location_id`/instances/`instance_id``
         # Corresponds to the JSON property `name`
@@ -617,6 +623,7 @@ module Google
           @labels = args[:labels] if args.key?(:labels)
           @maintenance_policy_names = args[:maintenance_policy_names] if args.key?(:maintenance_policy_names)
           @maintenance_schedules = args[:maintenance_schedules] if args.key?(:maintenance_schedules)
+          @maintenance_settings = args[:maintenance_settings] if args.key?(:maintenance_settings)
           @name = args[:name] if args.key?(:name)
           @producer_metadata = args[:producer_metadata] if args.key?(:producer_metadata)
           @provisioned_resources = args[:provisioned_resources] if args.key?(:provisioned_resources)
@@ -672,6 +679,30 @@ module Google
         end
       end
       
+      # Maintenance settings associated with instance. Allows service producers and
+      # end users to assign settings that controls maintenance on this instance.
+      class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Exclude instance from maintenance. When true, rollout service will
+        # not
+        # attempt maintenance on the instance. Rollout service will include the
+        # instance in reported rollout progress as not attempted.
+        # Corresponds to the JSON property `exclude`
+        # @return [Boolean]
+        attr_accessor :exclude
+        alias_method :exclude?, :exclude
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @exclude = args[:exclude] if args.key?(:exclude)
+        end
+      end
+      
       # Node information for custom per-node SLO implementations.
       # SSA does not support per-node SLO, but producers can populate per-node
       # information in SloMetadata for custom precomputations.
@@ -1135,10 +1166,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": [
@@ -1153,7 +1187,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",
@@ -1226,6 +1262,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
@@ -1308,10 +1347,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": [
@@ -1326,7 +1368,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",