NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Google Tasks

googletasks

Google Tasks provides a simple to-do list and task management system integrated into Gmail and Google Calendar for quick and easy tracking

Task ManagementWeb del proveedor
Acciones
14
Triggers
5
Autenticación
—
OAuth gestionado
Sí
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (14)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Clear tasksGOOGLETASKS_CLEAR_TASKSAcción

Permanently clears all completed tasks from a specified google tasks list; this action is destructive and idempotent.

Parámetros de entrada

  • taskliststringObligatorio

    The identifier of the task list from which to clear completed tasks. Use '@default' for the default task list.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create a task listGOOGLETASKS_CREATE_TASK_LISTAcción

Creates a new task list with the specified title.

Parámetros de entrada

  • tasklist_titlestringObligatorio

    Title for the new task list. The maximum allowed length is 1024 characters.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete taskGOOGLETASKS_DELETE_TASKAcción

Deletes a specified task from a given task list in google tasks.

Parámetros de entrada

  • task_idstringObligatorio

    The unique identifier of the Google Task to be deleted.

  • tasklist_idstringObligatorio

    The unique identifier of the Google Task list from which the task will be deleted.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete task listGOOGLETASKS_DELETE_TASK_LISTAcción

Permanently deletes an existing google task list, identified by `tasklist id`, along with all its tasks; this operation is irreversible.

Parámetros de entrada

  • tasklist_idstring

    Unique identifier of the Google Task list to be deleted.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get TaskGOOGLETASKS_GET_TASKAcción

Use to retrieve a specific google task if its `task id` and parent `tasklist id` are known.

Parámetros de entrada

  • task_idstringObligatorio

    Unique identifier of the Google Task to retrieve.

  • tasklist_idstringObligatorio

    Unique identifier of the Google Tasks list containing the task.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get task listGOOGLETASKS_GET_TASK_LISTAcción

Retrieves a specific task list from the user's google tasks if the `tasklist id` exists for the authenticated user.

Parámetros de entrada

  • tasklist_idstringObligatorio

    The unique identifier of the task list to retrieve, assigned by Google Tasks when the list is created.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Insert TaskGOOGLETASKS_INSERT_TASKAcción

Creates a new task in a given `tasklist id`, optionally as a subtask of an existing `task parent` or positioned after an existing `task previous` sibling, where both `task parent` and `task previous` must belong to the same `tasklist id` if specified.

Parámetros de entrada

  • idstring

    Task identifier.

  • duestring

    Due date of the task. Some examples of expected datetime format: UTC-5:30, 6:50 PM ->If date is not mentioned, and seeming that the start date is in next 24 hours. UTC+1, 11:59 PM, 31 Dec ->If the meeting start date is in next 1 year (this is most possible case) UTC-3:45, 7:15 AM, 22 Aug 2020 ->If the meeting is to be set after at a spefic date, mentioned with year. 11:15 PM, 12 May 2019 ->In case no UTC offset to be mentioned, skip the UTC part altogether. 2023-03-01T00:00:00Z ->Standard ISO-8601 format

  • etagstring

    ETag of the resource.

  • notesstring

    Notes describing the task. Optional. Maximum length allowed: 8192 characters.

  • titlestringObligatorio

    Title of the task. Maximum length allowed: 1024 characters.

  • hiddenboolean

    Flag indicating whether the task is hidden.

  • statusstringObligatorioenum

    Status of the task. This is either 'needsAction' or 'completed'.

    needsActioncompleted
  • deletedboolean

    Flag indicating whether the task has been deleted.

  • completedstring

    Completion date of the task. Some examples of expected datetime format: UTC-5:30, 6:50 PM ->If date is not mentioned, and seeming that the start date is in next 24 hours. UTC+1, 11:59 PM, 31 Dec ->If the meeting start date is in next 1 year (this is most possible case) UTC-3:45, 7:15 AM, 22 Aug 2020 ->If the meeting is to be set after at a spefic date, mentioned with year. 11:15 PM, 12 May 2019 ->In case no UTC offset to be mentioned, skip the UTC part altogether. 2023-03-01T00:00:00Z ->Standard ISO-8601 format

  • task_parentstring

    Identifier of an existing task to serve as parent; if provided, creates a subtask, otherwise a top-level task in the specified list.

  • tasklist_idstringObligatorio

    Identifier for the Google Task list where the new task will be created.

  • task_previousstring

    Identifier of an existing task after which the new task will be placed, at the same hierarchical level (as a sibling).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List task listsGOOGLETASKS_LIST_TASK_LISTSAcción

Fetches the authenticated user's task lists from google tasks; results may be paginated.

Parámetros de entrada

  • pageTokenstring

    Token for the page of results to return; omit for the first page, use `nextPageToken` from a previous response for subsequent pages.

  • maxResultsinteger

    Maximum number of task lists to return per page.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List TasksGOOGLETASKS_LIST_TASKSAcción

Retrieves tasks from a google tasks list; all date/time strings must be rfc3339 utc, and `showcompleted` must be true if `completedmin` or `completedmax` are specified.

Parámetros de entrada

  • dueMaxstring

    Exclude tasks due after this date. Some examples of expected datetime format: UTC-5:30, 6:50 PM ->If date is not mentioned, and seeming that the start date is in next 24 hours. UTC+1, 11:59 PM, 31 Dec ->If the meeting start date is in next 1 year (this is most possible case) UTC-3:45, 7:15 AM, 22 Aug 2020 ->If the meeting is to be set after at a spefic date, mentioned with year. 11:15 PM, 12 May 2019 ->In case no UTC offset to be mentioned, skip the UTC part altogether. 2023-03-01T00:00:00Z ->Standard ISO-8601 format

  • dueMinstring

    Exclude tasks due before this date. Some examples of expected datetime format: UTC-5:30, 6:50 PM ->If date is not mentioned, and seeming that the start date is in next 24 hours. UTC+1, 11:59 PM, 31 Dec ->If the meeting start date is in next 1 year (this is most possible case) UTC-3:45, 7:15 AM, 22 Aug 2020 ->If the meeting is to be set after at a spefic date, mentioned with year. 11:15 PM, 12 May 2019 ->In case no UTC offset to be mentioned, skip the UTC part altogether. 2023-03-01T00:00:00Z ->Standard ISO-8601 format

  • pageTokenstring

    Token from a previous list operation for fetching a specific page; if omitted, retrieves the first page.

  • maxResultsinteger

    Maximum number of tasks to return. API default: 20, maximum: 100.

  • showHiddenboolean

    Include hidden tasks. Defaults to false.

  • updatedMinstring

    Lower bound for task's last modification time (for syncing). Some examples of expected datetime format: UTC-5:30, 6:50 PM ->If date is not mentioned, and seeming that the start date is in next 24 hours. UTC+1, 11:59 PM, 31 Dec ->If the meeting start date is in next 1 year (this is most possible case) UTC-3:45, 7:15 AM, 22 Aug 2020 ->If the meeting is to be set after at a spefic date, mentioned with year. 11:15 PM, 12 May 2019 ->In case no UTC offset to be mentioned, skip the UTC part altogether. 2023-03-01T00:00:00Z ->Standard ISO-8601 format

  • showDeletedboolean

    Include deleted tasks. Defaults to false.

  • tasklist_idstringObligatorio

    Identifier of the task list. Use '@default' for the user's primary task list.

  • completedMaxstring

    Exclude tasks completed after this date. Some examples of expected datetime format: UTC-5:30, 6:50 PM ->If date is not mentioned, and seeming that the start date is in next 24 hours. UTC+1, 11:59 PM, 31 Dec ->If the meeting start date is in next 1 year (this is most possible case) UTC-3:45, 7:15 AM, 22 Aug 2020 ->If the meeting is to be set after at a spefic date, mentioned with year. 11:15 PM, 12 May 2019 ->In case no UTC offset to be mentioned, skip the UTC part altogether. 2023-03-01T00:00:00Z ->Standard ISO-8601 format

  • completedMinstring

    Exclude tasks completed before this date. Some examples of expected datetime format: UTC-5:30, 6:50 PM ->If date is not mentioned, and seeming that the start date is in next 24 hours. UTC+1, 11:59 PM, 31 Dec ->If the meeting start date is in next 1 year (this is most possible case) UTC-3:45, 7:15 AM, 22 Aug 2020 ->If the meeting is to be set after at a spefic date, mentioned with year. 11:15 PM, 12 May 2019 ->In case no UTC offset to be mentioned, skip the UTC part altogether. 2023-03-01T00:00:00Z ->Standard ISO-8601 format

  • showCompletedboolean

    Include completed tasks. Defaults to true. (See action docstring for interaction with `completedMin`/`Max`).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Move TaskGOOGLETASKS_MOVE_TASKAcción

Moves the specified task to another position in the destination task list.

Parámetros de entrada

  • taskstringObligatorio

    Task identifier.

  • parentstring

    New parent task identifier. If not provided, the task is moved to the top level.

  • previousstring

    New previous sibling task identifier. If not provided, the task is moved to the first position among its siblings.

  • taskliststringObligatorio

    Task list identifier.

  • destinationTaskliststring

    Destination task list identifier. If set, the task is moved to this list; otherwise, it remains in its current list.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Patch TaskGOOGLETASKS_PATCH_TASKAcción

Partially updates an existing task (identified by `task id`) within a specific google task list (identified by `tasklist id`), modifying only the provided attributes from `taskinput` (e.g., `title`, `notes`, `due` date, `status`) and requiring both the task and list to exist.

Parámetros de entrada

  • idstring

    Task identifier.

  • duestring

    Due date of the task. Some examples of expected datetime format: UTC-5:30, 6:50 PM ->If date is not mentioned, and seeming that the start date is in next 24 hours. UTC+1, 11:59 PM, 31 Dec ->If the meeting start date is in next 1 year (this is most possible case) UTC-3:45, 7:15 AM, 22 Aug 2020 ->If the meeting is to be set after at a spefic date, mentioned with year. 11:15 PM, 12 May 2019 ->In case no UTC offset to be mentioned, skip the UTC part altogether. 2023-03-01T00:00:00Z ->Standard ISO-8601 format

  • etagstring

    ETag of the resource.

  • notesstring

    Notes describing the task. Optional. Maximum length allowed: 8192 characters.

  • titlestringObligatorio

    Title of the task. Maximum length allowed: 1024 characters.

  • hiddenboolean

    Flag indicating whether the task is hidden.

  • statusstringObligatorioenum

    Status of the task. This is either 'needsAction' or 'completed'.

    needsActioncompleted
  • deletedboolean

    Flag indicating whether the task has been deleted.

  • task_idstringObligatorio

    Identifier of the Google Task to be updated within the specified task list.

  • completedstring

    Completion date of the task. Some examples of expected datetime format: UTC-5:30, 6:50 PM ->If date is not mentioned, and seeming that the start date is in next 24 hours. UTC+1, 11:59 PM, 31 Dec ->If the meeting start date is in next 1 year (this is most possible case) UTC-3:45, 7:15 AM, 22 Aug 2020 ->If the meeting is to be set after at a spefic date, mentioned with year. 11:15 PM, 12 May 2019 ->In case no UTC offset to be mentioned, skip the UTC part altogether. 2023-03-01T00:00:00Z ->Standard ISO-8601 format

  • tasklist_idstringObligatorio

    Identifier of the Google Task list that contains the task to be updated.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Patch task listGOOGLETASKS_PATCH_TASK_LISTAcción

Updates the title of an existing google tasks task list.

Parámetros de entrada

  • tasklist_idstringObligatorio

    The unique identifier of the task list to be updated.

  • updated_titlestringObligatorio

    The new title for the task list.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update TaskGOOGLETASKS_UPDATE_TASKAcción

Updates the specified task.

Parámetros de entrada

  • duestring

    Due date of the task (RFC 3339 timestamp).

  • taskstringObligatorio

    Task identifier.

  • notesstring

    Notes describing the task.

  • titlestring

    Title of the task.

  • statusstring

    Status of the task ("needsAction" or "completed").

  • taskliststringObligatorio

    Task list identifier.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Task ListGOOGLETASKS_UPDATE_TASK_LISTAcción

Updates the authenticated user's specified task list.

Parámetros de entrada

  • titlestringObligatorio

    Title of the task list. Maximum length allowed: 1024 characters.

  • tasklist_idstringObligatorio

    Task list identifier.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Triggers (5)

Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).

New Task CreatedGOOGLETASKS_NEW_TASK_CREATED_TRIGGERTrigger

Triggers when a new task is created in a Google Tasks list. Uses timestamp filtering (updatedMin) to efficiently detect new tasks.

Configuración

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • max_resultsinteger

    Maximum number of tasks to check in each poll (1-100)

  • tasklist_idstring

    Identifier of the task list to monitor. Use '@default' for the primary task list or provide a specific task list ID from list_task_lists action.

Payload del evento

  • event_typestring

    Type of event that occurred

  • taskobjectObligatorio

    The newly created task

Instrucciones

**Instructions for Setting Up the Trigger:** - This trigger monitors a specific Google Tasks list for newly created tasks. - Specify the task list to monitor using tasklist_id (default: '@default' for primary list). - The trigger will detect tasks created after the trigger is set up. - Use max_results to control how many tasks to check in each poll (default: 100). - To get task list IDs, use the List Task Lists action. **How it works:** - Uses timestamp filtering (updatedMin parameter) to only fetch tasks updated since last poll - Maintains a bounded list of seen task IDs for deduplication - First run returns empty to establish baseline

New Task List CreatedGOOGLETASKS_NEW_TASK_LIST_CREATED_TRIGGERTrigger

Triggers when a new Google Tasks task list is created. This trigger monitors Google Tasks and fires when new task lists are detected.

Configuración

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • max_resultsinteger

    Maximum number of task lists to check in each poll (1-100)

Payload del evento

  • event_typestring

    Type of event that occurred

  • task_listobjectObligatorio

    The newly created task list

Instrucciones

**Instructions for Setting Up the Trigger:** - This trigger monitors Google Tasks for newly created task lists. - The trigger will detect task lists created after the trigger is set up. - Use max_results to control how many task lists to check in each poll (default: 20). - The trigger compares task list IDs against a known list to detect new creations.

Task Details ChangedGOOGLETASKS_TASK_DETAILS_CHANGED_TRIGGERTrigger

Triggers when a specific task's details change. This trigger monitors a single Google Task and fires when any of its details (title, notes, status, due date, completion, position) are modified.

Configuración

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • task_idstringObligatorio

    The ID of the specific task to monitor for changes

  • tasklist_idstringObligatorio

    The ID of the task list containing the task to monitor

Payload del evento

  • changed_fieldsstring[]Obligatorio

    List of field names that changed

  • event_typestring

    Type of event that occurred

  • previous_taskobject

    The previous task snapshot (None on first poll)

  • taskobjectObligatorio

    The current task with all details

Instrucciones

**Instructions for Setting Up the Trigger:** - This trigger monitors a specific Google Task for any changes to its details. - You must provide both the `tasklist_id` and `task_id` of the task to monitor. - The trigger will detect changes to: title, notes, status, due date, completion date, and position. - On the first poll, no changes will be emitted (establishing baseline). - Subsequent polls will compare the current state with the previous snapshot. - The trigger emits the changed fields along with both current and previous task data. **How to get tasklist_id and task_id:** - Use the "List Task Lists" action to get available task lists and their IDs - Use the "List Tasks" action with a tasklist_id to get tasks and their IDs

Task List ChangedGOOGLETASKS_TASK_LIST_CHANGED_TRIGGERTrigger

Triggers when a task list changes (title or content updates). This trigger monitors a specific Google Tasks list and fires when changes are detected.

Configuración

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • tasklist_idstringObligatorio

    The unique identifier of the task list to monitor for changes. Use '@default' for the default task list.

Payload del evento

  • changed_fieldsstring[]

    List of fields that changed (e.g., 'title', 'updated')

  • event_typestring

    Type of event that occurred

  • task_listobjectObligatorio

    The task list with changed state

Instrucciones

**Instructions for Setting Up the Trigger:** - This trigger monitors a specific Google Tasks list for changes. - Provide the tasklist_id to monitor. Use '@default' for your default task list. - The trigger detects changes in task list metadata (title, update timestamp). - On first run, the trigger will store the initial state but won't fire. - Subsequent runs will compare the current state to the previous snapshot.

Task UpdatedGOOGLETASKS_TASK_UPDATED_TRIGGERTrigger

Triggers when an existing task is updated in a Google Tasks list. This trigger monitors a specific task list and fires when tasks are modified.

Configuración

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • max_resultsinteger

    Maximum number of tasks to check in each poll (1-100)

  • show_completedboolean

    Include completed tasks in the monitoring. Defaults to true.

  • show_deletedboolean

    Include deleted tasks in the monitoring. Defaults to false.

  • tasklist_idstring

    Identifier of the task list to monitor. Use '@default' for the primary task list, or provide a specific task list ID from list_task_lists action.

Payload del evento

  • event_typestring

    Type of event that occurred

  • taskobjectObligatorio

    The updated task

Instrucciones

**Instructions for Setting Up the Trigger:** - This trigger monitors a Google Tasks list for updated tasks. - Specify the task list to monitor using tasklist_id (use '@default' for the primary list). - The trigger will detect tasks that have been modified after the trigger is set up. - Use max_results to control how many tasks to check in each poll (default: 20). - Set show_completed to include or exclude completed tasks from monitoring. - The trigger uses timestamp-based filtering to efficiently detect only recently updated tasks.