Autogenerated update (2017-12-07)

Update:
- admin_reports_v1
- cloudtasks_v2beta2
- dataproc_v1
- dataproc_v1beta2
- dlp_v2beta1
- poly_v1

generated/google/apis/admin_reports_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/admin-sdk/reports/
     module AdminReportsV1
       VERSION = 'ReportsV1'
-      REVISION = '20170622'
+      REVISION = '20171204'
 
       # View audit reports for your G Suite domain
       AUTH_ADMIN_REPORTS_AUDIT_READONLY = 'https://www.googleapis.com/auth/admin.reports.audit.readonly'

generated/google/apis/admin_reports_v1/classes.rb

@@ -398,17 +398,23 @@ module Google
           # @return [String]
           attr_accessor :customer_id
         
+          # Object key. Only relevant if entity.type = "OBJECT" Note: external-facing name
+          # of report is "Entities" rather than "Objects".
+          # Corresponds to the JSON property `entityId`
+          # @return [String]
+          attr_accessor :entity_id
+        
           # Obfuscated user id for the record.
           # Corresponds to the JSON property `profileId`
           # @return [String]
           attr_accessor :profile_id
         
-          # The type of item, can be a customer or user.
+          # The type of item, can be customer, user, or entity (aka. object).
           # Corresponds to the JSON property `type`
           # @return [String]
           attr_accessor :type
         
-          # user's email.
+          # user's email. Only relevant if entity.type = "USER"
           # Corresponds to the JSON property `userEmail`
           # @return [String]
           attr_accessor :user_email
@@ -420,6 +426,7 @@ module Google
           # Update properties of this object
           def update!(**args)
             @customer_id = args[:customer_id] if args.key?(:customer_id)
+            @entity_id = args[:entity_id] if args.key?(:entity_id)
             @profile_id = args[:profile_id] if args.key?(:profile_id)
             @type = args[:type] if args.key?(:type)
             @user_email = args[:user_email] if args.key?(:user_email)

generated/google/apis/admin_reports_v1/representations.rb

@@ -202,6 +202,7 @@ module Google
           # @private
           class Representation < Google::Apis::Core::JsonRepresentation
             property :customer_id, as: 'customerId'
+            property :entity_id, as: 'entityId'
             property :profile_id, as: 'profileId'
             property :type, as: 'type'
             property :user_email, as: 'userEmail'

generated/google/apis/admin_reports_v1/service.rb

@@ -268,6 +268,64 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Retrieves a report which is a collection of properties / statistics for a set
+        # of objects.
+        # @param [String] entity_type
+        #   Type of object. Should be one of - gplus_communities.
+        # @param [String] entity_key
+        #   Represents the key of object for which the data should be filtered.
+        # @param [String] date
+        #   Represents the date in yyyy-mm-dd format for which the data is to be fetched.
+        # @param [String] customer_id
+        #   Represents the customer for which the data is to be fetched.
+        # @param [String] filters
+        #   Represents the set of filters including parameter operator value.
+        # @param [Fixnum] max_results
+        #   Maximum number of results to return. Maximum allowed is 1000
+        # @param [String] page_token
+        #   Token to specify next page.
+        # @param [String] parameters
+        #   Represents the application name, parameter name pairs to fetch in csv as
+        #   app_name1:param_name1, app_name2:param_name2.
+        # @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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AdminReportsV1::UsageReports] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AdminReportsV1::UsageReports]
+        #
+        # @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_entity_usage_report(entity_type, entity_key, date, customer_id: nil, filters: nil, max_results: nil, page_token: nil, parameters: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'usage/{entityType}/{entityKey}/dates/{date}', options)
+          command.response_representation = Google::Apis::AdminReportsV1::UsageReports::Representation
+          command.response_class = Google::Apis::AdminReportsV1::UsageReports
+          command.params['entityType'] = entity_type unless entity_type.nil?
+          command.params['entityKey'] = entity_key unless entity_key.nil?
+          command.params['date'] = date unless date.nil?
+          command.query['customerId'] = customer_id unless customer_id.nil?
+          command.query['filters'] = filters unless filters.nil?
+          command.query['maxResults'] = max_results unless max_results.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['parameters'] = parameters unless parameters.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Retrieves a report which is a collection of properties / statistics for a set
         # of users.
         # @param [String] user_key

generated/google/apis/cloudtasks_v2beta2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/cloud-tasks/
     module CloudtasksV2beta2
       VERSION = 'V2beta2'
-      REVISION = '20171123'
+      REVISION = '20171205'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/cloudtasks_v2beta2/classes.rb

@@ -1057,6 +1057,9 @@ module Google
         # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
         # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
         # hyphens (-), colons (:), or periods (.).
+        # For more information, see
+        # [Identifying projects](/resource-manager/docs/creating-managing-projects#
+        # identifying_projects)
         # * `LOCATION_ID` is the canonical ID for the queue's location.
         # The list of available locations can be obtained by calling
         # google.cloud.location.Locations.ListLocations.
@@ -1565,6 +1568,9 @@ module Google
         # `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
         # hyphens (-), colons (:), or periods (.).
+        # For more information, see
+        # [Identifying projects](/resource-manager/docs/creating-managing-projects#
+        # identifying_projects)
         # * `LOCATION_ID` is the canonical ID for the task's location.
         # The list of available locations can be obtained by calling
         # google.cloud.location.Locations.ListLocations.

generated/google/apis/cloudtasks_v2beta2/service.rb

@@ -345,6 +345,9 @@ module Google
         #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
         #   * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
         #   hyphens (-), colons (:), or periods (.).
+        #   For more information, see
+        #   [Identifying projects](/resource-manager/docs/creating-managing-projects#
+        #   identifying_projects)
         #   * `LOCATION_ID` is the canonical ID for the queue's location.
         #   The list of available locations can be obtained by calling
         #   google.cloud.location.Locations.ListLocations.

generated/google/apis/dataproc_v1.rb

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

generated/google/apis/dataproc_v1/classes.rb

@@ -833,8 +833,7 @@ module Google
         # @return [Google::Apis::DataprocV1::JobReference]
         attr_accessor :reference
       
-        # Job scheduling options.Beta Feature: These options are available for testing
-        # purposes only. They may be changed before final release.
+        # Job scheduling options.
         # Corresponds to the JSON property `scheduling`
         # @return [Google::Apis::DataprocV1::JobScheduling]
         attr_accessor :scheduling
@@ -947,8 +946,7 @@ module Google
         end
       end
       
-      # Job scheduling options.Beta Feature: These options are available for testing
-      # purposes only. They may be changed before final release.
+      # Job scheduling options.
       class JobScheduling
         include Google::Apis::Core::Hashable
       

generated/google/apis/dataproc_v1/service.rb

@@ -260,6 +260,13 @@ module Google
         # @param [String] cluster_name
         #   Required. The cluster name.
         # @param [Google::Apis::DataprocV1::Cluster] cluster_object
+        # @param [String] graceful_decommission_timeout
+        #   Optional. Timeout for graceful YARN decomissioning. Graceful decommissioning
+        #   allows removing nodes from the cluster without interrupting jobs in progress.
+        #   Timeout specifies how long to wait for jobs in progress to finish before
+        #   forcefully removing nodes (and potentially interrupting jobs). Default timeout
+        #   is 0 (for forceful decommission), and the maximum allowed timeout is 1 day.
+        #   Only supported on Dataproc image versions 1.2 and higher.
         # @param [String] update_mask
         #   Required. Specifies the path, relative to Cluster, of the field to update. For
         #   example, to change the number of workers in a cluster to 5, the update_mask
@@ -306,7 +313,7 @@ module Google
         # @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 patch_cluster(project_id, region, cluster_name, cluster_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def patch_cluster(project_id, region, cluster_name, cluster_object = nil, graceful_decommission_timeout: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:patch, 'v1/projects/{projectId}/regions/{region}/clusters/{clusterName}', options)
           command.request_representation = Google::Apis::DataprocV1::Cluster::Representation
           command.request_object = cluster_object
@@ -315,6 +322,7 @@ module Google
           command.params['projectId'] = project_id unless project_id.nil?
           command.params['region'] = region unless region.nil?
           command.params['clusterName'] = cluster_name unless cluster_name.nil?
+          command.query['gracefulDecommissionTimeout'] = graceful_decommission_timeout unless graceful_decommission_timeout.nil?
           command.query['updateMask'] = update_mask unless update_mask.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?

generated/google/apis/dataproc_v1beta2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/dataproc/
     module DataprocV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20171031'
+      REVISION = '20171205'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/dataproc_v1beta2/classes.rb

@@ -519,6 +519,12 @@ module Google
         # @return [Fixnum]
         attr_accessor :boot_disk_size_gb
       
+        # Optional. Type of the boot disk (default is 'pd-standard'). Valid values: 'pd-
+        # ssd', 'pd-standard'
+        # Corresponds to the JSON property `bootDiskType`
+        # @return [String]
+        attr_accessor :boot_disk_type
+      
         # Optional. Number of attached SSDs, from 0 to 4 (default is 0). If SSDs are not
         # attached, the boot disk is used to store runtime logs and HDFS (https://hadoop.
         # apache.org/docs/r1.2.1/hdfs_user_guide.html) data. If one or more SSDs are
@@ -535,6 +541,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @boot_disk_size_gb = args[:boot_disk_size_gb] if args.key?(:boot_disk_size_gb)
+          @boot_disk_type = args[:boot_disk_type] if args.key?(:boot_disk_type)
           @num_local_ssds = args[:num_local_ssds] if args.key?(:num_local_ssds)
         end
       end
@@ -970,8 +977,7 @@ module Google
         # @return [Google::Apis::DataprocV1beta2::JobReference]
         attr_accessor :reference
       
-        # Job scheduling options.Beta Feature: These options are available for testing
-        # purposes only. They may be changed before final release.
+        # Job scheduling options.
         # Corresponds to the JSON property `scheduling`
         # @return [Google::Apis::DataprocV1beta2::JobScheduling]
         attr_accessor :scheduling
@@ -1084,8 +1090,7 @@ module Google
         end
       end
       
-      # Job scheduling options.Beta Feature: These options are available for testing
-      # purposes only. They may be changed before final release.
+      # Job scheduling options.
       class JobScheduling
         include Google::Apis::Core::Hashable
       
@@ -1532,8 +1537,7 @@ module Google
         # @return [Google::Apis::DataprocV1beta2::PySparkJob]
         attr_accessor :pyspark_job
       
-        # Job scheduling options.Beta Feature: These options are available for testing
-        # purposes only. They may be changed before final release.
+        # Job scheduling options.
         # Corresponds to the JSON property `scheduling`
         # @return [Google::Apis::DataprocV1beta2::JobScheduling]
         attr_accessor :scheduling

generated/google/apis/dataproc_v1beta2/representations.rb

@@ -485,6 +485,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :boot_disk_size_gb, as: 'bootDiskSizeGb'
+          property :boot_disk_type, as: 'bootDiskType'
           property :num_local_ssds, as: 'numLocalSsds'
         end
       end

generated/google/apis/dlp_v2beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/dlp/docs/
     module DlpV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20171121'
+      REVISION = '20171205'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/dlp_v2beta1/classes.rb

@@ -876,6 +876,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :radix
       
+        # Type of information detected by the API.
+        # Corresponds to the JSON property `surrogateInfoType`
+        # @return [Google::Apis::DlpV2beta1::GooglePrivacyDlpV2beta1InfoType]
+        attr_accessor :surrogate_info_type
+      
         def initialize(**args)
            update!(**args)
         end
@@ -887,6 +892,7 @@ module Google
           @crypto_key = args[:crypto_key] if args.key?(:crypto_key)
           @custom_alphabet = args[:custom_alphabet] if args.key?(:custom_alphabet)
           @radix = args[:radix] if args.key?(:radix)
+          @surrogate_info_type = args[:surrogate_info_type] if args.key?(:surrogate_info_type)
         end
       end
       
@@ -922,6 +928,18 @@ module Google
         # @return [Google::Apis::DlpV2beta1::GooglePrivacyDlpV2beta1InfoType]
         attr_accessor :info_type
       
+        # Message for detecting output from deidentification transformations
+        # such as
+        # [`CryptoReplaceFfxFpeConfig`](/dlp/docs/reference/rest/v2beta1/content/
+        # deidentify#CryptoReplaceFfxFpeConfig).
+        # These types of transformations are
+        # those that perform pseudonymization, thereby producing a "surrogate" as
+        # output. This should be used in conjunction with a field on the
+        # transformation such as `surrogate_info_type`.
+        # Corresponds to the JSON property `surrogateType`
+        # @return [Google::Apis::DlpV2beta1::GooglePrivacyDlpV2beta1SurrogateType]
+        attr_accessor :surrogate_type
+      
         def initialize(**args)
            update!(**args)
         end
@@ -930,6 +948,7 @@ module Google
         def update!(**args)
           @dictionary = args[:dictionary] if args.key?(:dictionary)
           @info_type = args[:info_type] if args.key?(:info_type)
+          @surrogate_type = args[:surrogate_type] if args.key?(:surrogate_type)
         end
       end
       
@@ -3180,6 +3199,26 @@ module Google
         end
       end
       
+      # Message for detecting output from deidentification transformations
+      # such as
+      # [`CryptoReplaceFfxFpeConfig`](/dlp/docs/reference/rest/v2beta1/content/
+      # deidentify#CryptoReplaceFfxFpeConfig).
+      # These types of transformations are
+      # those that perform pseudonymization, thereby producing a "surrogate" as
+      # output. This should be used in conjunction with a field on the
+      # transformation such as `surrogate_info_type`.
+      class GooglePrivacyDlpV2beta1SurrogateType
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Structured content to inspect. Up to 50,000 `Value`s per request allowed.
       class GooglePrivacyDlpV2beta1Table
         include Google::Apis::Core::Hashable

generated/google/apis/dlp_v2beta1/representations.rb

@@ -628,6 +628,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GooglePrivacyDlpV2beta1SurrogateType
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GooglePrivacyDlpV2beta1Table
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -960,6 +966,8 @@ module Google
       
           property :custom_alphabet, as: 'customAlphabet'
           property :radix, as: 'radix'
+          property :surrogate_info_type, as: 'surrogateInfoType', class: Google::Apis::DlpV2beta1::GooglePrivacyDlpV2beta1InfoType, decorator: Google::Apis::DlpV2beta1::GooglePrivacyDlpV2beta1InfoType::Representation
+      
         end
       end
       
@@ -970,6 +978,8 @@ module Google
       
           property :info_type, as: 'infoType', class: Google::Apis::DlpV2beta1::GooglePrivacyDlpV2beta1InfoType, decorator: Google::Apis::DlpV2beta1::GooglePrivacyDlpV2beta1InfoType::Representation
       
+          property :surrogate_type, as: 'surrogateType', class: Google::Apis::DlpV2beta1::GooglePrivacyDlpV2beta1SurrogateType, decorator: Google::Apis::DlpV2beta1::GooglePrivacyDlpV2beta1SurrogateType::Representation
+      
         end
       end
       
@@ -1707,6 +1717,12 @@ module Google
         end
       end
       
+      class GooglePrivacyDlpV2beta1SurrogateType
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GooglePrivacyDlpV2beta1Table
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

generated/google/apis/poly_v1.rb

@@ -23,10 +23,10 @@ module Google
     # The Poly API provides read-only access to assets hosted on <a href="https://
     # poly.google.com">poly.google.com</a>.
     #
-    # @see https://devsite.googleplex.com/poly/
+    # @see https://developers.google.com/poly/
     module PolyV1
       VERSION = 'V1'
-      REVISION = '20171124'
+      REVISION = '20171205'
     end
   end
 end

generated/google/apis/poly_v1/service.rb

@@ -31,7 +31,7 @@ module Google
       #    Poly = Google::Apis::PolyV1 # Alias the module
       #    service = Poly::PolyServiceService.new
       #
-      # @see https://devsite.googleplex.com/poly/
+      # @see https://developers.google.com/poly/
       class PolyServiceService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,