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. Nilai ini selalu "tasks#task".
id

string

ID tugas.
etag

string

ETag resource.
title

string

Judul tugas. Panjang maksimum yang diizinkan: 1024 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 "pindahkan" untuk memindahkan tugas ke induk lain atau ke tingkat teratas. Tugas induk tidak boleh menjadi tugas yang ditetapkan (dari Ruang Chat, Dokumen). Kolom ini bersifat hanya baca.
position

string

Hanya output. String yang menunjukkan posisi tugas di antara tugas setaranya dalam tugas induk yang sama atau di tingkat teratas. Jika string ini lebih besar daripada string posisi tugas lain yang sesuai menurut pengurutan leksikografis, tugas akan diposisikan setelah tugas lain di 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. Nilainya adalah "needsAction" atau "completed".
due

string

Tanggal terjadwal untuk tugas (sebagai stempel waktu RFC 3339). Opsional. Ini menunjukkan hari tugas harus diselesaikan, atau hari tugas terlihat di petak kalender. Hal ini tidak menunjukkan tenggat waktu tugas. Hanya informasi tanggal yang dicatat; bagian waktu stempel waktu akan diabaikan saat menyetel kolom ini. Anda tidak dapat membaca atau menulis waktu tugas dijadwalkan menggunakan 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 ini hanya dapat dihapus dengan memanggil tasks.delete, yang dalam hal ini tugas yang ditetapkan dan tugas asli (di Ruang Dokumen atau Chat) akan dihapus. Untuk menghapus tugas yang ditetapkan saja, buka halaman tugas dan batalkan penetapan tugas dari sana. Defaultnya adalah False.
hidden

boolean

Tanda yang menunjukkan apakah tugas disembunyikan. Hal ini terjadi jika tugas telah ditandai sebagai selesai saat daftar tugas terakhir dihapus. Defaultnya adalah False. 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 diberikan 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 dari mana tugas tersebut ditetapkan. Kolom ini bersifat hanya baca.

AssignmentInfo

Informasi tentang sumber penugasan 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 terbatas pada DOCUMENT atau SPACE.
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, spreadsheet, dll.).

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

string

Hanya output. ID file di Drive API.
resourceKey

string

Hanya output. Kunci resource 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 ditetapkan.

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 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.