返回经过身份验证的用户的所有任务列表。用户一次最多可以拥有 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/taskshttps://www.googleapis.com/auth/tasks.readonly
如需了解详情,请参阅授权指南。
TaskLists
| JSON 表示法 | 
|---|
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object ( | 
              
| 字段 | |
|---|---|
kind | 
                
                   
 资源的类型。此值始终为“tasks#taskLists”。  | 
              
etag | 
                
                   
 资源的 ETag。  | 
              
nextPageToken | 
                
                   
 可用于请求此结果的下一页的令牌。  | 
              
items[] | 
                
                   
 任务列表集合。  |