Method: tasks.list

แสดงงานทั้งหมดในรายการงานที่ระบุ ไม่แสดงผลงานที่มอบหมายซึ่งเป็นค่าเริ่มต้น (จากเอกสาร พื้นที่ใน Chat) ผู้ใช้ 1 คนจะมีงานที่ไม่ได้ซ่อนได้สูงสุด 20,000 งานต่อ 1 รายการ และรวมแล้วไม่เกิน 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 ไม่บังคับ ค่าเริ่มต้นคือ True
showDeleted

boolean

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

boolean

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

string

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

boolean

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

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

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

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

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

การแสดง 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)

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