REST Resource: tasks

Resource: Task

Representasi 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)
  }
}
Kolom
kind

string

Hanya output. Jenis resource. Ini selalu "tasks#task".
id

string

ID tugas.
etag

string

ETag resource.
title

string

Judul tugas. Panjang maksimum yang diizinkan: 1.024 karakter.
updated

string

Hanya output. Waktu modifikasi terakhir tugas (sebagai stempel waktu RFC 3339).
parent

string

Hanya output. ID tugas induk. Kolom ini dihilangkan jika merupakan tugas tingkat teratas. Gunakan metode "move" untuk memindahkan tugas ke induk yang berbeda atau ke tingkat teratas. Tugas induk tidak boleh berupa tugas yang ditetapkan (dari Ruang Chat, Dokumen). Kolom ini bersifat hanya baca.
position

string

Hanya output. String yang menunjukkan posisi tugas di antara tugas yang setara dalam tugas induk yang sama atau di tingkat teratas. Jika string ini lebih besar dari string posisi tugas lain yang sesuai menurut pengurutan leksikografis, tugas akan diposisikan setelah tugas lain dalam tugas induk yang sama (atau di tingkat teratas). Gunakan metode "move" untuk memindahkan tugas ke posisi lain.
notes

string

Catatan yang menjelaskan tugas. Tugas yang ditetapkan dari Google Dokumen tidak dapat memiliki catatan. Opsional. Panjang maksimum yang diizinkan: 8192 karakter.
status

string

Status tugas. Nilai ini adalah "needsAction" atau "completed".
due

string

Batas waktu tugas (sebagai stempel waktu RFC 3339). Opsional. Batas waktu hanya mencatat informasi tanggal; bagian waktu dari stempel waktu akan dihapus saat menetapkan batas waktu. Anda tidak dapat membaca atau menulis waktu tugas jatuh tempo melalui API.
completed

string

Tanggal penyelesaian tugas (sebagai stempel waktu RFC 3339). Kolom ini dihilangkan jika tugas belum selesai.
deleted

boolean

Tanda yang menunjukkan apakah tugas telah dihapus. Untuk tugas yang ditetapkan, kolom ini bersifat hanya baca. Tugas tersebut hanya dapat dihapus dengan memanggil tasks.delete, yang akan menghapus tugas yang ditetapkan dan tugas asli (di Dokumen atau Ruang Chat). Untuk menghapus tugas yang ditetapkan saja, buka platform tugas dan batalkan penetapan tugas dari sana. Default-nya adalah Salah.
hidden

boolean

Tanda yang menunjukkan apakah tugas disembunyikan. Hal ini terjadi jika tugas telah ditandai selesai saat daftar tugas terakhir kali dihapus. Default-nya adalah Salah. Kolom ini bersifat hanya baca.
links[].type

string

Jenis link, misalnya "email", "generic", "chat_message", "keep_note".
links[].description

string

Deskripsi (mungkin kosong).
links[].link

string

URL.
assignmentInfo

object (AssignmentInfo)

Hanya output. Informasi konteks untuk tugas yang ditetapkan. Tugas dapat ditetapkan kepada pengguna, yang saat ini dapat dilakukan dari platform seperti Dokumen dan Ruang Chat. Kolom ini diisi untuk tugas yang ditetapkan kepada pengguna saat ini dan mengidentifikasi tempat tugas ditetapkan. Kolom ini bersifat hanya baca.

AssignmentInfo

Informasi tentang sumber penetapan tugas (Dokumen, Ruang Chat).

Representasi 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.
}
Kolom
surfaceType

enum (ContextType)

Hanya output. Jenis platform tempat tugas yang ditetapkan ini berasal. Saat ini dibatasi untuk DOKUMEN atau RUANG.
Kolom union surface_info. Informasi tentang platform (Dokumen, Ruang Chat) tempat tugas ini diberikan. surface_info hanya dapat berupa salah satu dari berikut:
driveResourceInfo

object (DriveResourceInfo)

Hanya output. Informasi tentang file Drive tempat tugas ini berasal. Saat ini, file Drive hanya dapat berupa dokumen. Kolom ini bersifat hanya baca.
spaceInfo

object (SpaceInfo)

Hanya output. Informasi tentang Ruang Chat tempat tugas ini berasal. Kolom ini bersifat hanya baca.

ContextType

Produk yang terkait dengan tugas.

Enum
CONTEXT_TYPE_UNSPECIFIED Nilai untuk konteks tugas ini tidak diketahui.
GMAIL Tugas dibuat dari Gmail.
DOCUMENT Tugas ditetapkan dari dokumen.
SPACE Tugas ditetapkan dari Ruang Chat.

DriveResourceInfo

Informasi tentang resource Drive tempat tugas ditetapkan (dokumen, sheet, dll.).

Representasi JSON 
{
  "driveFileId": string,
  "resourceKey": string
}
Kolom
driveFileId

string

Hanya output. ID file di Drive API.
resourceKey

string

Hanya output. Kunci resource yang diperlukan untuk mengakses file yang dibagikan melalui link bersama. Tidak diperlukan untuk semua file. Lihat juga developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Informasi tentang Ruang Chat tempat tugas diberikan.

Representasi JSON 
{
  "space": string
}
Kolom
space

string

Hanya output. Ruang Chat tempat tugas ini berasal. Formatnya adalah "spaces/{space}".

Metode

clear

 Menghapus semua tugas yang sudah selesai dari daftar tugas yang ditentukan.

delete

 Menghapus tugas yang ditentukan dari daftar tugas.

get

 Menampilkan tugas yang ditentukan.

insert

 Membuat tugas baru di daftar tugas yang ditentukan.

list

 Menampilkan semua tugas dalam daftar tugas yang ditentukan.

move

 Memindahkan tugas yang ditentukan ke posisi lain dalam daftar tugas tujuan.

patch

 Memperbarui tugas yang ditentukan.

update

 Memperbarui tugas yang ditentukan.