ใช้พารามิเตอร์ของ Tasks
นอกจากพารามิเตอร์การค้นหามาตรฐานที่ใช้กับ Google APIs ส่วนใหญ่ได้แล้ว ยังมีชุดพารามิเตอร์ Tasks ไว้ด้วย
พารามิเตอร์คําขอที่ใช้เฉพาะกับการดําเนินการบางอย่างใน Google Tasks API จะได้รับการสรุปในตารางต่อไปนี้ ค่าพารามิเตอร์ทั้งหมดต้องมีการเข้ารหัส URL
พารามิเตอร์ |
ความหมาย |
หมายเหตุ |
ประโยชน์ต่อการให้บริการ |
completedMax |
ขอบเขตบนของวันที่งานเสร็จสมบูรณ์ (เป็นการประทับเวลา RFC 3339) เพื่อกรอง |
- ค่าเริ่มต้น:
completedMax=2031-01-01
- ใช้รูปแบบการประทับเวลา RFC 3339 เช่น
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
ขอบเขตล่างสําหรับวันที่เสร็จสมบูรณ์ของงาน (เป็นการประทับเวลา RFC 3339) ที่จะกรอง |
- ค่าเริ่มต้น:
completedMin=1970-01-01
- ใช้รูปแบบการประทับเวลา RFC 3339 เช่น
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
ขอบเขตบนของวันที่ครบกําหนดของงาน (เป็นการประทับเวลา RFC 3339) ที่จะกรอง |
- ค่าเริ่มต้น:
dueMax=2031-01-01
- ใช้รูปแบบการประทับเวลา RFC 3339 เช่น
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
ขอบเขตล่างของวันที่ครบกําหนดของงาน (เป็นการประทับเวลา RFC 3339) ที่จะกรอง |
- ค่าเริ่มต้น:
dueMin=1970-01-01
- ใช้รูปแบบการประทับเวลา RFC 3339 เช่น
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
จํานวนองค์ประกอบสูงสุดที่จะแสดงกับคําขอนี้ |
- ค่าเริ่มต้น:
maxResults=20
- ค่าสูงสุดที่อนุญาต:
maxResults=100.
|
- การดึงข้อมูลรายการงานของผู้ใช้
- กําลังดึงข้อมูลงาน
|
pageToken |
โทเค็นที่ระบุหน้าผลการค้นหาที่จะส่งคืน |
- ค่าเริ่มต้นคือแสดงหน้าแรก
|
- การดึงข้อมูลรายการงานของผู้ใช้
- กําลังดึงข้อมูลงาน
|
parent |
ระบุรหัสงานหลักของงาน |
- ไม่มีพารามิเตอร์ที่ระบุการแทรกหรือย้ายไปยังระดับบนสุดของรายการงาน
|
- การสร้างงาน
- การสั่งซื้องาน
|
previous |
ระบุรหัสงานก่อนหน้าของงาน |
- ไม่มีพารามิเตอร์ที่ระบุการแทรกหรือย้ายไปยังตําแหน่งแรกในรายการย่อย
|
- การสร้างงาน
- การสั่งซื้องาน
|
showCompleted |
ระบุว่าจะแสดงงานที่ทําเสร็จหรือไม่ |
- ค่าเริ่มต้น:
showCompleted=true
|
|
showDeleted |
ระบุว่าจะแสดงงานที่ถูกลบหรือไม่ |
- ค่าเริ่มต้น:
showDeleted=false
|
|
showHidden |
ระบุว่าจะแสดงงานที่ซ่อนไว้หรือไม่ |
- ค่าเริ่มต้น:
showHidden=true
|
|
updatedMin |
ขอบเขตล่างสําหรับเวลาแก้ไขล่าสุดของงาน (เป็นการประทับเวลา RFC 3339) ที่จะกรอง |
- ใช้รูปแบบการประทับเวลา RFC 3339 เช่น
2010-08-09T10:57:00.000-08:00Z
- ค่าเริ่มต้นคือไม่กรองตามเวลาแก้ไขล่าสุด
|
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-09-03 UTC
[null,null,["อัปเดตล่าสุด 2024-09-03 UTC"],[[["In addition to standard query parameters, the Google Tasks API utilizes specific parameters for refined task management."],["These parameters control filtering by due dates, completion dates, modification times, and the visibility of completed, deleted, or hidden tasks."],["Developers can use these parameters to retrieve specific sets of tasks based on various criteria, such as completion status and due dates, using RFC 3339 timestamps for filtering."],["Parameters like `maxResults` and `pageToken` allow for pagination and control over the number of tasks returned in a response."],["The `parent` and `previous` parameters enable developers to manage task hierarchy and ordering within task lists."]]],["The Google Tasks API uses specific parameters for operations, all of which require URL encoding. These parameters filter tasks by `completedMin/Max`, `dueMin/Max`, and `updatedMin` date ranges using RFC 3339 timestamps. `maxResults` limits the number of returned items, and `pageToken` specifies the result page. `parent` and `previous` parameters determine task order, while `showCompleted`, `showDeleted`, and `showHidden` control the visibility of tasks. These parameters apply to retrieving tasks and task lists, creating, and ordering tasks.\n"]]