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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}
ช่อง
kind

string

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

string

ตัวระบุงาน
etag

string

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

string

ชื่องาน ความยาวสูงสุดที่อนุญาต: 1,024 อักขระ
updated

string

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

string

เอาต์พุตเท่านั้น ตัวระบุงานหลัก ระบบจะละเว้นช่องนี้หากเป็นงานระดับบนสุด ใช้เมธอด "move" เพื่อย้ายงานไปไว้ภายใต้รายการหลักอื่นหรือไปยังระดับบนสุด งานหลักจะต้องไม่ใช่งานที่มอบหมาย (จากพื้นที่ใน Chat, เอกสาร) ช่องนี้เป็นแบบอ่านอย่างเดียว
position

string

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

string

หมายเหตุที่อธิบายงาน งานที่ได้รับมอบหมายจาก Google เอกสารจะไม่มีโน้ต ไม่บังคับ ความยาวสูงสุดที่อนุญาต: 8192 อักขระ
status

string

สถานะของงาน ซึ่งอาจเป็น "needsAction" หรือ "completed"
due

string

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

string

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

boolean

การแจ้งที่ระบุว่ามีการลบงานหรือไม่ สำหรับงานที่มอบหมาย ช่องนี้จะเป็นแบบอ่านอย่างเดียว คุณจะลบได้โดยการเรียกใช้ tasks.delete ซึ่งในกรณีนี้ ระบบจะลบทั้งงานที่มอบหมายและงานเดิม (ในเอกสารหรือพื้นที่ทำงานใน Chat) หากต้องการลบเฉพาะงานที่มอบหมาย ให้ไปที่แพลตฟอร์มงานและยกเลิกการมอบหมายงานจากแพลตฟอร์มนั้น ค่าเริ่มต้นคือ False
hidden

boolean

การแจ้งที่ระบุว่ามีการซ่อนงานหรือไม่ กรณีนี้เกิดขึ้นเมื่อมีการทําเครื่องหมายงานว่าเสร็จแล้วเมื่อล้างรายการงานครั้งล่าสุด ค่าเริ่มต้นคือ False ช่องนี้เป็นแบบอ่านอย่างเดียว
links[].type

string

ประเภทของลิงก์ เช่น "email", "generic", "chat_message", "keep_note"
links[].description

string

คําอธิบาย (อาจว่างเปล่า)
links[].link

string

URL
assignmentInfo

object (AssignmentInfo)

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

AssignmentInfo

ข้อมูลเกี่ยวกับแหล่งที่มาของการมอบหมายงาน (เอกสาร พื้นที่ใน Chat)

การแสดง JSON 
{
  "linkToTask": string,
  "surfaceType": enum (ContextType),

  // Union field surface_info can be only one of the following:
  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
  // End of list of possible types for union field surface_info.
}
ช่อง
surfaceType

enum (ContextType)

เอาต์พุตเท่านั้น ประเภทแพลตฟอร์มที่มอบหมายงานนี้ ปัจจุบันจำกัดไว้ที่เอกสารหรือพื้นที่ทำงาน
ฟิลด์สหภาพ surface_info ข้อมูลเกี่ยวกับแพลตฟอร์ม (เอกสาร พื้นที่ใน Chat) ที่ใช้มอบหมายงานนี้ surface_info ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
driveResourceInfo

object (DriveResourceInfo)

เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับไฟล์ในไดรฟ์ที่เป็นต้นทางของงานนี้ ปัจจุบันไฟล์ในไดรฟ์ต้องเป็นเอกสารเท่านั้น ช่องนี้เป็นแบบอ่านอย่างเดียว
spaceInfo

object (SpaceInfo)

เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับพื้นที่ใน Chat ที่เป็นต้นทางของงานนี้ ช่องนี้เป็นแบบอ่านอย่างเดียว

ContextType

ผลิตภัณฑ์ที่เชื่อมโยงกับงาน

Enum
CONTEXT_TYPE_UNSPECIFIED ค่าที่ไม่รู้จักสําหรับบริบทของงานนี้
GMAIL สร้างงานจาก Gmail
DOCUMENT มีการมอบหมายงานจากเอกสาร
SPACE มอบหมายงานจากพื้นที่ใน Chat

DriveResourceInfo

ข้อมูลเกี่ยวกับทรัพยากรในไดรฟ์ที่มอบหมายงาน (เอกสาร ชีต ฯลฯ)

การแสดง JSON 
{
  "driveFileId": string,
  "resourceKey": string
}
ช่อง
driveFileId

string

เอาต์พุตเท่านั้น ตัวระบุของไฟล์ใน Drive API
resourceKey

string

เอาต์พุตเท่านั้น คีย์ทรัพยากรที่จําเป็นสําหรับเข้าถึงไฟล์ที่แชร์ผ่านลิงก์ที่แชร์ ไม่จําเป็นสำหรับไฟล์บางไฟล์ โปรดดูที่ developers.google.com/drive/api/guides/resource-keys

SpaceInfo

ข้อมูลเกี่ยวกับพื้นที่ใน Chat ที่มีการมอบหมายงาน

การแสดง JSON 
{
  "space": string
}
ช่อง
space

string

เอาต์พุตเท่านั้น พื้นที่ใน Chat ที่เป็นต้นทางของงานนี้ รูปแบบคือ "spaces/{space}"

เมธอด

clear

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

delete

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

get

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

insert

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

list

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

move

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

patch

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

update

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