Method: tasks.list

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

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

string

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

boolean

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

boolean

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

boolean

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

string

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

boolean

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

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

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

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

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

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

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