{"id":13763774,"url":"https://github.com/bluzi/google-tasks-api","last_synced_at":"2025-07-30T10:31:41.450Z","repository":{"id":57252361,"uuid":"136071828","full_name":"bluzi/google-tasks-api","owner":"bluzi","description":":rocket: Google Tasks API for humans","archived":false,"fork":false,"pushed_at":"2018-09-22T02:47:02.000Z","size":122,"stargazers_count":53,"open_issues_count":7,"forks_count":1,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-29T23:26:59.622Z","etag":null,"topics":["google","google-tasks","google-tasks-api","javascript","nodejs"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bluzi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-06-04T19:17:00.000Z","updated_at":"2024-09-08T23:54:10.000Z","dependencies_parsed_at":"2022-08-31T22:11:05.704Z","dependency_job_id":null,"html_url":"https://github.com/bluzi/google-tasks-api","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluzi%2Fgoogle-tasks-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluzi%2Fgoogle-tasks-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluzi%2Fgoogle-tasks-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluzi%2Fgoogle-tasks-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bluzi","download_url":"https://codeload.github.com/bluzi/google-tasks-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228124671,"owners_count":17873170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google","google-tasks","google-tasks-api","javascript","nodejs"],"created_at":"2024-08-03T15:00:58.301Z","updated_at":"2024-12-04T14:06:30.777Z","avatar_url":"https://github.com/bluzi.png","language":"JavaScript","funding_links":[],"categories":["Awesome Google Tasks"],"sub_categories":["How?"],"readme":"[![Known Vulnerabilities](https://snyk.io/test/github/bluzi/google-tasks-api/badge.svg?targetFile=package.json)](https://snyk.io/test/github/bluzi/google-tasks-api?targetFile=package.json) [![Build Status](https://travis-ci.org/bluzi/google-tasks-api.svg?branch=master)](https://travis-ci.org/bluzi/google-tasks-api)\n# Google Tasks API\n## What is it good for?\nGoogle made their API so hard to understand, so after struggling with their documentation for their Tasks API I've found [this repository](https://github.com/KarafiziArtur/react-google-tasks) that has a well written abstraction around the Tasks API.\n\nThis package contains the code from the above repository with some additions I made to make it easy to embed in your web application.\n\n## Install\nIf you're using Node:\n```bash\nnpm i google-tasks-api\n```\n\nOr, if you're using plain JavaScript, just add the following script tag: \n```html\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/google-tasks-api@latest/dist/index.min.js\"\u003e\u003c/script\u003e\n```\n\n## Google API Credentials\nYou must have a client ID to use Google Tasks API, to get one, go to [Google APIs Console](https://console.developers.google.com/apis/dashboard) and create a new project, then go to `Credentials` and click on `Create credentials`. \nChoose `OAuth client ID`, then under application type choose `Other`, press `Create` and copy the client ID. \n\n## Usage\nIf you're on Node, import the API using: (You can skip that if you're not using Node)\n```js\nimport googleTasksApi from 'google-tasks-api'\n```\nor \n```js\nconst googleTasksApi = require('google-tasks-api')\n```\n\nNow you can start using the API. Start by autorizing: \n```js\nawait googleTasksAPI.autorize('yourclientid')\n```\n\nThat will promote a popup to the user asking him for permission, after he accepts, the promise will resolve and you will be able to use the following self-explaining methods:\n\n| Method        | Return Type   | Description  |\n| ------------- |:-------------:| -----        |\n| `listTaskLists()`    | `Promise\u003c[]\u003e`     | Returns a list of task lists |\n| `insertTaskList({ title })`    | `Promise\u003c\u003e`     | Receives an object with a `title`, and creates a new task list |\n| `updateTaskList({ taskListId, title })`    | `Promise\u003c\u003e`     | Receives an object with a `taskListId` to update and a `title`, and updates the task list title |\n| `deleteTaskList({ taskListId })`    | `Promise\u003c\u003e`     | Deletes a task list|\n| `listTasks({ taskListId })`    | `Promise\u003c[]\u003e`     | Lists the tasks of `taskListId`|\n| `insertTask({ taskListId, ...params })`    | `Promise\u003c\u003e`     | Creates a task in `taskListId`, a task may have [the following fields](https://developers.google.com/tasks/v1/reference/tasks)|\n| `updateTask({ taskListId, taskId, ...params })`    | `Promise\u003c\u003e`     | Updates a task by its id and task list id|\n| `deleteTask({ taskListId, taskId })`    | `Promise\u003c\u003e`     | Deletes task `taskId` in list `taskListId`|\n\n## Contribution\nAny type of feedback, pull request or issue is welcome.\n\n## License\nThis project is licensed under the MIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluzi%2Fgoogle-tasks-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbluzi%2Fgoogle-tasks-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluzi%2Fgoogle-tasks-api/lists"}