Autogenerated update (2017-12-22)

Update:
- calendar_v3
- ml_v1
- runtimeconfig_v1beta1
- servicecontrol_v1
- storage_v1
- tpu_v1alpha1
- youtube_partner_v1

api_names_out.yaml

@@ -11261,6 +11261,7 @@
 "/calendar:v3/ConferenceData/createRequest": create_request
 "/calendar:v3/ConferenceData/entryPoints": entry_points
 "/calendar:v3/ConferenceData/entryPoints/entry_point": entry_point
+"/calendar:v3/ConferenceData/notes": notes
 "/calendar:v3/ConferenceData/signature": signature
 "/calendar:v3/ConferenceProperties": conference_properties
 "/calendar:v3/ConferenceProperties/allowedConferenceSolutionTypes": allowed_conference_solution_types
@@ -58696,6 +58697,7 @@
 "/servicecontrol:v1/CheckError": check_error
 "/servicecontrol:v1/CheckError/code": code
 "/servicecontrol:v1/CheckError/detail": detail
+"/servicecontrol:v1/CheckError/subject": subject
 "/servicecontrol:v1/CheckInfo": check_info
 "/servicecontrol:v1/CheckInfo/consumerInfo": consumer_info
 "/servicecontrol:v1/CheckInfo/unusedArguments": unused_arguments
@@ -62962,6 +62964,7 @@
 "/storage:v1/Bucket/cors/cors_configuration/origin/origin": origin
 "/storage:v1/Bucket/cors/cors_configuration/responseHeader": response_header
 "/storage:v1/Bucket/cors/cors_configuration/responseHeader/response_header": response_header
+"/storage:v1/Bucket/defaultEventBasedHold": default_event_based_hold
 "/storage:v1/Bucket/defaultObjectAcl": default_object_acl
 "/storage:v1/Bucket/defaultObjectAcl/default_object_acl": default_object_acl
 "/storage:v1/Bucket/encryption": encryption
@@ -62994,6 +62997,10 @@
 "/storage:v1/Bucket/owner/entity": entity
 "/storage:v1/Bucket/owner/entityId": entity_id
 "/storage:v1/Bucket/projectNumber": project_number
+"/storage:v1/Bucket/retentionPolicy": retention_policy
+"/storage:v1/Bucket/retentionPolicy/effectiveTime": effective_time
+"/storage:v1/Bucket/retentionPolicy/isLocked": is_locked
+"/storage:v1/Bucket/retentionPolicy/retentionPeriod": retention_period
 "/storage:v1/Bucket/selfLink": self_link
 "/storage:v1/Bucket/storageClass": storage_class
 "/storage:v1/Bucket/timeCreated": time_created
@@ -63078,6 +63085,7 @@
 "/storage:v1/Object/customerEncryption/encryptionAlgorithm": encryption_algorithm
 "/storage:v1/Object/customerEncryption/keySha256": key_sha256
 "/storage:v1/Object/etag": etag
+"/storage:v1/Object/eventBasedHold": event_based_hold
 "/storage:v1/Object/generation": generation
 "/storage:v1/Object/id": id
 "/storage:v1/Object/kind": kind
@@ -63091,9 +63099,11 @@
 "/storage:v1/Object/owner": owner
 "/storage:v1/Object/owner/entity": entity
 "/storage:v1/Object/owner/entityId": entity_id
+"/storage:v1/Object/retentionExpirationTime": retention_expiration_time
 "/storage:v1/Object/selfLink": self_link
 "/storage:v1/Object/size": size
 "/storage:v1/Object/storageClass": storage_class
+"/storage:v1/Object/temporaryHold": temporary_hold
 "/storage:v1/Object/timeCreated": time_created
 "/storage:v1/Object/timeDeleted": time_deleted
 "/storage:v1/Object/timeStorageClassUpdated": time_storage_class_updated
@@ -63201,6 +63211,10 @@
 "/storage:v1/storage.buckets.list/project": project
 "/storage:v1/storage.buckets.list/projection": projection
 "/storage:v1/storage.buckets.list/userProject": user_project
+"/storage:v1/storage.buckets.lockRetentionPolicy": lock_bucket_retention_policy
+"/storage:v1/storage.buckets.lockRetentionPolicy/bucket": bucket
+"/storage:v1/storage.buckets.lockRetentionPolicy/ifMetagenerationMatch": if_metageneration_match
+"/storage:v1/storage.buckets.lockRetentionPolicy/userProject": user_project
 "/storage:v1/storage.buckets.patch": patch_bucket
 "/storage:v1/storage.buckets.patch/bucket": bucket
 "/storage:v1/storage.buckets.patch/ifMetagenerationMatch": if_metageneration_match
@@ -66524,6 +66538,7 @@
 "/tpu:v1alpha1/Node/cidrBlock": cidr_block
 "/tpu:v1alpha1/Node/createTime": create_time
 "/tpu:v1alpha1/Node/description": description
+"/tpu:v1alpha1/Node/health": health
 "/tpu:v1alpha1/Node/healthDescription": health_description
 "/tpu:v1alpha1/Node/ipAddress": ip_address
 "/tpu:v1alpha1/Node/name": name

generated/google/apis/calendar_v3.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/google-apps/calendar/firstapp
     module CalendarV3
       VERSION = 'V3'
-      REVISION = '20171212'
+      REVISION = '20171217'
 
       # Manage your calendars
       AUTH_CALENDAR = 'https://www.googleapis.com/auth/calendar'

generated/google/apis/calendar_v3/classes.rb

@@ -655,6 +655,13 @@ module Google
         # @return [Array<Google::Apis::CalendarV3::EntryPoint>]
         attr_accessor :entry_points
       
+        # Additional notes (such as instructions from the domain administrator, legal
+        # notices) to display to the user. Can contain HTML. The maximum length is 2048
+        # characters. Optional.
+        # Corresponds to the JSON property `notes`
+        # @return [String]
+        attr_accessor :notes
+      
         # The signature of the conference data.
         # Genereated on server side. Must be preserved while copying the conference data
         # between events, otherwise the conference data will not be copied.
@@ -674,6 +681,7 @@ module Google
           @conference_solution = args[:conference_solution] if args.key?(:conference_solution)
           @create_request = args[:create_request] if args.key?(:create_request)
           @entry_points = args[:entry_points] if args.key?(:entry_points)
+          @notes = args[:notes] if args.key?(:notes)
           @signature = args[:signature] if args.key?(:signature)
         end
       end

generated/google/apis/calendar_v3/representations.rb

@@ -406,6 +406,7 @@ module Google
       
           collection :entry_points, as: 'entryPoints', class: Google::Apis::CalendarV3::EntryPoint, decorator: Google::Apis::CalendarV3::EntryPoint::Representation
       
+          property :notes, as: 'notes'
           property :signature, as: 'signature'
         end
       end

generated/google/apis/ml_v1.rb

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

generated/google/apis/ml_v1/classes.rb

@@ -368,7 +368,12 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Represents input parameters for a training job.
+        # Represents input parameters for a training job. When using the
+        # gcloud command to submit your training job, you can specify
+        # the input parameters as command-line arguments and/or in a YAML configuration
+        # file referenced from the --config command-line argument. For
+        # details, see the guide to
+        # <a href="/ml-engine/docs/training-jobs">submitting a training job</a>.
         # Corresponds to the JSON property `trainingInput`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1TrainingInput]
         attr_accessor :training_input
@@ -610,6 +615,8 @@ module Google
         # Optional. The list of regions where the model is going to be deployed.
         # Currently only one region per model is supported.
         # Defaults to 'us-central1' if nothing is set.
+        # See the <a href="/ml-engine/docs/regions">available regions</a> for
+        # ML Engine services.
         # Note:
         # *   No matter where a model is deployed, it can always be accessed by
         # users from anywhere, both for online and batch prediction.
@@ -866,6 +873,8 @@ module Google
         attr_accessor :output_path
       
         # Required. The Google Compute Engine region to run the prediction job in.
+        # See the <a href="/ml-engine/docs/regions">available regions</a> for
+        # ML Engine services.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
@@ -976,7 +985,12 @@ module Google
         end
       end
       
-      # Represents input parameters for a training job.
+      # Represents input parameters for a training job. When using the
+      # gcloud command to submit your training job, you can specify
+      # the input parameters as command-line arguments and/or in a YAML configuration
+      # file referenced from the --config command-line argument. For
+      # details, see the guide to
+      # <a href="/ml-engine/docs/training-jobs">submitting a training job</a>.
       class GoogleCloudMlV1TrainingInput
         include Google::Apis::Core::Hashable
       
@@ -1052,14 +1066,14 @@ module Google
         # <dd>
         # A machine equivalent to <code suppresswarning="true">standard</code> that
         # also includes a single NVIDIA Tesla P100 GPU. The availability of these
-        # GPUs is in the Alpha launch stage.
+        # GPUs is in the Beta launch stage.
         # </dd>
         # <dt>complex_model_m_p100</dt>
         # <dd>
         # A machine equivalent to
         # <code suppresswarning="true">complex_model_m</code> that also includes
         # four NVIDIA Tesla P100 GPUs. The availability of these GPUs is in
-        # the Alpha launch stage.
+        # the Beta launch stage.
         # </dd>
         # </dl>
         # You must set this value when `scaleTier` is set to `CUSTOM`.
@@ -1099,12 +1113,15 @@ module Google
         attr_accessor :python_module
       
         # Optional. The version of Python used in training. If not set, the default
-        # version is '2.7'.
+        # version is '2.7'. Python '3.5' is available when `runtime_version` is set
+        # to '1.4' and above. Python '2.7' works with all supported runtime versions.
         # Corresponds to the JSON property `pythonVersion`
         # @return [String]
         attr_accessor :python_version
       
         # Required. The Google Compute Engine region to run the training job in.
+        # See the <a href="/ml-engine/docs/regions">available regions</a> for
+        # ML Engine services.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region

generated/google/apis/ml_v1/service.rb

@@ -82,8 +82,8 @@ module Google
         
         # Performs prediction on the data in the request.
         # Cloud ML Engine implements a custom `predict` verb on top of an HTTP POST
-        # method. For details of the format, see the **guide to the
+        # method. <p>For details of the request and response format, see the **guide
-        # [predict request format](/ml-engine/docs/v1/predict-request)**.
+        # to the [predict request format](/ml-engine/docs/v1/predict-request)**.
         # @param [String] name
         #   Required. The resource name of a model or a version.
         #   Authorization: requires the `predict` permission on the specified resource.
@@ -247,10 +247,20 @@ module Google
         end
         
         # Lists the jobs in the project.
+        # If there are no jobs that match the request parameters, the list
+        # request returns an empty response body: ``.
         # @param [String] parent
         #   Required. The name of the project for which to list jobs.
         # @param [String] filter
         #   Optional. Specifies the subset of jobs to retrieve.
+        #   You can filter on the value of one or more attributes of the job object.
+        #   For example, retrieve jobs with a job identifier that starts with 'census':
+        #   <p><code>gcloud ml-engine jobs list --filter='jobId:census*'</code>
+        #   <p>List all failed jobs with names that start with 'rnn':
+        #   <p><code>gcloud ml-engine jobs list --filter='jobId:rnn*
+        #   AND state:FAILED'</code>
+        #   <p>For more examples, see the guide to
+        #   <a href="/ml-engine/docs/monitor-training">monitoring jobs</a>.
         # @param [Fixnum] page_size
         #   Optional. The number of jobs to retrieve per "page" of results. If there
         #   are more remaining results than this number, the response message will
@@ -629,6 +639,8 @@ module Google
         # Lists the models in a project.
         # Each project can contain multiple models, and each model can have multiple
         # versions.
+        # If there are no models that match the request parameters, the list request
+        # returns an empty response body: ``.
         # @param [String] parent
         #   Required. The name of the project whose models are to be listed.
         # @param [String] filter
@@ -912,9 +924,11 @@ module Google
         end
         
         # Gets basic information about all the versions of a model.
-        # If you expect that a model has a lot of versions, or if you need to handle
+        # If you expect that a model has many versions, or if you need to handle
         # only a limited number of results at a time, you can request that the list
-        # be retrieved in batches (called pages):
+        # be retrieved in batches (called pages).
+        # If there are no versions that match the request parameters, the list
+        # request returns an empty response body: ``.
         # @param [String] parent
         #   Required. The name of the model for which to list the version.
         # @param [String] filter
@@ -976,7 +990,7 @@ module Google
         #   To adopt etag mechanism, include `etag` field in the mask, and include the
         #   `etag` value in your version resource.
         #   Currently the only supported update masks are `description`, `labels`, and
-        #   `etag`.
+        #   `etag`, and `expire_time`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

generated/google/apis/runtimeconfig_v1beta1.rb

@@ -28,7 +28,7 @@ module Google
     # @see https://cloud.google.com/deployment-manager/runtime-configurator/
     module RuntimeconfigV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20171030'
+      REVISION = '20171219'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/runtimeconfig_v1beta1/classes.rb

@@ -416,8 +416,8 @@ module Google
         # The resource name of a runtime config. The name must have the format:
         # projects/[PROJECT_ID]/configs/[CONFIG_NAME]
         # The `[PROJECT_ID]` must be a valid project ID, and `[CONFIG_NAME]` is an
-        # arbitrary name that matches
+        # arbitrary name that matches the
-        # [0-9A-Za-z](?:[_.A-Za-z0-9-]`0,62`[_.A-Za-z0-9])? regular expression.
+        # `[0-9A-Za-z](?:[_.A-Za-z0-9-]`0,62`[_.A-Za-z0-9])?` regular expression.
         # The length of `[CONFIG_NAME]` must be less than 64 characters.
         # You pick the RuntimeConfig resource name, but the server will validate that
         # the name adheres to this format. After you create the resource, you cannot

generated/google/apis/servicecontrol_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/service-control/
     module ServicecontrolV1
       VERSION = 'V1'
-      REVISION = '20171007'
+      REVISION = '20171218'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/servicecontrol_v1/classes.rb

@@ -357,6 +357,15 @@ module Google
         # @return [String]
         attr_accessor :detail
       
+        # Subject to whom this error applies. See the specific code enum for more
+        # details on this field. For example:
+        # - “project:<project-id or project-number>”
+        # - “folder:<folder-id>”
+        # - “organization:<organization-id>”
+        # Corresponds to the JSON property `subject`
+        # @return [String]
+        attr_accessor :subject
+      
         def initialize(**args)
            update!(**args)
         end
@@ -365,6 +374,7 @@ module Google
         def update!(**args)
           @code = args[:code] if args.key?(:code)
           @detail = args[:detail] if args.key?(:detail)
+          @subject = args[:subject] if args.key?(:subject)
         end
       end
       

generated/google/apis/servicecontrol_v1/representations.rb

@@ -319,6 +319,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :code, as: 'code'
           property :detail, as: 'detail'
+          property :subject, as: 'subject'
         end
       end
       

generated/google/apis/storage_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/storage/docs/json_api/
     module StorageV1
       VERSION = 'V1'
-      REVISION = '20171018'
+      REVISION = '20171212'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/storage_v1/classes.rb

@@ -41,6 +41,21 @@ module Google
         # @return [Array<Google::Apis::StorageV1::Bucket::CorsConfiguration>]
         attr_accessor :cors_configurations
       
+        # Defines the default value for Event-Based hold on newly created objects in
+        # this bucket. Event-Based hold is a way to retain objects indefinitely until an
+        # event occurs, signified by the hold's release. After being released, such
+        # objects will be subject to bucket-level retention (if any). One sample use
+        # case of this flag is for banks to hold loan documents for at least 3 years
+        # after loan is paid in full. Here bucket-level retention is 3 years and the
+        # event is loan being paid in full. In this example these objects will be held
+        # intact for any number of years until the event has occurred (hold is released)
+        # and then 3 more years after that. Objects under Event-Based hold cannot be
+        # deleted, overwritten or archived until the hold is removed.
+        # Corresponds to the JSON property `defaultEventBasedHold`
+        # @return [Boolean]
+        attr_accessor :default_event_based_hold
+        alias_method :default_event_based_hold?, :default_event_based_hold
+      
         # Default access controls to apply to new objects when no ACL is provided.
         # Corresponds to the JSON property `defaultObjectAcl`
         # @return [Array<Google::Apis::StorageV1::ObjectAccessControl>]
@@ -57,7 +72,7 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # The ID of the bucket. For buckets, the id and name properities are the same.
+        # The ID of the bucket. For buckets, the id and name properties are the same.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -111,6 +126,19 @@ module Google
         # @return [Fixnum]
         attr_accessor :project_number
       
+        # Defines the retention policy for a bucket. The Retention policy enforces a
+        # minimum retention time for all objects contained in the bucket, based on their
+        # creation time. Any attempt to overwrite or delete objects younger than the
+        # retention period will result in a PERMISSION_DENIED error. An unlocked
+        # retention policy can be modified or removed from the bucket via the
+        # UpdateBucketMetadata RPC. A locked retention policy cannot be removed or
+        # shortened in duration for the lifetime of the bucket. Attempting to remove or
+        # decrease period of a locked retention policy will result in a
+        # PERMISSION_DENIED error.
+        # Corresponds to the JSON property `retentionPolicy`
+        # @return [Google::Apis::StorageV1::Bucket::RetentionPolicy]
+        attr_accessor :retention_policy
+      
         # The URI of this bucket.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
@@ -157,6 +185,7 @@ module Google
           @acl = args[:acl] if args.key?(:acl)
           @billing = args[:billing] if args.key?(:billing)
           @cors_configurations = args[:cors_configurations] if args.key?(:cors_configurations)
+          @default_event_based_hold = args[:default_event_based_hold] if args.key?(:default_event_based_hold)
           @default_object_acl = args[:default_object_acl] if args.key?(:default_object_acl)
           @encryption = args[:encryption] if args.key?(:encryption)
           @etag = args[:etag] if args.key?(:etag)
@@ -170,6 +199,7 @@ module Google
           @name = args[:name] if args.key?(:name)
           @owner = args[:owner] if args.key?(:owner)
           @project_number = args[:project_number] if args.key?(:project_number)
+          @retention_policy = args[:retention_policy] if args.key?(:retention_policy)
           @self_link = args[:self_link] if args.key?(:self_link)
           @storage_class = args[:storage_class] if args.key?(:storage_class)
           @time_created = args[:time_created] if args.key?(:time_created)
@@ -182,7 +212,7 @@ module Google
         class Billing
           include Google::Apis::Core::Hashable
         
-          # When set to true, bucket is requester pays.
+          # When set to true, Requester Pays is enabled for this bucket.
           # Corresponds to the JSON property `requesterPays`
           # @return [Boolean]
           attr_accessor :requester_pays
@@ -245,7 +275,9 @@ module Google
         class Encryption
           include Google::Apis::Core::Hashable
         
-          # 
+          # A Cloud KMS key that will be used to encrypt objects inserted into this bucket,
+          # if no encryption method is specified. Limited availability; usable only by
+          # enabled projects.
           # Corresponds to the JSON property `defaultKmsKeyName`
           # @return [String]
           attr_accessor :default_kms_key_name
@@ -434,6 +466,49 @@ module Google
           end
         end
         
+        # Defines the retention policy for a bucket. The Retention policy enforces a
+        # minimum retention time for all objects contained in the bucket, based on their
+        # creation time. Any attempt to overwrite or delete objects younger than the
+        # retention period will result in a PERMISSION_DENIED error. An unlocked
+        # retention policy can be modified or removed from the bucket via the
+        # UpdateBucketMetadata RPC. A locked retention policy cannot be removed or
+        # shortened in duration for the lifetime of the bucket. Attempting to remove or
+        # decrease period of a locked retention policy will result in a
+        # PERMISSION_DENIED error.
+        class RetentionPolicy
+          include Google::Apis::Core::Hashable
+        
+          # The time from which policy was enforced and effective. RFC 3339 format.
+          # Corresponds to the JSON property `effectiveTime`
+          # @return [DateTime]
+          attr_accessor :effective_time
+        
+          # Once locked, an object retention policy cannot be modified.
+          # Corresponds to the JSON property `isLocked`
+          # @return [Boolean]
+          attr_accessor :is_locked
+          alias_method :is_locked?, :is_locked
+        
+          # Specifies the duration that objects need to be retained. Retention duration
+          # must be greater than zero and less than 100 years. Note that enforcement of
+          # retention periods less than a day is not guaranteed. Such periods should only
+          # be used for testing purposes.
+          # Corresponds to the JSON property `retentionPeriod`
+          # @return [Fixnum]
+          attr_accessor :retention_period
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @effective_time = args[:effective_time] if args.key?(:effective_time)
+            @is_locked = args[:is_locked] if args.key?(:is_locked)
+            @retention_period = args[:retention_period] if args.key?(:retention_period)
+          end
+        end
+        
         # The bucket's versioning configuration.
         class Versioning
           include Google::Apis::Core::Hashable
@@ -987,6 +1062,19 @@ module Google
         # @return [String]
         attr_accessor :etag
       
+        # Defines the Event-Based hold for an object. Event-Based hold is a way to
+        # retain objects indefinitely until an event occurs, signified by the hold's
+        # release. After being released, such objects will be subject to bucket-level
+        # retention (if any). One sample use case of this flag is for banks to hold loan
+        # documents for at least 3 years after loan is paid in full. Here bucket-level
+        # retention is 3 years and the event is loan being paid in full. In this example
+        # these objects will be held intact for any number of years until the event has
+        # occurred (hold is released) and then 3 more years after that.
+        # Corresponds to the JSON property `eventBasedHold`
+        # @return [Boolean]
+        attr_accessor :event_based_hold
+        alias_method :event_based_hold?, :event_based_hold
+      
         # The content generation of this object. Used for object versioning.
         # Corresponds to the JSON property `generation`
         # @return [Fixnum]
@@ -1004,7 +1092,7 @@ module Google
         attr_accessor :kind
       
         # Cloud KMS Key used to encrypt this object, if the object is encrypted by such
-        # a key.
+        # a key. Limited availability; usable only by enabled projects.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
@@ -1043,6 +1131,16 @@ module Google
         # @return [Google::Apis::StorageV1::Object::Owner]
         attr_accessor :owner
       
+        # Specifies the earliest time that the object's retention period expires. This
+        # value is server-determined and is in RFC 3339 format. Note 1: This field is
+        # not provided for objects with an active Event-Based hold, since retention
+        # expiration is unknown until the hold is removed. Note 2: This value can be
+        # provided even when TemporaryHold is set (so that the user can reason about
+        # policy without having to first unset the TemporaryHold).
+        # Corresponds to the JSON property `retentionExpirationTime`
+        # @return [DateTime]
+        attr_accessor :retention_expiration_time
+      
         # The link to this object.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
@@ -1058,6 +1156,16 @@ module Google
         # @return [String]
         attr_accessor :storage_class
       
+        # Defines the temporary hold for an object. This flag is used to enforce a
+        # temporary hold on an object. While it is set to true, the object is protected
+        # against deletion and overwrites. A common use case of this flag is regulatory
+        # investigations where objects need to be retained while the investigation is
+        # ongoing.
+        # Corresponds to the JSON property `temporaryHold`
+        # @return [Boolean]
+        attr_accessor :temporary_hold
+        alias_method :temporary_hold?, :temporary_hold
+      
         # The creation time of the object in RFC 3339 format.
         # Corresponds to the JSON property `timeCreated`
         # @return [DateTime]
@@ -1097,6 +1205,7 @@ module Google
           @crc32c = args[:crc32c] if args.key?(:crc32c)
           @customer_encryption = args[:customer_encryption] if args.key?(:customer_encryption)
           @etag = args[:etag] if args.key?(:etag)
+          @event_based_hold = args[:event_based_hold] if args.key?(:event_based_hold)
           @generation = args[:generation] if args.key?(:generation)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
@@ -1107,9 +1216,11 @@ module Google
           @metageneration = args[:metageneration] if args.key?(:metageneration)
           @name = args[:name] if args.key?(:name)
           @owner = args[:owner] if args.key?(:owner)
+          @retention_expiration_time = args[:retention_expiration_time] if args.key?(:retention_expiration_time)
           @self_link = args[:self_link] if args.key?(:self_link)
           @size = args[:size] if args.key?(:size)
           @storage_class = args[:storage_class] if args.key?(:storage_class)
+          @temporary_hold = args[:temporary_hold] if args.key?(:temporary_hold)
           @time_created = args[:time_created] if args.key?(:time_created)
           @time_deleted = args[:time_deleted] if args.key?(:time_deleted)
           @time_storage_class_updated = args[:time_storage_class_updated] if args.key?(:time_storage_class_updated)

generated/google/apis/storage_v1/representations.rb

@@ -79,6 +79,12 @@ module Google
           include Google::Apis::Core::JsonObjectSupport
         end
         
+        class RetentionPolicy
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+        
         class Versioning
           class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -235,6 +241,7 @@ module Google
       
           collection :cors_configurations, as: 'cors', class: Google::Apis::StorageV1::Bucket::CorsConfiguration, decorator: Google::Apis::StorageV1::Bucket::CorsConfiguration::Representation
       
+          property :default_event_based_hold, as: 'defaultEventBasedHold'
           collection :default_object_acl, as: 'defaultObjectAcl', class: Google::Apis::StorageV1::ObjectAccessControl, decorator: Google::Apis::StorageV1::ObjectAccessControl::Representation
       
           property :encryption, as: 'encryption', class: Google::Apis::StorageV1::Bucket::Encryption, decorator: Google::Apis::StorageV1::Bucket::Encryption::Representation
@@ -253,6 +260,8 @@ module Google
           property :owner, as: 'owner', class: Google::Apis::StorageV1::Bucket::Owner, decorator: Google::Apis::StorageV1::Bucket::Owner::Representation
       
           property :project_number, :numeric_string => true, as: 'projectNumber'
+          property :retention_policy, as: 'retentionPolicy', class: Google::Apis::StorageV1::Bucket::RetentionPolicy, decorator: Google::Apis::StorageV1::Bucket::RetentionPolicy::Representation
+      
           property :self_link, as: 'selfLink'
           property :storage_class, as: 'storageClass'
           property :time_created, as: 'timeCreated', type: DateTime
@@ -343,6 +352,16 @@ module Google
           end
         end
         
+        class RetentionPolicy
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :effective_time, as: 'effectiveTime', type: DateTime
+        
+            property :is_locked, as: 'isLocked'
+            property :retention_period, :numeric_string => true, as: 'retentionPeriod'
+          end
+        end
+        
         class Versioning
           # @private
           class Representation < Google::Apis::Core::JsonRepresentation
@@ -488,6 +507,7 @@ module Google
           property :customer_encryption, as: 'customerEncryption', class: Google::Apis::StorageV1::Object::CustomerEncryption, decorator: Google::Apis::StorageV1::Object::CustomerEncryption::Representation
       
           property :etag, as: 'etag'
+          property :event_based_hold, as: 'eventBasedHold'
           property :generation, :numeric_string => true, as: 'generation'
           property :id, as: 'id'
           property :kind, as: 'kind'
@@ -499,9 +519,12 @@ module Google
           property :name, as: 'name'
           property :owner, as: 'owner', class: Google::Apis::StorageV1::Object::Owner, decorator: Google::Apis::StorageV1::Object::Owner::Representation
       
+          property :retention_expiration_time, as: 'retentionExpirationTime', type: DateTime
+      
           property :self_link, as: 'selfLink'
           property :size, :numeric_string => true, as: 'size'
           property :storage_class, as: 'storageClass'
+          property :temporary_hold, as: 'temporaryHold'
           property :time_created, as: 'timeCreated', type: DateTime
       
           property :time_deleted, as: 'timeDeleted', type: DateTime

generated/google/apis/storage_v1/service.rb

@@ -539,6 +539,48 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Locks retention policy on a bucket.
+        # @param [String] bucket
+        #   Name of a bucket.
+        # @param [Fixnum] if_metageneration_match
+        #   Makes the operation conditional on whether bucket's current metageneration
+        #   matches the given value.
+        # @param [String] user_project
+        #   The project to be billed for this request. Required for Requester Pays buckets.
+        # @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::StorageV1::Bucket] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StorageV1::Bucket]
+        #
+        # @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 lock_bucket_retention_policy(bucket, if_metageneration_match, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'b/{bucket}/lockRetentionPolicy', options)
+          command.response_representation = Google::Apis::StorageV1::Bucket::Representation
+          command.response_class = Google::Apis::StorageV1::Bucket
+          command.params['bucket'] = bucket unless bucket.nil?
+          command.query['ifMetagenerationMatch'] = if_metageneration_match unless if_metageneration_match.nil?
+          command.query['userProject'] = user_project unless user_project.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
+        
         # Updates a bucket. Changes to the bucket will be readable immediately after
         # writing, but configuration changes may take time to propagate. This method
         # supports patch semantics.
@@ -1871,7 +1913,8 @@ module Google
         # @param [String] kms_key_name
         #   Resource name of the Cloud KMS key, of the form projects/my-project/locations/
         #   global/keyRings/my-kr/cryptoKeys/my-key, that will be used to encrypt the
-        #   object. Overrides the object metadata's kms_key_name value, if any.
+        #   object. Overrides the object metadata's kms_key_name value, if any. Limited
+        #   availability; usable only by enabled projects.
         # @param [String] name
         #   Name of the object. Required when the object metadata is not otherwise
         #   provided. Overrides the object metadata's name value, if any. For information

generated/google/apis/tpu_v1alpha1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/tpu/
     module TpuV1alpha1
       VERSION = 'V1alpha1'
-      REVISION = '20171121'
+      REVISION = '20171218'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/tpu_v1alpha1/classes.rb

@@ -203,8 +203,8 @@ module Google
         # @return [String]
         attr_accessor :cidr_block
       
-        # The time when the node was created.
         # Output only.
+        # The time when the node was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -214,9 +214,14 @@ module Google
         # @return [String]
         attr_accessor :description
       
+        # The health status of the TPU node.
+        # Corresponds to the JSON property `health`
+        # @return [String]
+        attr_accessor :health
+      
+        # Output only.
         # If this field is populated, it contains a description of why the TPU Node
         # is unhealthy.
-        # Output only.
         # Corresponds to the JSON property `healthDescription`
         # @return [String]
         attr_accessor :health_description
@@ -228,6 +233,7 @@ module Google
         # @return [String]
         attr_accessor :ip_address
       
+        # Output only.
         # The immutable name of the TPU
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -255,17 +261,17 @@ module Google
         # @return [String]
         attr_accessor :port
       
+        # Output only.
         # The service account used to run the tensor flow services within the node.
         # To share resources, including Google Cloud Storage data, with the
         # Tensorflow job running in the Node, this account must have permissions to
         # that data.
-        # Output only.
         # Corresponds to the JSON property `serviceAccount`
         # @return [String]
         attr_accessor :service_account
       
-        # The current state for the TPU Node.
         # Output only.
+        # The current state for the TPU Node.
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -286,6 +292,7 @@ module Google
           @cidr_block = args[:cidr_block] if args.key?(:cidr_block)
           @create_time = args[:create_time] if args.key?(:create_time)
           @description = args[:description] if args.key?(:description)
+          @health = args[:health] if args.key?(:health)
           @health_description = args[:health_description] if args.key?(:health_description)
           @ip_address = args[:ip_address] if args.key?(:ip_address)
           @name = args[:name] if args.key?(:name)

generated/google/apis/tpu_v1alpha1/representations.rb

@@ -152,6 +152,7 @@ module Google
           property :cidr_block, as: 'cidrBlock'
           property :create_time, as: 'createTime'
           property :description, as: 'description'
+          property :health, as: 'health'
           property :health_description, as: 'healthDescription'
           property :ip_address, as: 'ipAddress'
           property :name, as: 'name'

generated/google/apis/youtube_partner_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/youtube/partner/
     module YoutubePartnerV1
       VERSION = 'V1'
-      REVISION = '20171205'
+      REVISION = '20171218'
 
       # View and manage your assets and associated content on YouTube
       AUTH_YOUTUBEPARTNER = 'https://www.googleapis.com/auth/youtubepartner'