返回经过身份验证的用户的所有任务列表。用户一次最多可以拥有 2,000 个名单。
HTTP 请求
GET https://tasks.googleapis.com/tasks/v1/users/@me/lists
网址采用 gRPC 转码语法。
查询参数
| 参数 | |
|---|---|
| maxResults | 
 一页返回的任务列表数上限。可选。默认值为 1000(允许的最大值:1000)。 | 
| pageToken | 
 用于指定要返回的结果页面的令牌。可选。 | 
请求正文
请求正文必须为空。
响应正文
如果成功,响应正文将包含结构如下的数据:
| JSON 表示法 | 
|---|
| {
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object ( | 
| 字段 | |
|---|---|
| kind | 
 资源的类型。此值始终为“tasks#taskLists”。 | 
| etag | 
 资源的 ETag。 | 
| nextPageToken | 
 可用于请求此结果的下一页的令牌。 | 
| items[] | 
 任务列表集合。 | 
授权范围
需要以下 OAuth 范围之一:
- https://www.googleapis.com/auth/tasks
- https://www.googleapis.com/auth/tasks.readonly
如需了解详情,请参阅授权指南。
TaskLists
| JSON 表示法 | 
|---|
| {
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object ( | 
| 字段 | |
|---|---|
| kind | 
 资源的类型。此值始终为“tasks#taskLists”。 | 
| etag | 
 资源的 ETag。 | 
| nextPageToken | 
 可用于请求此结果的下一页的令牌。 | 
| items[] | 
 任务列表集合。 |