google-api-client 0.19.4 → 0.19.5

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

@@ -126,14 +126,14 @@ module Google
         # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
         # Read
         # [Overview of Queue Management and queue.yaml](/cloud-tasks/docs/queue-yaml)
-        # carefully before using this method.
+        # before using this method.
         # @param [String] parent
         #   Required.
         #   The location name in which the queue will be created.
         #   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
         #   The list of allowed locations can be obtained by calling Cloud
         #   Tasks' implementation of
-        #   google.cloud.location.Locations.ListLocations.
+        #   ListLocations.
         # @param [Google::Apis::CloudtasksV2beta2::Queue] queue_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -172,7 +172,7 @@ module Google
         # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
         # Read
         # [Overview of Queue Management and queue.yaml](/cloud-tasks/docs/queue-yaml)
-        # carefully before using this method.
+        # before using this method.
         # @param [String] name
         #   Required.
         #   The queue name. For example:
@@ -294,17 +294,17 @@ module Google
         #   Requested page size.
         #   The maximum page size is 9800. If unspecified, the page size will
         #   be the maximum. Fewer queues than requested might be returned,
-        #   even if more queues exist; use
-        #   ListQueuesResponse.next_page_token to determine if more
-        #   queues exist.
+        #   even if more queues exist; use the
+        #   next_page_token in the
+        #   response to determine if more queues exist.
         # @param [String] page_token
         #   A token identifying the page of results to return.
         #   To request the first page results, page_token must be empty. To
         #   request the next page of results, page_token must be the value of
-        #   ListQueuesResponse.next_page_token returned from the previous
-        #   call to CloudTasks.ListQueues method. It is an error to
-        #   switch the value of ListQueuesRequest.filter while iterating
-        #   through pages.
+        #   next_page_token returned
+        #   from the previous call to ListQueues
+        #   method. It is an error to switch the value of the
+        #   filter while iterating through pages.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -346,7 +346,7 @@ module Google
         # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
         # Read
         # [Overview of Queue Management and queue.yaml](/cloud-tasks/docs/queue-yaml)
-        # carefully before using this method.
+        # before using this method.
         # @param [String] name
         #   The queue name.
         #   The queue name must have the following format:
@@ -358,12 +358,12 @@ module Google
         #   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.
+        #   ListLocations.
         #   For more information, see https://cloud.google.com/about/locations/.
         #   * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
         #   hyphens (-). The maximum length is 100 characters.
-        #   Caller-specified and required in CreateQueueRequest, after which
-        #   it becomes output only.
+        #   Caller-specified and required in CreateQueue,
+        #   after which it becomes output only.
         # @param [Google::Apis::CloudtasksV2beta2::Queue] queue_object
         # @param [String] update_mask
         #   A mask used to specify which fields of the queue are being updated.
@@ -399,12 +399,11 @@ module Google
         end
         
         # Pauses the queue.
-        # If a queue is paused then the system will stop executing the
-        # tasks in the queue until it is resumed via
-        # CloudTasks.ResumeQueue. Tasks can still be added when the
-        # queue is paused. The state of the queue is stored in
-        # Queue.state; if paused it will be set to
-        # Queue.State.PAUSED.
+        # If a queue is paused then the system will stop dispatching tasks
+        # until the queue is resumed via
+        # ResumeQueue. Tasks can still be added
+        # when the queue is paused. A queue is paused if its
+        # state is PAUSED.
         # @param [String] name
         #   Required.
         #   The queue name. For example:
@@ -479,9 +478,10 @@ module Google
         
         # Resume a queue.
         # This method resumes a queue after it has been
-        # Queue.State.PAUSED or Queue.State.DISABLED. The state of
-        # a queue is stored in Queue.state; after calling this method it
-        # will be set to Queue.State.RUNNING.
+        # PAUSED or
+        # DISABLED. The state of a queue is stored
+        # in the queue's state; after calling this method it
+        # will be set to RUNNING.
         # WARNING: Resuming many high-QPS queues at the same time can
         # lead to target overloading. If you are resuming high-QPS
         # queues, follow the 500/50/5 pattern described in
@@ -563,7 +563,7 @@ module Google
         
         # Returns permissions that a caller has on a Queue.
         # If the resource does not exist, this will return an empty set of
-        # permissions, not a google.rpc.Code.NOT_FOUND error.
+        # permissions, not a NOT_FOUND error.
         # Note: This operation is designed to be used for building permission-aware
         # UIs and command-line tools, not for authorization checking. This operation
         # may "fail open" without warning.
@@ -601,15 +601,16 @@ module Google
         end
         
         # Acknowledges a pull task.
-        # The worker, that is, the entity that received this task in
-        # a LeaseTasksResponse, must call this method to indicate that
-        # the work associated with the task has finished.
+        # The worker, that is, the entity that
+        # leased this task must call this method
+        # to indicate that the work associated with the task has finished.
         # The worker must acknowledge a task within the
-        # LeaseTasksRequest.lease_duration or the lease will expire and
-        # the task will become ready to be returned in a different
-        # LeaseTasksResponse. After the task is acknowledged, it will
-        # not be returned by a later CloudTasks.LeaseTasks,
-        # CloudTasks.GetTask, or CloudTasks.ListTasks.
+        # lease_duration or the lease
+        # will expire and the task will become available to be leased
+        # again. After the task is acknowledged, it will not be returned
+        # by a later LeaseTasks,
+        # GetTask, or
+        # ListTasks.
         # To acknowledge multiple tasks at the same time, use
         # [HTTP batching](/storage/docs/json_api/v1/how-tos/batch)
         # or the batching documentation for your client library, for example
@@ -649,9 +650,10 @@ module Google
         end
         
         # Cancel a pull task's lease.
-        # The worker can use this method to cancel a task's lease
-        # by setting Task.schedule_time to now. This will make the task
-        # available to be leased to the next caller of CloudTasks.LeaseTasks.
+        # The worker can use this method to cancel a task's lease by
+        # setting its schedule_time to now. This will
+        # make the task available to be leased to the next caller of
+        # LeaseTasks.
         # @param [String] name
         #   Required.
         #   The task name. For example:
@@ -774,14 +776,14 @@ module Google
         # @param [String] response_view
         #   The response_view specifies which subset of the Task will be
         #   returned.
-        #   By default response_view is Task.View.BASIC; not all
+        #   By default response_view is BASIC; not all
         #   information is retrieved by default because some data, such as
         #   payloads, might be desirable to return only when needed because
         #   of its large size or because of the sensitivity of data that it
         #   contains.
-        #   Authorization for Task.View.FULL requires `cloudtasks.tasks.fullView`
-        #   [Google IAM](/iam/) permission on the
-        #   Task.name resource.
+        #   Authorization for FULL requires
+        #   `cloudtasks.tasks.fullView` [Google IAM](/iam/) permission on the
+        #   Task resource.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -810,19 +812,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Leases tasks from a pull queue for LeaseTasksRequest.lease_duration.
-        # This method is invoked by the worker to obtain a
-        # lease. The worker must acknowledge the task via
-        # CloudTasks.AcknowledgeTask after they have performed the work
-        # associated with the task.
-        # The payload is intended to store data that the worker needs
-        # to perform the work associated with the task. To return the
-        # payloads in the LeaseTasksResponse, set
-        # LeaseTasksRequest.response_view to Task.View.FULL.
-        # A maximum of 10 qps of CloudTasks.LeaseTasks requests are allowed per
-        # queue. google.rpc.Code.RESOURCE_EXHAUSTED is returned when this limit
-        # is exceeded. google.rpc.Code.RESOURCE_EXHAUSTED is also returned when
-        # RateLimits.max_tasks_dispatched_per_second is exceeded.
+        # Leases tasks from a pull queue for
+        # lease_duration.
+        # This method is invoked by the worker to obtain a lease. The
+        # worker must acknowledge the task via
+        # AcknowledgeTask after they have
+        # performed the work associated with the task.
+        # The payload is intended to store data that
+        # the worker needs to perform the work associated with the task. To
+        # return the payloads in the response, set
+        # response_view to
+        # FULL.
+        # A maximum of 10 qps of LeaseTasks
+        # requests are allowed per
+        # queue. RESOURCE_EXHAUSTED
+        # is returned when this limit is
+        # exceeded. RESOURCE_EXHAUSTED
+        # is also returned when
+        # max_tasks_dispatched_per_second
+        # is exceeded.
         # @param [String] parent
         #   Required.
         #   The queue name. For example:
@@ -858,9 +866,9 @@ module Google
         end
         
         # Lists the tasks in a queue.
-        # By default response_view is Task.View.BASIC; not all
-        # information is retrieved by default due to performance
-        # considerations; ListTasksRequest.response_view controls the
+        # By default, only the BASIC view is retrieved
+        # due to performance considerations;
+        # response_view controls the
         # subset of information which is returned.
         # @param [String] parent
         #   Required.
@@ -876,26 +884,27 @@ module Google
         #   The maximum page size is 1000. If unspecified, the page size will
         #   be the maximum. Fewer tasks than requested might be returned,
         #   even if more tasks exist; use
-        #   ListTasksResponse.next_page_token to determine if more tasks
-        #   exist.
+        #   next_page_token in the
+        #   response to determine if more tasks exist.
         # @param [String] page_token
         #   A token identifying the page of results to return.
         #   To request the first page results, page_token must be empty. To
         #   request the next page of results, page_token must be the value of
-        #   ListTasksResponse.next_page_token returned from the previous
-        #   call to CloudTasks.ListTasks method.
+        #   next_page_token returned
+        #   from the previous call to ListTasks
+        #   method.
         #   The page token is valid for only 2 hours.
         # @param [String] response_view
         #   The response_view specifies which subset of the Task will be
         #   returned.
-        #   By default response_view is Task.View.BASIC; not all
+        #   By default response_view is BASIC; not all
         #   information is retrieved by default because some data, such as
         #   payloads, might be desirable to return only when needed because
         #   of its large size or because of the sensitivity of data that it
         #   contains.
-        #   Authorization for Task.View.FULL requires `cloudtasks.tasks.fullView`
-        #   [Google IAM](/iam/) permission on the
-        #   Task.name resource.
+        #   Authorization for FULL requires
+        #   `cloudtasks.tasks.fullView` [Google IAM](/iam/) permission on the
+        #   Task resource.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -930,7 +939,7 @@ module Google
         # Renew the current lease of a pull task.
         # The worker can use this method to extend the lease by a new
         # duration, starting from now. The new task lease will be
-        # returned in Task.schedule_time.
+        # returned in the task's schedule_time.
         # @param [String] name
         #   Required.
         #   The task name. For example:
@@ -967,25 +976,27 @@ module Google
         
         # Forces a task to run now.
         # This command is meant to be used for manual debugging. For
-        # example, CloudTasks.RunTask can be used to retry a failed
+        # example, RunTask can be used to retry a failed
         # task after a fix has been made or to manually force a task to be
         # dispatched now.
         # When this method is called, Cloud Tasks will dispatch the task to its
-        # target, even if the queue is Queue.State.PAUSED.
+        # target, even if the queue is PAUSED.
         # The dispatched task is returned. That is, the task that is returned
-        # contains the Task.status after the task is dispatched but
+        # contains the status after the task is dispatched but
         # before the task is received by its target.
         # If Cloud Tasks receives a successful response from the task's
         # handler, then the task will be deleted; otherwise the task's
-        # Task.schedule_time will be reset to the time that
-        # CloudTasks.RunTask was called plus the retry delay specified
+        # schedule_time will be reset to the time that
+        # RunTask was called plus the retry delay specified
         # in the queue and task's RetryConfig.
-        # CloudTasks.RunTask returns google.rpc.Code.NOT_FOUND when
-        # it is called on a task that has already succeeded or permanently
-        # failed. google.rpc.Code.FAILED_PRECONDITION is returned when
-        # CloudTasks.RunTask is called on task that is dispatched or
-        # already running.
-        # CloudTasks.RunTask cannot be called on pull tasks.
+        # RunTask returns
+        # NOT_FOUND when it is called on a
+        # task that has already succeeded or permanently
+        # failed. FAILED_PRECONDITION
+        # is returned when RunTask is called on task
+        # that is dispatched or already running.
+        # RunTask cannot be called on
+        # pull tasks.
         # @param [String] name
         #   Required.
         #   The task name. For example:

data/generated/google/apis/content_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/shopping-content
     module ContentV2
       VERSION = 'V2'
-      REVISION = '20180111'
+      REVISION = '20180122'
 
       # Manage your product listings and accounts for Google Shopping
       AUTH_CONTENT = 'https://www.googleapis.com/auth/content'

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

@@ -1865,6 +1865,12 @@ module Google
       class DeliveryTime
         include Google::Apis::Core::Hashable
       
+        # Holiday cutoff definitions. If configured, they specify order cutoff times for
+        # holiday-specific shipping.
+        # Corresponds to the JSON property `holidayCutoffs`
+        # @return [Array<Google::Apis::ContentV2::HolidayCutoff>]
+        attr_accessor :holiday_cutoffs
+      
         # Maximum number of business days that is spent in transit. 0 means same day
         # delivery, 1 means next day delivery. Must be greater than or equal to
         # minTransitTimeInDays. Required.
@@ -1884,6 +1890,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @holiday_cutoffs = args[:holiday_cutoffs] if args.key?(:holiday_cutoffs)
           @max_transit_time_in_days = args[:max_transit_time_in_days] if args.key?(:max_transit_time_in_days)
           @min_transit_time_in_days = args[:min_transit_time_in_days] if args.key?(:min_transit_time_in_days)
         end
@@ -2010,6 +2017,110 @@ module Google
         end
       end
       
+      # 
+      class HolidayCutoff
+        include Google::Apis::Core::Hashable
+      
+        # Date of the order deadline, in ISO 8601 format. E.g. "2016-11-29" for 29th
+        # November 2016. Required.
+        # Corresponds to the JSON property `deadlineDate`
+        # @return [String]
+        attr_accessor :deadline_date
+      
+        # Hour of the day on the deadline date until which the order has to be placed to
+        # qualify for the delivery guarantee. Possible values are: 0 (midnight), 1, ...,
+        # 12 (noon), 13, ..., 23. Required.
+        # Corresponds to the JSON property `deadlineHour`
+        # @return [Fixnum]
+        attr_accessor :deadline_hour
+      
+        # Timezone identifier for the deadline hour. A list of identifiers can be found
+        # in  the AdWords API documentation. E.g. "Europe/Zurich". Required.
+        # Corresponds to the JSON property `deadlineTimezone`
+        # @return [String]
+        attr_accessor :deadline_timezone
+      
+        # Unique identifier for the holiday. Required.
+        # Corresponds to the JSON property `holidayId`
+        # @return [String]
+        attr_accessor :holiday_id
+      
+        # Date on which the deadline will become visible to consumers in ISO 8601 format.
+        # E.g. "2016-10-31" for 31st October 2016. Required.
+        # Corresponds to the JSON property `visibleFromDate`
+        # @return [String]
+        attr_accessor :visible_from_date
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @deadline_date = args[:deadline_date] if args.key?(:deadline_date)
+          @deadline_hour = args[:deadline_hour] if args.key?(:deadline_hour)
+          @deadline_timezone = args[:deadline_timezone] if args.key?(:deadline_timezone)
+          @holiday_id = args[:holiday_id] if args.key?(:holiday_id)
+          @visible_from_date = args[:visible_from_date] if args.key?(:visible_from_date)
+        end
+      end
+      
+      # 
+      class HolidaysHoliday
+        include Google::Apis::Core::Hashable
+      
+        # The CLDR territory code of the country in which the holiday is available. E.g.
+        # "US", "DE", "GB". A holiday cutoff can only be configured in a shipping
+        # settings service with matching delivery country. Always present.
+        # Corresponds to the JSON property `countryCode`
+        # @return [String]
+        attr_accessor :country_code
+      
+        # Date of the holiday, in ISO 8601 format. E.g. "2016-12-25" for Christmas 2016.
+        # Always present.
+        # Corresponds to the JSON property `date`
+        # @return [String]
+        attr_accessor :date
+      
+        # Date on which the order has to arrive at the customer's, in ISO 8601 format. E.
+        # g. "2016-12-24" for 24th December 2016. Always present.
+        # Corresponds to the JSON property `deliveryGuaranteeDate`
+        # @return [String]
+        attr_accessor :delivery_guarantee_date
+      
+        # Hour of the day in the delivery location's timezone on the guaranteed delivery
+        # date by which the order has to arrive at the customer's. Possible values are:
+        # 0 (midnight), 1, ..., 12 (noon), 13, ..., 23. Always present.
+        # Corresponds to the JSON property `deliveryGuaranteeHour`
+        # @return [Fixnum]
+        attr_accessor :delivery_guarantee_hour
+      
+        # Unique identifier for the holiday to be used when configuring holiday cutoffs.
+        # Always present.
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # The holiday type. Always present.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @country_code = args[:country_code] if args.key?(:country_code)
+          @date = args[:date] if args.key?(:date)
+          @delivery_guarantee_date = args[:delivery_guarantee_date] if args.key?(:delivery_guarantee_date)
+          @delivery_guarantee_hour = args[:delivery_guarantee_hour] if args.key?(:delivery_guarantee_hour)
+          @id = args[:id] if args.key?(:id)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # 
       class Installment
         include Google::Apis::Core::Hashable
@@ -6108,6 +6219,11 @@ module Google
         # @return [String]
         attr_accessor :google_expiration_date
       
+        # A list of all issues associated with the product.
+        # Corresponds to the JSON property `itemLevelIssues`
+        # @return [Array<Google::Apis::ContentV2::ProductStatusItemLevelIssue>]
+        attr_accessor :item_level_issues
+      
         # Identifies what kind of resource this is. Value: the fixed string "content#
         # productStatus".
         # Corresponds to the JSON property `kind`
@@ -6149,6 +6265,7 @@ module Google
           @data_quality_issues = args[:data_quality_issues] if args.key?(:data_quality_issues)
           @destination_statuses = args[:destination_statuses] if args.key?(:destination_statuses)
           @google_expiration_date = args[:google_expiration_date] if args.key?(:google_expiration_date)
+          @item_level_issues = args[:item_level_issues] if args.key?(:item_level_issues)
           @kind = args[:kind] if args.key?(:kind)
           @last_update_date = args[:last_update_date] if args.key?(:last_update_date)
           @link = args[:link] if args.key?(:link)
@@ -6223,6 +6340,12 @@ module Google
       class ProductStatusDestinationStatus
         include Google::Apis::Core::Hashable
       
+        # Whether the approval status might change due to further processing.
+        # Corresponds to the JSON property `approvalPending`
+        # @return [Boolean]
+        attr_accessor :approval_pending
+        alias_method :approval_pending?, :approval_pending
+      
         # The destination's approval status.
         # Corresponds to the JSON property `approvalStatus`
         # @return [String]
@@ -6233,8 +6356,7 @@ module Google
         # @return [String]
         attr_accessor :destination
       
-        # Whether the destination is required, excluded, selected by default or should
-        # be validated.
+        # Provided for backward compatibility only. Always set to "required".
         # Corresponds to the JSON property `intention`
         # @return [String]
         attr_accessor :intention
@@ -6245,12 +6367,56 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @approval_pending = args[:approval_pending] if args.key?(:approval_pending)
           @approval_status = args[:approval_status] if args.key?(:approval_status)
           @destination = args[:destination] if args.key?(:destination)
           @intention = args[:intention] if args.key?(:intention)
         end
       end
       
+      # 
+      class ProductStatusItemLevelIssue
+        include Google::Apis::Core::Hashable
+      
+        # The attribute's name, if the issue is caused by a single attribute.
+        # Corresponds to the JSON property `attributeName`
+        # @return [String]
+        attr_accessor :attribute_name
+      
+        # The error code of the issue.
+        # Corresponds to the JSON property `code`
+        # @return [String]
+        attr_accessor :code
+      
+        # The destination the issue applies to.
+        # Corresponds to the JSON property `destination`
+        # @return [String]
+        attr_accessor :destination
+      
+        # Whether the issue can be resolved by the merchant.
+        # Corresponds to the JSON property `resolution`
+        # @return [String]
+        attr_accessor :resolution
+      
+        # How this issue affects serving of the offer.
+        # Corresponds to the JSON property `servability`
+        # @return [String]
+        attr_accessor :servability
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attribute_name = args[:attribute_name] if args.key?(:attribute_name)
+          @code = args[:code] if args.key?(:code)
+          @destination = args[:destination] if args.key?(:destination)
+          @resolution = args[:resolution] if args.key?(:resolution)
+          @servability = args[:servability] if args.key?(:servability)
+        end
+      end
+      
       # 
       class ProductTax
         include Google::Apis::Core::Hashable
@@ -6990,6 +7156,32 @@ module Google
         end
       end
       
+      # 
+      class ShippingsettingsGetSupportedHolidaysResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of holidays applicable for delivery guarantees. May be empty.
+        # Corresponds to the JSON property `holidays`
+        # @return [Array<Google::Apis::ContentV2::HolidaysHoliday>]
+        attr_accessor :holidays
+      
+        # Identifies what kind of resource this is. Value: the fixed string "content#
+        # shippingsettingsGetSupportedHolidaysResponse".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @holidays = args[:holidays] if args.key?(:holidays)
+          @kind = args[:kind] if args.key?(:kind)
+        end
+      end
+      
       # 
       class ShippingsettingsListResponse
         include Google::Apis::Core::Hashable