REST Resource: tasks

Recurso: tarefa

Representação 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)
  }
}
Campos
kind

string

Apenas saída. Tipo do recurso. É sempre "tasks#task".
id

string

Identificador da tarefa.
etag

string

ETag do recurso.
title

string

Título da tarefa. Comprimento máximo permitido: 1.024 caracteres.
updated

string

Apenas saída. Hora da última modificação da tarefa (como um carimbo de data/hora RFC 3339).
parent

string

Apenas saída. Identificador da tarefa mãe. Esse campo é omitido se for uma tarefa de nível superior. Use o método "move" para mover a tarefa para um pai diferente ou para o nível superior. Uma tarefa pai nunca pode ser uma tarefa atribuída (de espaços do Chat, Documentos). Este campo é somente leitura.
position

string

Apenas saída. String que indica a posição da tarefa entre as tarefas irmãs na mesma tarefa pai ou no nível superior. Se essa string for maior que a string de posição correspondente de outra tarefa de acordo com a ordem alfabética, a tarefa será posicionada após a outra na mesma tarefa pai (ou no nível superior). Use o método "move" para mover a tarefa para outra posição.
notes

string

Anotações que descrevem a tarefa. As tarefas atribuídas nos Documentos Google não podem ter notas. Opcional. Comprimento máximo permitido: 8.192 caracteres.
status

string

Status da tarefa. Pode ser "needsAction" ou "completed".
due

string

Data de vencimento da tarefa (como um carimbo de data/hora RFC 3339). Opcional. A data de vencimento só registra informações de data. A parte de hora do carimbo de data/hora é descartada ao definir a data de vencimento. Não é possível ler ou gravar o prazo de uma tarefa pela API.
completed

string

Data de conclusão da tarefa (como um carimbo de data/hora RFC 3339). Esse campo é omitido se a tarefa não tiver sido concluída.
deleted

boolean

Flag que indica se a tarefa foi excluída. Para tarefas atribuídas, esse campo é somente leitura. Elas só podem ser excluídas chamando tasks.delete. Nesse caso, a tarefa atribuída e a tarefa original (nos Documentos ou espaços de chat) são excluídas. Para excluir apenas a tarefa atribuída, acesse a página de atribuição e cancele a atribuição dela. O valor padrão é falso.
hidden

boolean

Flag que indica se a tarefa está oculta. Isso acontece se a tarefa foi marcada como concluída quando a lista de tarefas foi limpa pela última vez. O valor padrão é falso. Este campo é somente leitura.
links[].type

string

Tipo de link, por exemplo, "email", "generic", "chat_message", "keep_note".
links[].description

string

A descrição (pode estar vazia).
links[].link

string

O URL.
assignmentInfo

object (AssignmentInfo)

Apenas saída. Informações contextuais sobre tarefas atribuídas. Uma tarefa pode ser atribuída a um usuário, atualmente em plataformas como Documentos e Espaços do Chat. Esse campo é preenchido para tarefas atribuídas ao usuário atual e identifica de onde a tarefa foi atribuída. Este campo é somente leitura.

AssignmentInfo

Informações sobre a origem da atribuição da tarefa (documento, espaço do Chat).

Representação 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.
}
Campos
surfaceType

enum (ContextType)

Apenas saída. O tipo de superfície de origem da tarefa atribuída. No momento, isso é limitado a DOCUMENT ou SPACE.
Campo de união surface_info. Informações sobre a plataforma (Documentos, Espaços do Chat) em que a tarefa foi atribuída. surface_info pode ser apenas de um dos tipos a seguir:
driveResourceInfo

object (DriveResourceInfo)

Apenas saída. Informações sobre o arquivo do Drive de origem da tarefa. No momento, o arquivo do Drive só pode ser um documento. Este campo é somente leitura.
spaceInfo

object (SpaceInfo)

Apenas saída. Informações sobre o espaço do Chat de origem da tarefa. Este campo é somente leitura.

ContextType

O produto associado à tarefa.

Enums
CONTEXT_TYPE_UNSPECIFIED Valor desconhecido para o contexto desta tarefa.
GMAIL A tarefa é criada no Gmail.
DOCUMENT A tarefa é atribuída em um documento.
SPACE A tarefa é atribuída em um espaço do Chat.

DriveResourceInfo

Informações sobre o recurso do Drive em que uma tarefa foi atribuída (documento, planilha etc.).

Representação JSON 
{
  "driveFileId": string,
  "resourceKey": string
}
Campos
driveFileId

string

Apenas saída. Identificador do arquivo na API Drive.
resourceKey

string

Apenas saída. Chave de recurso necessária para acessar arquivos compartilhados por um link compartilhado. Não é obrigatório para todos os arquivos. Consulte também developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Informações sobre o espaço do Chat em que uma tarefa foi atribuída.

Representação JSON 
{
  "space": string
}
Campos
space

string

Apenas saída. O espaço do Chat de origem da tarefa. O formato é "spaces/{space}".

Métodos

clear

 Limpa todas as tarefas concluídas da lista de tarefas especificada.

delete

 Exclui a tarefa especificada da lista de tarefas.

get

 Retorna a tarefa especificada.

insert

 Cria uma nova tarefa na lista de tarefas especificada.

list

 Retorna todas as tarefas na lista de tarefas especificada.

move

 Move a tarefa especificada para outra posição na lista de tarefas de destino.

patch

 Atualiza a tarefa especificada.

update

 Atualiza a tarefa especificada.