Google Tasks API . tasklists

Instance Methods

close()

Close httplib2 connections.

delete(tasklist, x__xgafv=None)

Deletes the authenticated user's specified task list.

get(tasklist, x__xgafv=None)

Returns the authenticated user's specified task list.

insert(body=None, x__xgafv=None)

Creates a new task list and adds it to the authenticated user's task lists. A user can have up to 2000 lists at a time.

list(maxResults=None, pageToken=None, x__xgafv=None)

Returns all the authenticated user's task lists. A user can have up to 2000 lists at a time.

list_next()

Retrieves the next page of results.

patch(tasklist, body=None, x__xgafv=None)

Updates the authenticated user's specified task list. This method supports patch semantics.

update(tasklist, body=None, x__xgafv=None)

Updates the authenticated user's specified task list.

Method Details

close()
Close httplib2 connections.
delete(tasklist, x__xgafv=None)
Deletes the authenticated user's specified task list.

Args:
  tasklist: string, Task list identifier. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format
get(tasklist, x__xgafv=None)
Returns the authenticated user's specified task list.

Args:
  tasklist: string, Task list identifier. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "etag": "A String", # ETag of the resource.
  "id": "A String", # Task list identifier.
  "kind": "A String", # Type of the resource. This is always "tasks#taskList".
  "selfLink": "A String", # URL pointing to this task list. Used to retrieve, update, or delete this task list.
  "title": "A String", # Title of the task list. Maximum length allowed: 1024 characters.
  "updated": "A String", # Last modification time of the task list (as a RFC 3339 timestamp).
}
insert(body=None, x__xgafv=None)
Creates a new task list and adds it to the authenticated user's task lists. A user can have up to 2000 lists at a time.

Args:
  body: object, The request body.
    The object takes the form of:

{
  "etag": "A String", # ETag of the resource.
  "id": "A String", # Task list identifier.
  "kind": "A String", # Type of the resource. This is always "tasks#taskList".
  "selfLink": "A String", # URL pointing to this task list. Used to retrieve, update, or delete this task list.
  "title": "A String", # Title of the task list. Maximum length allowed: 1024 characters.
  "updated": "A String", # Last modification time of the task list (as a RFC 3339 timestamp).
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "etag": "A String", # ETag of the resource.
  "id": "A String", # Task list identifier.
  "kind": "A String", # Type of the resource. This is always "tasks#taskList".
  "selfLink": "A String", # URL pointing to this task list. Used to retrieve, update, or delete this task list.
  "title": "A String", # Title of the task list. Maximum length allowed: 1024 characters.
  "updated": "A String", # Last modification time of the task list (as a RFC 3339 timestamp).
}
list(maxResults=None, pageToken=None, x__xgafv=None)
Returns all the authenticated user's task lists. A user can have up to 2000 lists at a time.

Args:
  maxResults: integer, Maximum number of task lists returned on one page. Optional. The default is 20 (max allowed: 100).
  pageToken: string, Token specifying the result page to return. Optional.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "etag": "A String", # ETag of the resource.
  "items": [ # Collection of task lists.
    {
      "etag": "A String", # ETag of the resource.
      "id": "A String", # Task list identifier.
      "kind": "A String", # Type of the resource. This is always "tasks#taskList".
      "selfLink": "A String", # URL pointing to this task list. Used to retrieve, update, or delete this task list.
      "title": "A String", # Title of the task list. Maximum length allowed: 1024 characters.
      "updated": "A String", # Last modification time of the task list (as a RFC 3339 timestamp).
    },
  ],
  "kind": "A String", # Type of the resource. This is always "tasks#taskLists".
  "nextPageToken": "A String", # Token that can be used to request the next page of this result.
}
list_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.
        
patch(tasklist, body=None, x__xgafv=None)
Updates the authenticated user's specified task list. This method supports patch semantics.

Args:
  tasklist: string, Task list identifier. (required)
  body: object, The request body.
    The object takes the form of:

{
  "etag": "A String", # ETag of the resource.
  "id": "A String", # Task list identifier.
  "kind": "A String", # Type of the resource. This is always "tasks#taskList".
  "selfLink": "A String", # URL pointing to this task list. Used to retrieve, update, or delete this task list.
  "title": "A String", # Title of the task list. Maximum length allowed: 1024 characters.
  "updated": "A String", # Last modification time of the task list (as a RFC 3339 timestamp).
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "etag": "A String", # ETag of the resource.
  "id": "A String", # Task list identifier.
  "kind": "A String", # Type of the resource. This is always "tasks#taskList".
  "selfLink": "A String", # URL pointing to this task list. Used to retrieve, update, or delete this task list.
  "title": "A String", # Title of the task list. Maximum length allowed: 1024 characters.
  "updated": "A String", # Last modification time of the task list (as a RFC 3339 timestamp).
}
update(tasklist, body=None, x__xgafv=None)
Updates the authenticated user's specified task list.

Args:
  tasklist: string, Task list identifier. (required)
  body: object, The request body.
    The object takes the form of:

{
  "etag": "A String", # ETag of the resource.
  "id": "A String", # Task list identifier.
  "kind": "A String", # Type of the resource. This is always "tasks#taskList".
  "selfLink": "A String", # URL pointing to this task list. Used to retrieve, update, or delete this task list.
  "title": "A String", # Title of the task list. Maximum length allowed: 1024 characters.
  "updated": "A String", # Last modification time of the task list (as a RFC 3339 timestamp).
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "etag": "A String", # ETag of the resource.
  "id": "A String", # Task list identifier.
  "kind": "A String", # Type of the resource. This is always "tasks#taskList".
  "selfLink": "A String", # URL pointing to this task list. Used to retrieve, update, or delete this task list.
  "title": "A String", # Title of the task list. Maximum length allowed: 1024 characters.
  "updated": "A String", # Last modification time of the task list (as a RFC 3339 timestamp).
}