REST Resource: tasks

Resource: Tugas

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. Hal ini selalu disebut "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 atas. Menggunakan "pindahkan" untuk memindahkan tugas di bawah induk yang berbeda atau ke tingkat teratas. Tugas induk tidak dapat menjadi tugas yang diberikan (dari Ruang Chat, Dokumen). Kolom ini bersifat hanya baca.

position

string

Hanya output. String yang menunjukkan posisi tugas di antara tugas yang seinduknya di bawah tugas induk yang sama atau di level teratas. Jika string ini lebih besar dari string posisi tugas yang sesuai menurut urutan leksikografis, tugas akan diposisikan setelah tugas lain di bawah tugas induk yang sama (atau di level teratas). Menggunakan "pindahkan" untuk memindahkan tugas ke posisi lain.

notes

string

Catatan yang menjelaskan tugas. Tugas yang diberikan dari Google Dokumen tidak dapat memiliki catatan. Opsional. Panjang maksimum yang diizinkan: 8.192 karakter.

status

string

Status tugas. Ini bisa berupa "needsAction" atau "selesai".

due

string

Batas waktu tugas (sebagai stempel waktu RFC 3339). Opsional. Batas waktu hanya mencatat informasi tanggal; bagian waktu stempel waktu akan dihapus saat menyetel batas waktu. Tidak mungkin untuk membaca atau menulis waktu tenggat tugas tugas melalui API.

completed

string

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

deleted

boolean

Tanda yang menunjukkan apakah tugas telah dihapus. Untuk tugas yang diberikan, kolom ini bersifat hanya baca. Tugas hanya dapat dihapus dengan memanggil tugas.delete. Dalam hal ini, tugas yang diberikan dan tugas asli (di Dokumen atau Ruang Chat) akan dihapus. Untuk menghapus tugas yang diberikan saja, buka platform tugas dan batalkan penetapan tugas dari sana. Defaultnya adalah Salah.

hidden

boolean

Tanda yang menunjukkan apakah tugas disembunyikan atau tidak. Hal ini dapat terjadi jika tugas telah ditandai selesai saat daftar tugas terakhir dihapus. Defaultnya adalah Salah. Kolom ini bersifat hanya baca.

links[].type

string

Jenis link, mis. "email".

links[].description

string

Deskripsi. Dalam HTML, ucapkan: Semuanya di antara <a> dan </a>.

links[].link

string

URL.

assignmentInfo

object (AssignmentInfo)

Hanya output. Informasi konteks untuk tugas yang diberikan. Tugas dapat ditetapkan kepada pengguna, yang saat ini dapat dilakukan dari platform seperti Dokumen dan Ruang Chat. Kolom ini diisi untuk tugas yang diberikan kepada pengguna saat ini dan mengidentifikasi tempat asal tugas tersebut. 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 asal tugas yang diberikan. Saat ini terbatas untuk DOCUMENT atau SPACE.

Kolom union surface_info. Informasi tentang platform (Dokumen, Ruang Chat) tempat tugas ini ditetapkan. 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 tidak diketahui untuk konteks tugas ini.
GMAIL Tugas dibuat dari Gmail.
DOCUMENT Tugas diberikan 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 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 "spasi/{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.