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

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

string

เอาต์พุตเท่านั้น สตริงที่ระบุตำแหน่งของงานในกลุ่มงานที่เกี่ยวข้องภายใต้งานหลักเดียวกันหรือที่ระดับบนสุด หากสตริงนี้มากกว่าสตริงตำแหน่งที่สอดคล้องกันของงานอื่นตามลำดับพจนานุกรม ระบบจะวางงานนี้ไว้หลังงานอื่นภายใต้งานหลักเดียวกัน (หรือที่ระดับบนสุด) ใช้วิธี "ย้าย" เพื่อย้ายงานไปยังตำแหน่งอื่น
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)

เอาต์พุตเท่านั้น ประเภทแพลตฟอร์มที่งานที่มอบหมายนี้มาจาก ปัจจุบันจำกัดไว้ที่ DOCUMENT หรือ SPACE
ฟิลด์ Union 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

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