REST Resource: tasks

ทรัพยากร: งาน

การแสดง JSON
{
  "kind": string,
  "id": string,
  "etag": string,
  "title": string,
  "updated": string,
  "selfLink": string,
  "parent": string,
  "position": string,
  "notes": string,
  "status": string,
  "due": string,
  "completed": string,
  "deleted": boolean,
  "hidden": boolean,
  "links": [
    {
      "type": string,
      "description": string,
      "link": string
    }
  ],
  "webViewLink": string
}
ช่อง
kind

string

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

id

string

ตัวระบุงาน

etag

string

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

title

string

ชื่องาน ความยาวสูงสุดคือ 1,024 อักขระ

updated

string

เวลาที่แก้ไขงานครั้งล่าสุด (เป็นการประทับเวลา RFC 3339)

parent

string

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

position

string

สตริงที่แสดงตำแหน่งของงานท่ามกลางงานระดับข้างเคียงภายใต้งานหลักเดียวกันหรือที่ระดับบนสุด หากสตริงนี้มากกว่าสตริงตำแหน่งที่เกี่ยวข้องของงานอื่นตามลำดับแบบพจนานุกรม งานนั้นจะจัดตำแหน่งหลังงานอื่นภายใต้งานหลักเดียวกัน (หรือระดับบนสุด) ช่องนี้เป็นแบบอ่านอย่างเดียว ใช้วิธีการ "ย้าย" เพื่อย้ายงานไปยังตําแหน่งอื่น

notes

string

โน้ตที่อธิบายงาน ไม่บังคับ ความยาวสูงสุดคือ 8,192 อักขระ

status

string

สถานะของงาน นี่คือ "needsAction" หรือ "completed" อย่างใดอย่างหนึ่ง

due

string

วันที่ครบกำหนดของงาน (เป็นการประทับเวลา RFC 3339) ไม่บังคับ วันที่ครบกำหนดจะบันทึกข้อมูลวันที่เท่านั้น และจะลบส่วนของเวลาของการประทับเวลาเมื่อตั้งค่าวันที่ครบกำหนด โดยจะอ่านหรือเขียนเวลาที่งานครบกำหนดผ่าน API ไม่ได้

completed

string

วันที่ทำงานเสร็จ (เป็นการประทับเวลา RFC 3339) ช่องนี้จะถูกละไว้หากงานยังไม่เสร็จ

deleted

boolean

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

hidden

boolean

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

links[].type

string

ประเภทลิงก์ เช่น "อีเมล"

links[].description

string

คำอธิบาย ใน HTML พูด: ทุกอย่างระหว่าง <a> และ </a>

links[].link

string

URL

วิธีการ

clear

ล้างงานที่ทำเสร็จแล้วทั้งหมดจากรายการงานที่ระบุ

delete

ลบงานที่ระบุออกจากรายการงาน

get

แสดงผลงานที่ระบุ

insert

สร้างงานใหม่ในรายการงานที่ระบุ

list

แสดงผลงานทั้งหมดในรายการงานที่ระบุ

move

ย้ายงานที่ระบุไปยังตำแหน่งอื่นในรายการงาน

patch

อัปเดตงานที่ระบุ

update

อัปเดตงานที่ระบุ