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" olur.
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ı. Bu alan, üst düzey bir görevse çıkarılır. Görevi farklı bir üst öğenin altına veya en üst düzeye taşımak için "taşı" yöntemini kullanın. Bir üst görev hiçbir zaman atanmış görev (Chat alanlarından, Dokümanlar'dan) olamaz. Bu alan salt okunurdur.
position

string

Yalnızca çıkış. Görevin, aynı üst görev altındaki kardeş görevler arasındaki veya en üst düzeydeki konumunu gösteren dize. Bu dize, sözlük sırasına göre başka bir görevin karşılık gelen konum dizesinden daha büyükse görev, aynı üst görev altındaki diğer görevden sonra (veya en üst düzeyde) 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örevlere not eklenemez. İsteğe bağlıdır. İzin verilen maksimum uzunluk: 8.192 karakter.
status

string

Görevin durumu. Bu değer "needsAction" (işlem gerekiyor) veya "completed" (tamamlandı) olur.
due

string

Görevin planlanan tarihi (RFC 3339 zaman damgası olarak). İsteğe bağlıdır. Bu, görevin yapılması gereken günü veya takvim tablosunda göründüğü günü gösterir. Bu tarih, görevin son tarihini göstermez. Yalnızca tarih bilgileri kaydedilir. Bu alan ayarlanırken zaman damgasının zaman kısmı atılır. API kullanılarak bir görevin planlandığı zaman okunamıyor veya yazılamıyor.
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. Bu alan, atanmış görevler için salt okunurdur. Bu görevler yalnızca tasks.delete çağrı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örevin atamasını kaldırın. Varsayılan değer False'tur.
hidden

boolean

Görevin gizli olup olmadığını gösteren işaret. Bu durum, görev listesi en son temizlendiğinde görevin tamamlandı olarak işaretlenmiş olması halinde geçerlidir. Varsayılan değer False'tur. Bu alan salt okunurdur.
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. Görevler, kullanıcılara atanabilir. Bu özellik şu anda Dokümanlar ve Chat alanları gibi ortamlarda kullanılabilir. Bu alan, mevcut kullanıcıya atanan görevler için doldurulur ve görevin nereden atandığını tanımlar. Bu alan salt okunurdur.

AssignmentInfo

Görev atamasının kaynağı (doküman, Chat alanı) hakkında bilgiler.

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ış. Bu atanan görevin kaynaklandığı yüzey türü. Şu anda yalnızca BELGE veya ALAN ile sınırlıdır.
surface_info birleşik alanı. Bu görevin atandığı yüzey (Dokümanlar, Chat alanları) hakkında bilgiler. surface_info aşağıdakilerden yalnızca biri olabilir:
driveResourceInfo

object (DriveResourceInfo)

Yalnızca çıkış. Bu görevin oluşturulduğu Drive dosyasıyla ilgili bilgiler. Şu anda Drive dosyası yalnızca doküman olabilir. Bu alan salt okunurdur.
spaceInfo

object (SpaceInfo)

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

ContextType

Görevle ilişkili ürün.

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

DriveResourceInfo

Bir görevin atandığı Drive kaynağı (doküman, sayfa vb.) hakkındaki bilgiler.

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

string

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

string

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

SpaceInfo

Bir görevin atandığı Chat alanı hakkında bilgiler.

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 listesindeki tüm tamamlanmış 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.