@maxim_mazurok/gapi.client.tasks-v1 0.0.20240625 → 0.0.20240702

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://tasks.googleapis.com/$discovery/rest?version=v1
-// Revision: 20240625
+// Revision: 20240702
 
 /// <reference types="gapi.client" />
 
@@ -24,10 +24,32 @@ declare namespace gapi.client {
   function load(name: 'tasks', version: 'v1', callback: () => any): void;
 
   namespace tasks {
+    interface AssignmentInfo {
+      /** Output only. Information about the Drive file where this task originates from. Currently, the Drive file can only be a document. This field is read-only. */
+      driveResourceInfo?: DriveResourceInfo;
+      /** Output only. An absolute link to the original task in the surface of assignment (Docs, Chat spaces, etc.). */
+      linkToTask?: string;
+      /** Output only. Information about the Chat Space where this task originates from. This field is read-only. */
+      spaceInfo?: SpaceInfo;
+      /** Output only. The type of surface this assigned task originates from. Currently limited to DOCUMENT or SPACE. */
+      surfaceType?: string;
+    }
+    interface DriveResourceInfo {
+      /** Output only. Identifier of the file in the Drive API. */
+      driveFileId?: string;
+      /** 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. */
+      resourceKey?: string;
+    }
+    interface SpaceInfo {
+      /** Output only. The Chat space where this task originates from. The format is "spaces/{space}". */
+      space?: string;
+    }
     interface Task {
+      /** Output only. Context information for assigned tasks. A task can be assigned to a user, currently possible from surfaces like Docs and Chat Spaces. This field is populated for tasks assigned to the current user and identifies where the task was assigned from. This field is read-only. */
+      assignmentInfo?: AssignmentInfo;
       /** Completion date of the task (as a RFC 3339 timestamp). This field is omitted if the task has not been completed. */
       completed?: string;
-      /** 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. */
       deleted?: boolean;
       /** Due date of the task (as a RFC 3339 timestamp). Optional. The due date only records date information; the time portion of the timestamp is discarded when setting the due date. It isn't possible to read or write the time that a task is due via the API. */
       due?: string;
@@ -48,9 +70,9 @@ declare namespace gapi.client {
         /** Type of the link, e.g. "email". */
         type?: string;
       }>;
-      /** 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. */
       notes?: string;
-      /** 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. */
+      /** Output only. Parent task identifier. This field is omitted if it is a top-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. */
       parent?: string;
       /** Output only. String indicating the position of the task among its sibling tasks under the same parent task or at the top level. If this string is greater than another task's corresponding position string according to lexicographical ordering, the task is positioned after the other task under the same parent task (or at the top level). Use the "move" method to move the task to another position. */
       position?: string;
@@ -100,7 +122,7 @@ declare namespace gapi.client {
       nextPageToken?: string;
     }
     interface TasklistsResource {
-      /** 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. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -382,7 +404,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<void>;
-      /** 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. */
       delete(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -440,7 +462,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<Task>;
-      /** 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. */
       insert(request: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -456,7 +478,7 @@ declare namespace gapi.client {
         key?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** Parent task identifier. If the task is created at the top level, this parameter is omitted. Optional. */
+        /** Parent task identifier. If the task is created at the top level, this 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. */
         parent?: string;
         /** Returns response with indentations and line breaks. */
         prettyPrint?: boolean;
@@ -489,7 +511,7 @@ declare namespace gapi.client {
           key?: string;
           /** OAuth 2.0 token for the current user. */
           oauth_token?: string;
-          /** Parent task identifier. If the task is created at the top level, this parameter is omitted. Optional. */
+          /** Parent task identifier. If the task is created at the top level, this 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. */
           parent?: string;
           /** Returns response with indentations and line breaks. */
           prettyPrint?: boolean;
@@ -506,7 +528,7 @@ declare namespace gapi.client {
         },
         body: Task
       ): Request<Task>;
-      /** 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. */
       list(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -538,7 +560,9 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** 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. */
         quotaUser?: string;
-        /** 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. */
+        /** Optional. Flag indicating whether tasks assigned to the current user are returned in the result. Optional. The default is False. */
+        showAssigned?: boolean;
+        /** 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. */
         showCompleted?: boolean;
         /** Flag indicating whether deleted tasks are returned in the result. Optional. The default is False. */
         showDeleted?: boolean;
@@ -553,7 +577,7 @@ declare namespace gapi.client {
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
       }): Request<Tasks>;
-      /** 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. */
       move(request?: {
         /** V1 error format. */
         '$.xgafv'?: string;
@@ -563,13 +587,15 @@ declare namespace gapi.client {
         alt?: string;
         /** JSONP */
         callback?: string;
+        /** 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. */
+        destinationTasklist?: string;
         /** Selector specifying which fields to include in a partial response. */
         fields?: string;
         /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
         key?: string;
         /** OAuth 2.0 token for the current user. */
         oauth_token?: string;
-        /** New parent task identifier. If the task is moved to the top level, this parameter is omitted. Optional. */
+        /** New parent task identifier. If the task is moved to the top level, this parameter is omitted. Assigned tasks can not be set as parent task (have subtasks) or be moved under a parent task (become subtasks). Optional. */
         parent?: string;
         /** Returns response with indentations and line breaks. */
         prettyPrint?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.tasks-v1",
-  "version": "0.0.20240625",
+  "version": "0.0.20240702",
   "description": "TypeScript typings for Google Tasks API v1",
   "repository": {
     "type": "git",

package/readme.md

@@ -73,7 +73,7 @@ After that you can use Google Tasks API resources: <!-- TODO: make this work for
 
 ```typescript
 /*
-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.
 */
 await gapi.client.tasks.tasklists.delete({tasklist: 'tasklist'});
 
@@ -108,7 +108,7 @@ Clears all completed tasks from the specified task list. The affected tasks will
 await gapi.client.tasks.tasks.clear({tasklist: 'tasklist'});
 
 /*
-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.
 */
 await gapi.client.tasks.tasks.delete({task: 'task', tasklist: 'tasklist'});
 
@@ -118,17 +118,17 @@ Returns the specified task.
 await gapi.client.tasks.tasks.get({task: 'task', tasklist: 'tasklist'});
 
 /*
-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.
 */
 await gapi.client.tasks.tasks.insert({tasklist: 'tasklist'});
 
 /*
-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.
 */
 await gapi.client.tasks.tasks.list({tasklist: 'tasklist'});
 
 /*
-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.
 */
 await gapi.client.tasks.tasks.move({task: 'task', tasklist: 'tasklist'});