google-apis-tasks_v1 0.23.0 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0001099e6adfaa98e2e37ff6783dbfe807c7de5312400f5c6fdbdf3ba32d0ef
-  data.tar.gz: e376006a1fddfd7526c51b0514e40418674b2afb3c3f6fbf646d9374aa4f28af
+  metadata.gz: b443b2074a1da2630309336bc81f8bfd22b302720fe81df523ca3766d28800ed
+  data.tar.gz: cccfee2004c2ea6108d2ccd63a883889f5f27c59b0d1a503afc6820310721c23
 SHA512:
-  metadata.gz: 83ffe5114a065b5e860054ed8db6746d3a1edde8c8ba1e10300a4c3f925a195a6d798da561880c04174d1d3760e5a7f75b9ac1d65ffcbe18024b6b209d410bf2
-  data.tar.gz: fab295d991a97dd05d8afbb9d205e6c52f97f691be0c1f88e5cd8b8f0623fa7335d7698d82254458fd553440b739a2f5c2313cead21a6cd6afbabb9c064db4bc
+  metadata.gz: e98764156709345441f934adadd629929c054a45b46b480db58afd2a0a5ecce2d2c49e6a9b471b2d048ce10f26c9cffdc616e89ea6e1516ca63403900ced9d03
+  data.tar.gz: 4aee52f2417a155652a4201f421a73b05720608bbbcd66abd615e269ae1673dd8b69b226324a9f32fb13a0bc6c44a4d2ed4c7f1a635ac3b8ad9eef35b08348c6

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-tasks_v1
 
+### v0.24.0 (2024-07-07)
+
+* Regenerated from discovery document revision 20240630
+
 ### v0.23.0 (2024-06-02)
 
 * Regenerated from discovery document revision 20240526

data/lib/google/apis/tasks_v1/classes.rb

@@ -22,17 +22,114 @@ module Google
   module Apis
     module TasksV1
       
+      # Information about the source of the task assignment (Document, Chat Space).
+      class AssignmentInfo
+        include Google::Apis::Core::Hashable
+      
+        # Information about the Drive resource where a task was assigned from (the
+        # document, sheet, etc.).
+        # Corresponds to the JSON property `driveResourceInfo`
+        # @return [Google::Apis::TasksV1::DriveResourceInfo]
+        attr_accessor :drive_resource_info
+      
+        # Output only. An absolute link to the original task in the surface of
+        # assignment (Docs, Chat spaces, etc.).
+        # Corresponds to the JSON property `linkToTask`
+        # @return [String]
+        attr_accessor :link_to_task
+      
+        # Information about the Chat Space where a task was assigned from.
+        # Corresponds to the JSON property `spaceInfo`
+        # @return [Google::Apis::TasksV1::SpaceInfo]
+        attr_accessor :space_info
+      
+        # Output only. The type of surface this assigned task originates from. Currently
+        # limited to DOCUMENT or SPACE.
+        # Corresponds to the JSON property `surfaceType`
+        # @return [String]
+        attr_accessor :surface_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @drive_resource_info = args[:drive_resource_info] if args.key?(:drive_resource_info)
+          @link_to_task = args[:link_to_task] if args.key?(:link_to_task)
+          @space_info = args[:space_info] if args.key?(:space_info)
+          @surface_type = args[:surface_type] if args.key?(:surface_type)
+        end
+      end
+      
+      # Information about the Drive resource where a task was assigned from (the
+      # document, sheet, etc.).
+      class DriveResourceInfo
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Identifier of the file in the Drive API.
+        # Corresponds to the JSON property `driveFileId`
+        # @return [String]
+        attr_accessor :drive_file_id
+      
+        # Output only. Resource key required to access files shared via a shared link.
+        # Not required for all files. See also developers.google.com/drive/api/guides/
+        # resource-keys.
+        # Corresponds to the JSON property `resourceKey`
+        # @return [String]
+        attr_accessor :resource_key
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @drive_file_id = args[:drive_file_id] if args.key?(:drive_file_id)
+          @resource_key = args[:resource_key] if args.key?(:resource_key)
+        end
+      end
+      
+      # Information about the Chat Space where a task was assigned from.
+      class SpaceInfo
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The Chat space where this task originates from. The format is "
+        # spaces/`space`".
+        # Corresponds to the JSON property `space`
+        # @return [String]
+        attr_accessor :space
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @space = args[:space] if args.key?(:space)
+        end
+      end
+      
       # 
       class Task
         include Google::Apis::Core::Hashable
       
+        # Information about the source of the task assignment (Document, Chat Space).
+        # Corresponds to the JSON property `assignmentInfo`
+        # @return [Google::Apis::TasksV1::AssignmentInfo]
+        attr_accessor :assignment_info
+      
         # Completion date of the task (as a RFC 3339 timestamp). This field is omitted
         # if the task has not been completed.
         # Corresponds to the JSON property `completed`
         # @return [String]
         attr_accessor :completed
       
-        # Flag indicating whether the task has been deleted. The default is False.
+        # Flag indicating whether the task has been deleted. For assigned tasks this
+        # field is read-only. They can only be deleted by calling tasks.delete, in which
+        # case both the assigned task and the original task (in Docs or Chat Spaces) are
+        # deleted. To delete the assigned task only, navigate to the assignment surface
+        # and unassign the task from there. The default is False.
         # Corresponds to the JSON property `deleted`
         # @return [Boolean]
         attr_accessor :deleted
@@ -74,14 +171,16 @@ module Google
         # @return [Array<Google::Apis::TasksV1::Task::Link>]
         attr_accessor :links
       
-        # Notes describing the task. Optional. Maximum length allowed: 8192 characters.
+        # Notes describing the task. Tasks assigned from Google Docs cannot have notes.
+        # Optional. Maximum length allowed: 8192 characters.
         # Corresponds to the JSON property `notes`
         # @return [String]
         attr_accessor :notes
       
         # Output only. Parent task identifier. This field is omitted if it is a top-
-        # level task. This field is read-only. Use the "move" method to move the task
-        # under a different parent or to the top level.
+        # level task. Use the "move" method to move the task under a different parent or
+        # to the top level. A parent task can never be an assigned task (from Chat
+        # Spaces, Docs). This field is read-only.
         # Corresponds to the JSON property `parent`
         # @return [String]
         attr_accessor :parent
@@ -128,6 +227,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @assignment_info = args[:assignment_info] if args.key?(:assignment_info)
           @completed = args[:completed] if args.key?(:completed)
           @deleted = args[:deleted] if args.key?(:deleted)
           @due = args[:due] if args.key?(:due)

data/lib/google/apis/tasks_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module TasksV1
       # Version of the google-apis-tasks_v1 gem
-      GEM_VERSION = "0.23.0"
+      GEM_VERSION = "0.24.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240526"
+      REVISION = "20240630"
     end
   end
 end

data/lib/google/apis/tasks_v1/representations.rb

@@ -22,6 +22,24 @@ module Google
   module Apis
     module TasksV1
       
+      class AssignmentInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class DriveResourceInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class SpaceInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Task
         class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -52,9 +70,38 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AssignmentInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :drive_resource_info, as: 'driveResourceInfo', class: Google::Apis::TasksV1::DriveResourceInfo, decorator: Google::Apis::TasksV1::DriveResourceInfo::Representation
+      
+          property :link_to_task, as: 'linkToTask'
+          property :space_info, as: 'spaceInfo', class: Google::Apis::TasksV1::SpaceInfo, decorator: Google::Apis::TasksV1::SpaceInfo::Representation
+      
+          property :surface_type, as: 'surfaceType'
+        end
+      end
+      
+      class DriveResourceInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :drive_file_id, as: 'driveFileId'
+          property :resource_key, as: 'resourceKey'
+        end
+      end
+      
+      class SpaceInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :space, as: 'space'
+        end
+      end
+      
       class Task
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :assignment_info, as: 'assignmentInfo', class: Google::Apis::TasksV1::AssignmentInfo, decorator: Google::Apis::TasksV1::AssignmentInfo::Representation
+      
           property :completed, as: 'completed'
           property :deleted, as: 'deleted'
           property :due, as: 'due'

data/lib/google/apis/tasks_v1/service.rb

@@ -51,7 +51,9 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Deletes the authenticated user's specified task list.
+        # Deletes the authenticated user's specified task list. If the list contains
+        # assigned tasks, both the assigned tasks and the original tasks in the
+        # assignment surface (Docs, Chat Spaces) are deleted.
         # @param [String] tasklist
         #   Task list identifier.
         # @param [String] fields
@@ -272,7 +274,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified task from the task list.
+        # Deletes the specified task from the task list. If the task is assigned, both
+        # the assigned task and the original task (in Docs, Chat Spaces) are deleted. To
+        # delete the assigned task only, navigate to the assignment surface and unassign
+        # the task from there.
         # @param [String] tasklist
         #   Task list identifier.
         # @param [String] task
@@ -336,14 +341,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new task on the specified task list. A user can have up to 20,000
-        # non-hidden tasks per list and up to 100,000 tasks in total at a time.
+        # Creates a new task on the specified task list. Tasks assigned from Docs or
+        # Chat Spaces cannot be inserted from Tasks Public API; they can only be created
+        # by assigning them from Docs or Chat Spaces. A user can have up to 20,000 non-
+        # hidden tasks per list and up to 100,000 tasks in total at a time.
         # @param [String] tasklist
         #   Task list identifier.
         # @param [Google::Apis::TasksV1::Task] task_object
         # @param [String] parent
         #   Parent task identifier. If the task is created at the top level, this
-        #   parameter is omitted. Optional.
+        #   parameter is omitted. An assigned task cannot be a parent task, nor can it
+        #   have a parent. Setting the parent to an assigned task results in failure of
+        #   the request. Optional.
         # @param [String] previous
         #   Previous sibling task identifier. If the task is created at the first position
         #   among its siblings, this parameter is omitted. Optional.
@@ -378,8 +387,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns all tasks in the specified task list. A user can have up to 20,000 non-
-        # hidden tasks per list and up to 100,000 tasks in total at a time.
+        # Returns all tasks in the specified task list. Does not return assigned tasks
+        # be default (from Docs, Chat Spaces). A user can have up to 20,000 non-hidden
+        # tasks per list and up to 100,000 tasks in total at a time.
         # @param [String] tasklist
         #   Task list identifier.
         # @param [String] completed_max
@@ -399,10 +409,13 @@ module Google
         #   allowed: 100).
         # @param [String] page_token
         #   Token specifying the result page to return. Optional.
+        # @param [Boolean] show_assigned
+        #   Optional. Flag indicating whether tasks assigned to the current user are
+        #   returned in the result. Optional. The default is False.
         # @param [Boolean] show_completed
-        #   Flag indicating whether completed tasks are returned in the result. Optional.
-        #   The default is True. Note that showHidden must also be True to show tasks
-        #   completed in first party clients, such as the web UI and Google's mobile apps.
+        #   Flag indicating whether completed tasks are returned in the result. Note that
+        #   showHidden must also be True to show tasks completed in first party clients,
+        #   such as the web UI and Google's mobile apps. Optional. The default is True.
         # @param [Boolean] show_deleted
         #   Flag indicating whether deleted tasks are returned in the result. Optional.
         #   The default is False.
@@ -429,7 +442,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 list_tasks(tasklist, completed_max: nil, completed_min: nil, due_max: nil, due_min: nil, max_results: nil, page_token: nil, show_completed: nil, show_deleted: nil, show_hidden: nil, updated_min: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_tasks(tasklist, completed_max: nil, completed_min: nil, due_max: nil, due_min: nil, max_results: nil, page_token: nil, show_assigned: nil, show_completed: nil, show_deleted: nil, show_hidden: nil, updated_min: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'tasks/v1/lists/{tasklist}/tasks', options)
           command.response_representation = Google::Apis::TasksV1::Tasks::Representation
           command.response_class = Google::Apis::TasksV1::Tasks
@@ -440,6 +453,7 @@ module Google
           command.query['dueMin'] = due_min unless due_min.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['showAssigned'] = show_assigned unless show_assigned.nil?
           command.query['showCompleted'] = show_completed unless show_completed.nil?
           command.query['showDeleted'] = show_deleted unless show_deleted.nil?
           command.query['showHidden'] = show_hidden unless show_hidden.nil?
@@ -449,17 +463,24 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Moves the specified task to another position in the task list. This can
-        # include putting it as a child task under a new parent and/or move it to a
-        # different position among its sibling tasks. A user can have up to 2,000
-        # subtasks per task.
+        # Moves the specified task to another position in the destination task list. If
+        # the destination list is not specified, the task is moved within its current
+        # list. This can include putting it as a child task under a new parent and/or
+        # move it to a different position among its sibling tasks. A user can have up to
+        # 2,000 subtasks per task.
         # @param [String] tasklist
         #   Task list identifier.
         # @param [String] task
         #   Task identifier.
+        # @param [String] destination_tasklist
+        #   Optional. Destination task list identifier. If set, the task is moved from
+        #   tasklist to the destinationTasklist list. Otherwise the task is moved within
+        #   its current list. Recurrent tasks cannot currently be moved between lists.
+        #   Optional.
         # @param [String] parent
         #   New parent task identifier. If the task is moved to the top level, this
-        #   parameter is omitted. Optional.
+        #   parameter is omitted. Assigned tasks can not be set as parent task (have
+        #   subtasks) or be moved under a parent task (become subtasks). Optional.
         # @param [String] previous
         #   New previous sibling task identifier. If the task is moved to the first
         #   position among its siblings, this parameter is omitted. Optional.
@@ -480,12 +501,13 @@ 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 move_task(tasklist, task, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def move_task(tasklist, task, destination_tasklist: nil, parent: nil, previous: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'tasks/v1/lists/{tasklist}/tasks/{task}/move', options)
           command.response_representation = Google::Apis::TasksV1::Task::Representation
           command.response_class = Google::Apis::TasksV1::Task
           command.params['tasklist'] = tasklist unless tasklist.nil?
           command.params['task'] = task unless task.nil?
+          command.query['destinationTasklist'] = destination_tasklist unless destination_tasklist.nil?
           command.query['parent'] = parent unless parent.nil?
           command.query['previous'] = previous unless previous.nil?
           command.query['fields'] = fields unless fields.nil?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-tasks_v1
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.24.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-06-02 00:00:00.000000000 Z
+date: 2024-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-tasks_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-tasks_v1/v0.23.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-tasks_v1/v0.24.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-tasks_v1
 post_install_message: 
 rdoc_options: []