REST Resource: tasks

Kaynak: Görev

JSON gösterimi
{
  "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)
  }
}
Alanlar
kind

string

Yalnızca çıkış. Kaynağın türü. Bu değer her zaman "tasks#task" şeklindedir.

id

string

Görev tanımlayıcısı.

etag

string

Kaynağın ETag'i.

title

string

Görevin başlığı. İzin verilen maksimum uzunluk: 1.024 karakter.

updated

string

Yalnızca çıkış. Görevin son değiştirilme zamanı (RFC 3339 zaman damgası olarak).

parent

string

Yalnızca çıkış. Üst görev tanımlayıcısı. Üst düzey bir görevse bu alan atlanır. Görevi farklı bir üst öğenin altına veya üst düzeye taşımak için "taşı" yöntemini kullanın. Üst görev hiçbir zaman atanmış bir görev (Chat alanları, Dokümanlar) olamaz. Bu alan salt okunur.

position

string

Yalnızca çıkış. Görevin, aynı üst görev altındaki veya üst düzeydeki kardeş görevleri arasındaki konumunu belirten dize. Bu dize, alfabetik sıralamaya göre başka bir görevin ilgili konum dizesinden daha büyükse görev, aynı üst görev altında (veya üst düzeyde) diğer görevin ardından konumlandırılır. Görevi başka bir konuma taşımak için "taşı" yöntemini kullanın.

notes

string

Görevi açıklayan notlar. Google Dokümanlar'dan atanan görevlerde not bulunamaz. İsteğe bağlı. İzin verilen maksimum uzunluk: 8.192 karakter.

status

string

Görevin durumu. Bu değer "needsAction" veya "completed" olmalıdır.

due

string

Görevin son tarihi (RFC 3339 zaman damgası olarak). İsteğe bağlı. Teslim tarihi yalnızca tarih bilgilerini kaydeder. Teslim tarihi belirlenirken zaman damgasının saat kısmı atlanır. API aracılığıyla bir görevin teslim tarihini okumak veya yazmak mümkün değildir.

completed

string

Görevin tamamlanma tarihi (RFC 3339 zaman damgası olarak). Görev tamamlanmadıysa bu alan atlanır.

deleted

boolean

Görevin silinip silinmediğini gösteren işaret. Atanmış görevler için bu alan salt okunurdur. Yalnızca tasks.delete çağrısı yapılarak silinebilir. Bu durumda hem atanan görev hem de orijinal görev (Dokümanlar veya Chat alanlarında) silinir. Yalnızca atanan görevi silmek için ödev yüzeyine gidin ve görevi buradan kaldırın. Varsayılan değer False'tır.

hidden

boolean

Görevin gizli olup olmadığını gösteren işaret. Görev listesi en son temizlendiğinde görev tamamlandı olarak işaretlenmişse bu durum söz konusudur. Varsayılan değer False'tır. Bu alan salt okunur.

links[].type

string

Bağlantının türü (ör. "email", "generic", "chat_message", "keep_note").

links[].description

string

Açıklama (boş olabilir).

links[].link

string

URL.

assignmentInfo

object (AssignmentInfo)

Yalnızca çıkış. Atanan görevlerle ilgili bağlam bilgileri. Kullanıcılara görev atanabilir. Bu işlem şu anda Dokümanlar ve Chat alanları gibi platformlardan yapılabilir. Bu alan, mevcut kullanıcıya atanan görevler için doldurulur ve görevin nereden atandığını tanımlar. Bu alan salt okunur.

AssignmentInfo

Görev atamasının kaynağı (Doküman, Chat Alanı) hakkında bilgi.

JSON gösterimi
{
  "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.
}
Alanlar
surfaceType

enum (ContextType)

Yalnızca çıkış. Atanmış bu görevin kaynağı olan yüzey türü. Şu anda DOCUMENT veya SPACE ile sınırlıdır.

Birlik alanı surface_info. Bu görevin atandığı platform (Dokümanlar, Chat alanları) hakkında bilgi. surface_info yalnızca aşağıdakilerden biri olabilir:
driveResourceInfo

object (DriveResourceInfo)

Yalnızca çıkış. Bu görevin kaynağı olan Drive dosyası hakkında bilgi. Şu anda Drive dosyası yalnızca doküman olabilir. Bu alan salt okunur.

spaceInfo

object (SpaceInfo)

Yalnızca çıkış. Bu görevin oluşturulduğu Chat alanı hakkında bilgi. Bu alan salt okunur.

ContextType

Görevle ilişkili ürün.

Sıralamalar
CONTEXT_TYPE_UNSPECIFIED Bu görevin bağlamı için bilinmeyen bir değer.
GMAIL Görev Gmail'den oluşturulur.
DOCUMENT Görev bir dokümandan atandıysa
SPACE Görev, bir Chat alanından atanmışsa

DriveResourceInfo

Görevin atandığı Drive kaynağı (doküman, e-tablo vb.) hakkında bilgiler.

JSON gösterimi
{
  "driveFileId": string,
  "resourceKey": string
}
Alanlar
driveFileId

string

Yalnızca çıkış. Drive API'deki dosyanın tanımlayıcısıdır.

resourceKey

string

Yalnızca çıkış. Paylaşılan bağlantı üzerinden paylaşılan dosyalara erişmek için gereken kaynak anahtarı. Tüm dosyalar için gerekli değildir. Ayrıca developers.google.com/drive/api/guides/resource-keys adresine de bakın.

SpaceInfo

Görevin atandığı Chat alanı hakkında bilgi.

JSON gösterimi
{
  "space": string
}
Alanlar
space

string

Yalnızca çıkış. Bu görevin oluşturulduğu Chat alanı. Biçim "spaces/{space}" şeklindedir.

Yöntemler

clear

Belirtilen görev listesinden tamamlanmış tüm görevleri temizler.

delete

Belirtilen görevi görev listesinden siler.

get

Belirtilen görevi döndürür.

insert

Belirtilen görev listesinde yeni bir görev oluşturur.

list

Belirtilen görev listesindeki tüm görevleri döndürür.

move

Belirtilen görevi hedef görev listesinde başka bir konuma taşır.

patch

Belirtilen görevi günceller.

update

Belirtilen görevi günceller.