google-api-client 0.31.0 → 0.32.0

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

@@ -359,7 +359,9 @@ module Google
         end
         
         # Deletes Item resource for the
-        # specified resource name.
+        # specified resource name. This API requires an admin or service account
+        # to execute. The service account used is the one whitelisted in the
+        # corresponding data source.
         # @param [String] name
         #   Required. Name of the item to delete.
         #   Format: datasources/`source_id`/items/`item_id`
@@ -414,6 +416,8 @@ module Google
         
         # Deletes all items in a queue. This method is useful for deleting stale
         # items.
+        # This API requires an admin or service account to execute. The service
+        # account used is the one whitelisted in the corresponding data source.
         # @param [String] name
         #   Name of the Data Source to delete items in a queue.
         #   Format: datasources/`source_id`
@@ -448,6 +452,8 @@ module Google
         end
         
         # Gets Item resource by item name.
+        # This API requires an admin or service account to execute.  The service
+        # account used is the one whitelisted in the corresponding data source.
         # @param [String] name
         #   Name of the item to get info.
         #   Format: datasources/`source_id`/items/`item_id`
@@ -491,6 +497,8 @@ module Google
         # does not exist.
         # This method does not support partial updates.  Fields with no provided
         # values are cleared out in the Cloud Search index.
+        # This API requires an admin or service account to execute. The service
+        # account used is the one whitelisted in the corresponding data source.
         # @param [String] name
         #   Name of the Item. Format:
         #   datasources/`source_id`/items/`item_id`
@@ -527,6 +535,8 @@ module Google
         end
         
         # Lists all or a subset of Item resources.
+        # This API requires an admin or service account to execute. The service
+        # account used is the one whitelisted in the corresponding data source.
         # @param [String] name
         #   Name of the Data Source to list Items.  Format:
         #   datasources/`source_id`
@@ -534,9 +544,21 @@ module Google
         #   When set to true, the indexing system only populates the following fields:
         #   name,
         #   version,
+        #   queue.
         #   metadata.hash,
+        #   metadata.title,
+        #   metadata.sourceRepositoryURL,
+        #   metadata.objectType,
+        #   metadata.createTime,
+        #   metadata.updateTime,
+        #   metadata.contentLanguage,
+        #   metadata.mimeType,
         #   structured_data.hash,
-        #   content.hash.
+        #   content.hash,
+        #   itemType,
+        #   itemStatus.code,
+        #   itemStatus.processingError.code,
+        #   itemStatus.repositoryError.type,
         #   <br />If this value is false, then all the fields are populated in Item.
         # @param [String] connector_name
         #   Name of connector making this call.
@@ -606,6 +628,8 @@ module Google
         # the type REQUEUE.
         # Items automatically become available (unreserved) after 4 hours even if no
         # update or push method is called.
+        # This API requires an admin or service account to execute. The service
+        # account used is the one whitelisted in the corresponding data source.
         # @param [String] name
         #   Name of the Data Source to poll items.
         #   Format: datasources/`source_id`
@@ -640,6 +664,8 @@ module Google
         end
         
         # Pushes an item onto a queue for later polling and updating.
+        # This API requires an admin or service account to execute. The service
+        # account used is the one whitelisted in the corresponding data source.
         # @param [String] name
         #   Name of the item to
         #   push into the indexing queue.<br />
@@ -679,6 +705,8 @@ module Google
         # Unreserves all items from a queue, making them all eligible to be
         # polled.  This method is useful for resetting the indexing queue
         # after a connector has been restarted.
+        # This API requires an admin or service account to execute. The service
+        # account used is the one whitelisted in the corresponding data source.
         # @param [String] name
         #   Name of the Data Source to unreserve all items.
         #   Format: datasources/`source_id`
@@ -716,6 +744,8 @@ module Google
         # than 100 KB, it's easier to embed the content
         # inline within
         # an index request.
+        # This API requires an admin or service account to execute. The service
+        # account used is the one whitelisted in the corresponding data source.
         # @param [String] name
         #   Name of the Item to start a resumable upload.
         #   Format: datasources/`source_id`/items/`item_id`.
@@ -1391,6 +1421,141 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Get the query statistics for customer
+        # @param [Fixnum] from_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] from_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] from_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @param [Fixnum] to_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] to_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] to_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @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::CloudsearchV1::GetCustomerQueryStatsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudsearchV1::GetCustomerQueryStatsResponse]
+        #
+        # @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_stat_query(from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/stats/query', options)
+          command.response_representation = Google::Apis::CloudsearchV1::GetCustomerQueryStatsResponse::Representation
+          command.response_class = Google::Apis::CloudsearchV1::GetCustomerQueryStatsResponse
+          command.query['fromDate.day'] = from_date_day unless from_date_day.nil?
+          command.query['fromDate.month'] = from_date_month unless from_date_month.nil?
+          command.query['fromDate.year'] = from_date_year unless from_date_year.nil?
+          command.query['toDate.day'] = to_date_day unless to_date_day.nil?
+          command.query['toDate.month'] = to_date_month unless to_date_month.nil?
+          command.query['toDate.year'] = to_date_year unless to_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
+        
+        # Get the # of search sessions for the customer
+        # @param [Fixnum] from_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] from_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] from_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @param [Fixnum] to_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] to_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] to_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @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::CloudsearchV1::GetCustomerSessionStatsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudsearchV1::GetCustomerSessionStatsResponse]
+        #
+        # @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_stat_session(from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/stats/session', options)
+          command.response_representation = Google::Apis::CloudsearchV1::GetCustomerSessionStatsResponse::Representation
+          command.response_class = Google::Apis::CloudsearchV1::GetCustomerSessionStatsResponse
+          command.query['fromDate.day'] = from_date_day unless from_date_day.nil?
+          command.query['fromDate.month'] = from_date_month unless from_date_month.nil?
+          command.query['fromDate.year'] = from_date_year unless from_date_year.nil?
+          command.query['toDate.day'] = to_date_day unless to_date_day.nil?
+          command.query['toDate.month'] = to_date_month unless to_date_month.nil?
+          command.query['toDate.year'] = to_date_year unless to_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
+        
+        # Get the users statistics for customer
+        # @param [Fixnum] from_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] from_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] from_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @param [Fixnum] to_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] to_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] to_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @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::CloudsearchV1::GetCustomerUserStatsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudsearchV1::GetCustomerUserStatsResponse]
+        #
+        # @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_stat_user(from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/stats/user', options)
+          command.response_representation = Google::Apis::CloudsearchV1::GetCustomerUserStatsResponse::Representation
+          command.response_class = Google::Apis::CloudsearchV1::GetCustomerUserStatsResponse
+          command.query['fromDate.day'] = from_date_day unless from_date_day.nil?
+          command.query['fromDate.month'] = from_date_month unless from_date_month.nil?
+          command.query['fromDate.year'] = from_date_year unless from_date_year.nil?
+          command.query['toDate.day'] = to_date_day unless to_date_day.nil?
+          command.query['toDate.month'] = to_date_month unless to_date_month.nil?
+          command.query['toDate.year'] = to_date_year unless to_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
+        
         # Gets indexed item statistics for a single data source.
         # @param [String] name
         #   The resource id of the data source to retrieve statistics for,
@@ -1439,6 +1604,153 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Get the query statistics for search application
+        # @param [String] name
+        #   The resource id of the search application query stats, in the following
+        #   format: searchapplications/`application_id`
+        # @param [Fixnum] from_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] from_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] from_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @param [Fixnum] to_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] to_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] to_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @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::CloudsearchV1::GetSearchApplicationQueryStatsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudsearchV1::GetSearchApplicationQueryStatsResponse]
+        #
+        # @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_stat_query_searchapplication(name, from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/stats/query/{+name}', options)
+          command.response_representation = Google::Apis::CloudsearchV1::GetSearchApplicationQueryStatsResponse::Representation
+          command.response_class = Google::Apis::CloudsearchV1::GetSearchApplicationQueryStatsResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fromDate.day'] = from_date_day unless from_date_day.nil?
+          command.query['fromDate.month'] = from_date_month unless from_date_month.nil?
+          command.query['fromDate.year'] = from_date_year unless from_date_year.nil?
+          command.query['toDate.day'] = to_date_day unless to_date_day.nil?
+          command.query['toDate.month'] = to_date_month unless to_date_month.nil?
+          command.query['toDate.year'] = to_date_year unless to_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
+        
+        # Get the # of search sessions for the search application
+        # @param [String] name
+        #   The resource id of the search application session stats, in the following
+        #   format: searchapplications/`application_id`
+        # @param [Fixnum] from_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] from_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] from_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @param [Fixnum] to_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] to_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] to_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @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::CloudsearchV1::GetSearchApplicationSessionStatsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudsearchV1::GetSearchApplicationSessionStatsResponse]
+        #
+        # @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_stat_session_searchapplication(name, from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/stats/session/{+name}', options)
+          command.response_representation = Google::Apis::CloudsearchV1::GetSearchApplicationSessionStatsResponse::Representation
+          command.response_class = Google::Apis::CloudsearchV1::GetSearchApplicationSessionStatsResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fromDate.day'] = from_date_day unless from_date_day.nil?
+          command.query['fromDate.month'] = from_date_month unless from_date_month.nil?
+          command.query['fromDate.year'] = from_date_year unless from_date_year.nil?
+          command.query['toDate.day'] = to_date_day unless to_date_day.nil?
+          command.query['toDate.month'] = to_date_month unless to_date_month.nil?
+          command.query['toDate.year'] = to_date_year unless to_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
+        
+        # Get the users statistics for search application
+        # @param [String] name
+        #   The resource id of the search application session stats, in the following
+        #   format: searchapplications/`application_id`
+        # @param [Fixnum] from_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] from_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] from_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @param [Fixnum] to_date_day
+        #   Day of month. Must be from 1 to 31 and valid for the year and month.
+        # @param [Fixnum] to_date_month
+        #   Month of date. Must be from 1 to 12.
+        # @param [Fixnum] to_date_year
+        #   Year of date. Must be from 1 to 9999.
+        # @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::CloudsearchV1::GetSearchApplicationUserStatsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudsearchV1::GetSearchApplicationUserStatsResponse]
+        #
+        # @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_stat_user_searchapplication(name, from_date_day: nil, from_date_month: nil, from_date_year: nil, to_date_day: nil, to_date_month: nil, to_date_year: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/stats/user/{+name}', options)
+          command.response_representation = Google::Apis::CloudsearchV1::GetSearchApplicationUserStatsResponse::Representation
+          command.response_class = Google::Apis::CloudsearchV1::GetSearchApplicationUserStatsResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fromDate.day'] = from_date_day unless from_date_day.nil?
+          command.query['fromDate.month'] = from_date_month unless from_date_month.nil?
+          command.query['fromDate.year'] = from_date_year unless from_date_year.nil?
+          command.query['toDate.day'] = to_date_day unless to_date_day.nil?
+          command.query['toDate.month'] = to_date_month unless to_date_month.nil?
+          command.query['toDate.year'] = to_date_year unless to_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
 

data/generated/google/apis/cloudtasks_v2beta3.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/tasks/
     module CloudtasksV2beta3
       VERSION = 'V2beta3'
-      REVISION = '20190906'
+      REVISION = '20190927'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -886,25 +886,34 @@ module Google
       
       # Defines an Identity and Access Management (IAM) policy. It is used to
       # specify access control policies for Cloud Platform resources.
-      # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
-      # `members` to a `role`, where the members can be user accounts, Google groups,
-      # Google domains, and service accounts. A `role` is a named list of permissions
-      # defined by IAM.
+      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # permissions (defined by IAM or configured by users). A `binding` can
+      # optionally specify a `condition`, which is a logic expression that further
+      # constrains the role binding based on attributes about the request and/or
+      # target resource.
       # **JSON Example**
       # `
       # "bindings": [
       # `
-      # "role": "roles/owner",
+      # "role": "roles/resourcemanager.organizationAdmin",
       # "members": [
       # "user:mike@example.com",
       # "group:admins@example.com",
       # "domain:google.com",
-      # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
+      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
       # ]
       # `,
       # `
-      # "role": "roles/viewer",
-      # "members": ["user:sean@example.com"]
+      # "role": "roles/resourcemanager.organizationViewer",
+      # "members": ["user:eve@example.com"],
+      # "condition": `
+      # "title": "expirable access",
+      # "description": "Does not grant access after Sep 2020",
+      # "expression": "request.time <
+      # timestamp('2020-10-01T00:00:00.000Z')",
+      # `
       # `
       # ]
       # `
@@ -914,17 +923,22 @@ module Google
       # - user:mike@example.com
       # - group:admins@example.com
       # - domain:google.com
-      # - serviceAccount:my-other-app@appspot.gserviceaccount.com
-      # role: roles/owner
+      # - serviceAccount:my-project-id@appspot.gserviceaccount.com
+      # role: roles/resourcemanager.organizationAdmin
       # - members:
-      # - user:sean@example.com
-      # role: roles/viewer
+      # - user:eve@example.com
+      # role: roles/resourcemanager.organizationViewer
+      # condition:
+      # title: expirable access
+      # description: Does not grant access after Sep 2020
+      # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
       # For a description of IAM and its features, see the
       # [IAM developer's guide](https://cloud.google.com/iam/docs).
       class Policy
         include Google::Apis::Core::Hashable
       
-        # Associates a list of `members` to a `role`.
+        # Associates a list of `members` to a `role`. Optionally may specify a
+        # `condition` that determines when binding is in effect.
         # `bindings` with no members will result in an error.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::CloudtasksV2beta3::Binding>]
@@ -938,7 +952,9 @@ module Google
         # systems are expected to put that etag in the request to `setIamPolicy` to
         # ensure that their change will be applied to the same version of the policy.
         # If no `etag` is provided in the call to `setIamPolicy`, then the existing
-        # policy is overwritten.
+        # policy is overwritten. Due to blind-set semantics of an etag-less policy,
+        # 'setIamPolicy' will not fail even if either of incoming or stored policy
+        # does not meet the version requirements.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -947,9 +963,13 @@ module Google
         # Specifies the format of the policy.
         # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
         # rejected.
-        # Policies with any conditional bindings must specify version 3. Policies
-        # without any conditional bindings may specify any valid value or leave the
-        # field unset.
+        # Operations affecting conditional bindings must specify version 3. This can
+        # be either setting a conditional policy, modifying a conditional binding,
+        # or removing a conditional binding from the stored conditional policy.
+        # Operations on non-conditional policies may specify any valid value or
+        # leave the field unset.
+        # If no etag is provided in the call to `setIamPolicy`, any version
+        # compliance checks on the incoming and/or stored policy is skipped.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -1321,25 +1341,34 @@ module Google
       
         # Defines an Identity and Access Management (IAM) policy. It is used to
         # specify access control policies for Cloud Platform resources.
-        # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
-        # `members` to a `role`, where the members can be user accounts, Google groups,
-        # Google domains, and service accounts. A `role` is a named list of permissions
-        # defined by IAM.
+        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # permissions (defined by IAM or configured by users). A `binding` can
+        # optionally specify a `condition`, which is a logic expression that further
+        # constrains the role binding based on attributes about the request and/or
+        # target resource.
         # **JSON Example**
         # `
         # "bindings": [
         # `
-        # "role": "roles/owner",
+        # "role": "roles/resourcemanager.organizationAdmin",
         # "members": [
         # "user:mike@example.com",
         # "group:admins@example.com",
         # "domain:google.com",
-        # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
+        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
         # ]
         # `,
         # `
-        # "role": "roles/viewer",
-        # "members": ["user:sean@example.com"]
+        # "role": "roles/resourcemanager.organizationViewer",
+        # "members": ["user:eve@example.com"],
+        # "condition": `
+        # "title": "expirable access",
+        # "description": "Does not grant access after Sep 2020",
+        # "expression": "request.time <
+        # timestamp('2020-10-01T00:00:00.000Z')",
+        # `
         # `
         # ]
         # `
@@ -1349,11 +1378,15 @@ module Google
         # - user:mike@example.com
         # - group:admins@example.com
         # - domain:google.com
-        # - serviceAccount:my-other-app@appspot.gserviceaccount.com
-        # role: roles/owner
+        # - serviceAccount:my-project-id@appspot.gserviceaccount.com
+        # role: roles/resourcemanager.organizationAdmin
         # - members:
-        # - user:sean@example.com
-        # role: roles/viewer
+        # - user:eve@example.com
+        # role: roles/resourcemanager.organizationViewer
+        # condition:
+        # title: expirable access
+        # description: Does not grant access after Sep 2020
+        # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
         # For a description of IAM and its features, see the
         # [IAM developer's guide](https://cloud.google.com/iam/docs).
         # Corresponds to the JSON property `policy`