google-api-client 0.19.2 → 0.19.3

data/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 = '20171217'
+      REVISION = '20180107'
 
       # Manage your calendars
       AUTH_CALENDAR = 'https://www.googleapis.com/auth/calendar'

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

@@ -621,7 +621,7 @@ module Google
         # Can be used by developers to keep track of conferences, should not be
         # displayed to users.
         # Values for solution types:
-        # - "eventHangout": unset
+        # - "eventHangout": unset.
         # - "eventNamedHangout": the name of the Hangout.
         # - "hangoutsMeet": the 10-letter meeting code, for example "aaa-bbbb-ccc".
         # Optional.
@@ -630,7 +630,7 @@ module Google
         attr_accessor :conference_id
       
         # The conference solution, such as Hangouts or Hangouts Meet.
-        # Unset for a conference with failed create request.
+        # Unset for a conference with a failed create request.
         # Either conferenceSolution and at least one entryPoint, or createRequest is
         # required.
         # Corresponds to the JSON property `conferenceSolution`
@@ -665,7 +665,7 @@ module Google
         # 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.
-        # Unset for a conference with failed create request.
+        # Unset for a conference with a failed create request.
         # Optional for a conference with a pending create request.
         # Corresponds to the JSON property `signature`
         # @return [String]
@@ -737,7 +737,7 @@ module Google
       class ConferenceSolution
         include Google::Apis::Core::Hashable
       
-        # The user-visible icon for this solution. Read-only.
+        # The user-visible icon for this solution.
         # Corresponds to the JSON property `iconUri`
         # @return [String]
         attr_accessor :icon_uri
@@ -747,7 +747,7 @@ module Google
         # @return [Google::Apis::CalendarV3::ConferenceSolutionKey]
         attr_accessor :key
       
-        # The user-visible name of this solution. Not localized. Read-only.
+        # The user-visible name of this solution. Not localized.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -773,7 +773,7 @@ module Google
         # display the entry points. However, it should disallow modifications.
         # The possible values are:
         # - "eventHangout" for Hangouts for consumers (http://hangouts.google.com)
-        # - "eventNamedHangout" for Classic Hangouts for GSuite users (http://hangouts.
+        # - "eventNamedHangout" for classic Hangouts for G Suite users (http://hangouts.
         # google.com)
         # - "hangoutsMeet" for Hangouts Meet (http://meet.google.com)
         # Corresponds to the JSON property `type`
@@ -827,7 +827,7 @@ module Google
       class EntryPoint
         include Google::Apis::Core::Hashable
       
-        # The Access Code to access the conference. The maximum length is 128 characters.
+        # The access code to access the conference. The maximum length is 128 characters.
         # When creating new conference data, populate only the subset of `meetingCode,
         # accessCode, passcode, password, pin` fields that match the terminology that
         # the conference provider uses. Only the populated fields should be displayed.
@@ -851,19 +851,19 @@ module Google
         # @return [String]
         attr_accessor :entry_point_type
       
-        # The label for the URI.Visible to end users. Not localized. The maximum length
+        # The label for the URI. Visible to end users. Not localized. The maximum length
         # is 512 characters.
         # Examples:
         # - for video: meet.google.com/aaa-bbbb-ccc
         # - for phone: +1 123 268 2601
-        # - for sip: sip:12345678@myprovider.com
+        # - for sip: 12345678@altostrat.com
         # - for more: should not be filled
         # Optional.
         # Corresponds to the JSON property `label`
         # @return [String]
         attr_accessor :label
       
-        # The Meeting Code to access the conference. The maximum length is 128
+        # The meeting code to access the conference. The maximum length is 128
         # characters.
         # When creating new conference data, populate only the subset of `meetingCode,
         # accessCode, passcode, password, pin` fields that match the terminology that
@@ -873,7 +873,7 @@ module Google
         # @return [String]
         attr_accessor :meeting_code
       
-        # The Passcode to access the conference. The maximum length is 128 characters.
+        # The passcode to access the conference. The maximum length is 128 characters.
         # When creating new conference data, populate only the subset of `meetingCode,
         # accessCode, passcode, password, pin` fields that match the terminology that
         # the conference provider uses. Only the populated fields should be displayed.
@@ -881,7 +881,7 @@ module Google
         # @return [String]
         attr_accessor :passcode
       
-        # The Password to access the conference. The maximum length is 128 characters.
+        # The password to access the conference. The maximum length is 128 characters.
         # When creating new conference data, populate only the subset of `meetingCode,
         # accessCode, passcode, password, pin` fields that match the terminology that
         # the conference provider uses. Only the populated fields should be displayed.
@@ -899,7 +899,7 @@ module Google
         # @return [String]
         attr_accessor :pin
       
-        # The "URI" of the entry point. The maximum length is 1300 characters.
+        # The URI of the entry point. The maximum length is 1300 characters.
         # Format:
         # - for video, http: or https: schema is required.
         # - for phone, tel: schema is required. The URI should include the entire dial

data/generated/google/apis/cloudbilling_v1.rb

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

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

@@ -119,8 +119,9 @@ module Google
         end
         
         # Lists the projects associated with a billing account. The current
-        # authenticated user must be an [owner of the billing
-        # account](https://support.google.com/cloud/answer/4430947).
+        # authenticated user must have the "billing.resourceAssociations.list" IAM
+        # permission, which is often given to billing account
+        # [viewers](https://support.google.com/cloud/answer/4430947).
         # @param [String] name
         #   The resource name of the billing account associated with the projects that
         #   you want to list. For example, `billingAccounts/012345-567890-ABCDEF`.
@@ -300,9 +301,10 @@ module Google
         # @param [String] end_time
         #   Optional exclusive end time of the time range for which the pricing
         #   versions will be returned. Timestamps in the future are not allowed.
-        #   Maximum allowable time range is 1 month (31 days). Time range as a whole
-        #   is optional. If not specified, the latest pricing will be returned (up to
-        #   12 hours old at most).
+        #   The time range has to be within a single calendar month in
+        #   America/Los_Angeles timezone. Time range as a whole is optional. If not
+        #   specified, the latest pricing will be returned (up to 12 hours old at
+        #   most).
         # @param [Fixnum] page_size
         #   Requested page size. Defaults to 5000.
         # @param [String] page_token
@@ -312,9 +314,10 @@ module Google
         # @param [String] start_time
         #   Optional inclusive start time of the time range for which the pricing
         #   versions will be returned. Timestamps in the future are not allowed.
-        #   Maximum allowable time range is 1 month (31 days). Time range as a whole
-        #   is optional. If not specified, the latest pricing will be returned (up to
-        #   12 hours old at most).
+        #   The time range has to be within a single calendar month in
+        #   America/Los_Angeles timezone. Time range as a whole is optional. If not
+        #   specified, the latest pricing will be returned (up to 12 hours old at
+        #   most).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/clouddebugger_v2.rb

@@ -26,12 +26,12 @@ module Google
     # @see http://cloud.google.com/debugger
     module ClouddebuggerV2
       VERSION = 'V2'
-      REVISION = '20170809'
+      REVISION = '20180112'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
 
-      # Manage cloud debugger
+      # Use Stackdriver Debugger
       AUTH_CLOUD_DEBUGGER = 'https://www.googleapis.com/auth/cloud_debugger'
     end
   end

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

@@ -310,7 +310,6 @@ module Google
       
         # References to the locations and revisions of the source code used in the
         # deployed application.
-        # NOTE: this field is experimental and can be ignored.
         # Corresponds to the JSON property `extSourceContexts`
         # @return [Array<Google::Apis::ClouddebuggerV2::ExtendedSourceContext>]
         attr_accessor :ext_source_contexts

data/generated/google/apis/cloudkms_v1.rb

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

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

@@ -705,7 +705,7 @@ module Google
       # ]
       # `
       # For a description of IAM and its features, see the
-      # [IAM developer's guide](https://cloud.google.com/iam).
+      # [IAM developer's guide](https://cloud.google.com/iam/docs).
       class Policy
         include Google::Apis::Core::Hashable
       
@@ -740,7 +740,7 @@ module Google
         attr_accessor :iam_owned
         alias_method :iam_owned?, :iam_owned
       
-        # Version of the `Policy`. The default version is 0.
+        # Deprecated.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -801,7 +801,7 @@ module Google
         # ]
         # `
         # For a description of IAM and its features, see the
-        # [IAM developer's guide](https://cloud.google.com/iam).
+        # [IAM developer's guide](https://cloud.google.com/iam/docs).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::CloudkmsV1::Policy]
         attr_accessor :policy

data/generated/google/apis/cloudtasks_v2beta2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/cloud-tasks/
     module CloudtasksV2beta2
       VERSION = 'V2beta2'
-      REVISION = '20180104'
+      REVISION = '20180113'
 
       # 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_v2beta2/classes.rb

@@ -551,7 +551,7 @@ module Google
         end
       end
       
-      # Request message for pulling tasks using CloudTasks.LeaseTasks.
+      # Request message for leasing tasks using CloudTasks.LeaseTasks.
       class LeaseTasksRequest
         include Google::Apis::Core::Hashable
       
@@ -964,7 +964,7 @@ module Google
         # python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue)
         # .
         # Purge time will be truncated to the nearest microsecond. Purge
-        # time will be zero if the queue has never been purged.
+        # time will be unset if the queue has never been purged.
         # Corresponds to the JSON property `purgeTime`
         # @return [String]
         attr_accessor :purge_time
@@ -985,7 +985,7 @@ module Google
         # Output only. The state of the queue.
         # `state` can only be changed by called
         # CloudTasks.PauseQueue, CloudTasks.ResumeQueue, or uploading
-        # [queue.yaml](/appengine/docs/python/config/queueref).
+        # [queue.yaml/xml](/appengine/docs/python/config/queueref).
         # CloudTasks.UpdateQueue cannot be used to change `state`.
         # Corresponds to the JSON property `state`
         # @return [String]
@@ -1014,23 +1014,23 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Output only. The max burst size.
-        # Max burst size limits how fast the queue is processed when many
-        # tasks are in the queue and the rate is high. This field allows
-        # the queue to have a high rate so processing starts shortly after
-        # a task is enqueued, but still limits resource usage when many
-        # tasks are enqueued in a short period of time.
-        # * For App Engine queues, if
-        # RateLimits.max_tasks_dispatched_per_second is 1, this
-        # field is 10; otherwise this field is
-        # RateLimits.max_tasks_dispatched_per_second / 5.
-        # * For pull queues, this field is output only and always 10,000.
-        # Note: For App Engine queues that were created through
-        # `queue.yaml/xml`, `max_burst_size` might not have the same
-        # settings as specified above; CloudTasks.UpdateQueue can be
-        # used to set `max_burst_size` only to the values specified above.
-        # This field has the same meaning as
-        # [bucket_size in queue.yaml](/appengine/docs/standard/python/config/queueref#
-        # bucket_size).
+        # Max burst size limits how fast tasks in queue are processed when
+        # many tasks are in the queue and the rate is high. This field
+        # allows the queue to have a high rate so processing starts shortly
+        # after a task is enqueued, but still limits resource usage when
+        # many tasks are enqueued in a short period of time.
+        # The [token bucket](https://wikipedia.org/wiki/Token_Bucket)
+        # algorithm is used to control the rate of task dispatches. Each
+        # queue has a token bucket that holds tokens, up to the maximum
+        # specified by `max_burst_size`. Each time a task is dispatched, a
+        # token is removed from the bucket. Tasks will be dispatched until
+        # the queue's bucket runs out of tokens. The bucket will be
+        # continuously refilled with new tokens based on
+        # RateLimits.max_tasks_dispatched_per_second.
+        # Cloud Tasks will pick the value of `max_burst_size` when the
+        # queue is created. For App Engine queues that were created or
+        # updated using `queue.yaml/xml`, `max_burst_size` is equal to
+        # [bucket_size](/appengine/docs/standard/python/config/queueref#bucket_size).
         # Corresponds to the JSON property `maxBurstSize`
         # @return [Fixnum]
         attr_accessor :max_burst_size
@@ -1040,25 +1040,27 @@ module Google
         # reached, Cloud Tasks stops dispatching tasks until the number of
         # concurrent requests decreases.
         # The maximum allowed value is 5,000.
-        # * For App Engine queues, this field is 10 by default.
-        # * For pull queues, this field is output only and always -1, which
-        # indicates no limit.
+        # If unspecified when the queue is created, Cloud Tasks will pick the
+        # default.
+        # This field is output only for
+        # [pull queues](google.cloud.tasks.v2beta2.PullTarget).
         # This field has the same meaning as
-        # [max_concurrent_requests in queue.yaml](/appengine/docs/standard/python/config/
-        # queueref#max_concurrent_requests).
+        # [max_concurrent_requests in queue.yaml/xml](/appengine/docs/standard/python/
+        # config/queueref#max_concurrent_requests).
         # Corresponds to the JSON property `maxConcurrentTasks`
         # @return [Fixnum]
         attr_accessor :max_concurrent_tasks
       
-        # The maximum rate at which tasks are dispatched from this
-        # queue.
+        # The maximum rate at which tasks are dispatched from this queue.
         # The maximum allowed value is 500.
-        # * For App Engine queues, this field is 1 by default.
-        # * For pull queues, this field is output only and always 10,000.
+        # If unspecified when the queue is created, Cloud Tasks will pick the
+        # default.
+        # This field is output only for
+        # [pull queues](google.cloud.tasks.v2beta2.PullTarget).
         # In addition to the `max_tasks_dispatched_per_second` limit, a maximum of
-        # 10 QPS of CloudTasks.LeaseTasks requests are allowed per queue.
+        # 10 QPS of CloudTasks.LeaseTasks requests are allowed per pull queue.
         # This field has the same meaning as
-        # [rate in queue.yaml](/appengine/docs/standard/python/config/queueref#rate).
+        # [rate in queue.yaml/xml](/appengine/docs/standard/python/config/queueref#rate).
         # Corresponds to the JSON property `maxTasksDispatchedPerSecond`
         # @return [Float]
         attr_accessor :max_tasks_dispatched_per_second
@@ -1148,15 +1150,16 @@ module Google
         # @return [Fixnum]
         attr_accessor :max_attempts
       
-        # The maximum amount of time to wait before retrying a task after
-        # it fails. The default is 1 hour.
-        # * For [App Engine queues](google.cloud.tasks.v2beta2.AppEngineHttpTarget),
-        # this field is 1 hour by default.
-        # * For [pull queues](google.cloud.tasks.v2beta2.PullTarget), this field
-        # is output only and always 0.
+        # A task will be scheduled for retry between RetryConfig.min_backoff and
+        # RetryConfig.max_backoff duration after it fails, if the queue's
+        # RetryConfig specifies that the task should be retried.
+        # If unspecified when the queue is created, Cloud Tasks will pick the
+        # default.
+        # This field is output only for
+        # [pull queues](google.cloud.tasks.v2beta2.PullTarget).
         # `max_backoff` will be truncated to the nearest second.
         # This field has the same meaning as
-        # [max_backoff_seconds in queue.yaml](/appengine/docs/standard/python/config/
+        # [max_backoff_seconds in queue.yaml/xml](/appengine/docs/standard/python/config/
         # queueref#retry_parameters).
         # Corresponds to the JSON property `maxBackoff`
         # @return [String]
@@ -1175,13 +1178,13 @@ module Google
         # RetryConfig.max_backoff until the task has been attempted
         # `max_attempts` times. Thus, the requests will retry at 10s, 20s,
         # 40s, 80s, 160s, 240s, 300s, 300s, ....
-        # * For [App Engine queues](google.cloud.tasks.v2beta2.AppEngineHttpTarget),
-        # this field is 16 by default.
-        # * For [pull queues](google.cloud.tasks.v2beta2.PullTarget), this field
-        # is output only and always 0.
+        # If unspecified when the queue is created, Cloud Tasks will pick the
+        # default.
+        # This field is output only for
+        # [pull queues](google.cloud.tasks.v2beta2.PullTarget).
         # This field has the same meaning as
-        # [max_doublings in queue.yaml](/appengine/docs/standard/python/config/queueref#
-        # retry_parameters).
+        # [max_doublings in queue.yaml/xml](/appengine/docs/standard/python/config/
+        # queueref#retry_parameters).
         # Corresponds to the JSON property `maxDoublings`
         # @return [Fixnum]
         attr_accessor :max_doublings
@@ -1192,27 +1195,28 @@ module Google
         # RetryConfig.max_attempts times, no further attempts will be made and
         # the task will be deleted.
         # If zero, then the task age is unlimited.
-        # * For [App Engine queues](google.cloud.tasks.v2beta2.AppEngineHttpTarget),
-        # this field is 0 seconds by default.
-        # * For [pull queues](google.cloud.tasks.v2beta2.PullTarget), this
-        # field is output only and always 0.
+        # If unspecified when the queue is created, Cloud Tasks will pick the
+        # default.
+        # This field is output only for
+        # [pull queues](google.cloud.tasks.v2beta2.PullTarget).
         # `max_retry_duration` will be truncated to the nearest second.
         # This field has the same meaning as
-        # [task_age_limit in queue.yaml](/appengine/docs/standard/python/config/queueref#
-        # retry_parameters).
+        # [task_age_limit in queue.yaml/xml](/appengine/docs/standard/python/config/
+        # queueref#retry_parameters).
         # Corresponds to the JSON property `maxRetryDuration`
         # @return [String]
         attr_accessor :max_retry_duration
       
-        # The minimum amount of time to wait before retrying a task after
-        # it fails.
-        # * For [App Engine queues](google.cloud.tasks.v2beta2.AppEngineHttpTarget),
-        # this field is 0.1 seconds by default.
-        # * For [pull queues](google.cloud.tasks.v2beta2.PullTarget), this
-        # field is output only and always 0.
+        # A task will be scheduled for retry between RetryConfig.min_backoff and
+        # RetryConfig.max_backoff duration after it fails, if the queue's
+        # RetryConfig specifies that the task should be retried.
+        # If unspecified when the queue is created, Cloud Tasks will pick the
+        # default.
+        # This field is output only for
+        # [pull queues](google.cloud.tasks.v2beta2.PullTarget).
         # `min_backoff` will be truncated to the nearest second.
         # This field has the same meaning as
-        # [min_backoff_seconds in queue.yaml](/appengine/docs/standard/python/config/
+        # [min_backoff_seconds in queue.yaml/xml](/appengine/docs/standard/python/config/
         # queueref#retry_parameters).
         # Corresponds to the JSON property `minBackoff`
         # @return [String]

data/generated/google/apis/container_v1.rb

@@ -18,7 +18,7 @@ require 'google/apis/container_v1/representations.rb'
 
 module Google
   module Apis
-    # Google Container Engine API
+    # Google Kubernetes Engine API
     #
     # The Google Kubernetes Engine API is used for building and managing container
     # based applications, powered by the open source Kubernetes technology.
@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/container-engine/
     module ContainerV1
       VERSION = 'V1'
-      REVISION = '20171127'
+      REVISION = '20171227'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -20,7 +20,7 @@ require 'google/apis/errors'
 module Google
   module Apis
     module ContainerV1
-      # Google Container Engine API
+      # Google Kubernetes Engine API
       #
       # The Google Kubernetes Engine API is used for building and managing container
       #  based applications, powered by the open source Kubernetes technology.