傳回已驗證使用者的所有工作清單。使用者一次最多可擁有 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[] | 
                
                   
 工作清單集合。  |