NAME

Google::RestApi::TasksApi1::TaskList - Task list object for Google Tasks.

SYNOPSIS

my $tl = $tasks_api->task_list(id => 'task_list_id');

# Get task list metadata
my $metadata = $tl->get();

# Update task list
$tl->update(title => 'New Name');

# Delete task list
$tl->delete();

# Tasks
my @tasks = $tl->tasks();
my $task = $tl->task(id => 'task_id');
$tl->create_task(
  title => 'Buy groceries',
  notes => 'Milk, eggs, bread',
  due   => '2026-03-01T00:00:00.000Z',
);

# Clear completed tasks
$tl->clear();

DESCRIPTION

Represents a Google Task List with full CRUD operations and task management.

METHODS

get(fields => $fields, params => \%params)

Retrieves task list metadata. Requires task list ID.

update(title => $title)

Updates task list metadata. Requires task list ID.

delete()

Permanently deletes the task list. Requires task list ID.

task(id => $id)

Returns a Task object. Without id, can be used to create new tasks.

tasks(max_pages => $n, page_callback => $coderef)

Lists all tasks on the task list. Requires task list ID. max_pages limits the number of pages fetched (default 1). Set to 0 for unlimited. Supports page_callback, see "PAGE CALLBACKS" in Google::RestApi.

create_task(title => $title, notes => $notes, due => $due)

Creates a new task on the task list. Requires task list ID.

clear()

Clears all completed tasks from the task list. Requires task list ID.

task_list_id()

Returns the task list ID.

tasks_api()

Returns the parent TasksApi1 object.

AUTHORS

• Robin Murray mvsjes@cpan.org

COPYRIGHT

Copyright (c) 2019-2026 Robin Murray. All rights reserved.

This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.