Method: tasks.list

แสดงผลงานทั้งหมดในรายการงานที่ระบุ ผู้ใช้สามารถมีงานที่ไม่ได้ซ่อนได้สูงสุด 20,000 งานต่อรายการ และรวมได้สูงสุด 100,000 งานในแต่ละครั้ง

คำขอ HTTP

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
tasklist

string

ตัวระบุรายการงาน

พารามิเตอร์การค้นหา

พารามิเตอร์
completedMax

string

ขอบเขตบนสำหรับวันที่ดำเนินการเสร็จสมบูรณ์ (เป็นการประทับเวลา RFC 3339) ที่จะใช้กรอง ไม่บังคับ ค่าเริ่มต้นคือไม่กรองตามวันที่เสร็จสมบูรณ์
completedMin

string

ขอบเขตล่างของวันที่งานเสร็จ (เป็นการประทับเวลา RFC 3339) ที่จะใช้กรอง ไม่บังคับ ค่าเริ่มต้นคือไม่กรองตามวันที่เสร็จสมบูรณ์
dueMax

string

ขอบเขตบนของวันที่ครบกำหนดของงาน (เป็นการประทับเวลา RFC 3339) ที่จะใช้กรอง ไม่บังคับ ค่าเริ่มต้นคือไม่กรองตามวันที่ครบกำหนด
dueMin

string

ขอบเขตล่างของวันที่ครบกำหนดของงาน (เป็นการประทับเวลา RFC 3339) ที่จะใช้กรอง ไม่บังคับ ค่าเริ่มต้นคือไม่กรองตามวันที่ครบกำหนด
maxResults

integer

จำนวนงานสูงสุดที่แสดงผลใน 1 หน้า ไม่บังคับ ค่าเริ่มต้นคือ 20 (อนุญาตสูงสุด: 100)
pageToken

string

โทเค็นที่ระบุหน้าผลลัพธ์ที่จะแสดงผล ไม่บังคับ
showCompleted

boolean

การแจ้งที่ระบุว่าจะแสดงงานที่เสร็จแล้วในผลการค้นหาหรือไม่ ไม่บังคับ ค่าเริ่มต้นคือ "จริง" โปรดทราบว่า showhidden ต้องเป็น "จริง" ด้วยเพื่อแสดงงานที่ทำในไคลเอ็นต์บุคคลที่หนึ่ง เช่น UI บนเว็บและแอปบนอุปกรณ์เคลื่อนที่ของ Google
showDeleted

boolean

การแจ้งที่ระบุว่าจะแสดงงานที่ลบไปแล้วในผลการค้นหาหรือไม่ ไม่บังคับ ทั้งนี้ ระบบตั้งค่าเริ่มต้นไว้เป็น "เท็จ"
showHidden

boolean

การแจ้งที่ระบุว่าจะมีการแสดงผลงานที่ซ่อนในผลการค้นหาหรือไม่ ไม่บังคับ ทั้งนี้ ระบบตั้งค่าเริ่มต้นไว้เป็น "เท็จ"
updatedMin

string

ขอบเขตล่างของเวลาที่แก้ไขครั้งล่าสุดของงาน (เป็นการประทับเวลา RFC 3339) ที่จะใช้กรอง ไม่บังคับ ค่าเริ่มต้นคือไม่กรองตามเวลาที่แก้ไขล่าสุด

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
ช่อง
kind

string

ประเภทของทรัพยากร ซึ่งจะเป็น "tasks#tasks" เสมอ
etag

string

ETag ของทรัพยากร
nextPageToken

string

โทเค็นที่ใช้เข้าถึงหน้าถัดไปของผลการค้นหานี้
items[]

object (Task)

คอลเล็กชันงาน

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์

งาน

การแสดง JSON 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
ช่อง
kind

string

ประเภทของทรัพยากร ซึ่งจะเป็น "tasks#tasks" เสมอ
etag

string

ETag ของทรัพยากร
nextPageToken

string

โทเค็นที่ใช้เข้าถึงหน้าถัดไปของผลการค้นหานี้
items[]

object (Task)

คอลเล็กชันงาน