REST Resource: tasks

Recurso: Task

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. Tamanho 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 pai. Esse campo é omitido se for uma tarefa de nível superior. Use a opção "mover" para mover a tarefa para um pai diferente ou para o nível superior. Uma tarefa mãe nunca pode ser atribuída nos espaços do Chat e nos Documentos Google. 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 ordenação lexicográfica, a tarefa será posicionada depois da outra tarefa na mesma tarefa pai (ou no nível superior). Use a opção "mover" para mover a tarefa para outra posição.
notes

string

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

string

Status da tarefa. É "needsAction" ou "concluído".
due

string

Data de conclusão da tarefa (como um carimbo de data/hora RFC 3339). Opcional. A data de vencimento registra apenas as informações de data. a parte de hora do carimbo de data/hora é descartada ao definir a data de conclusão. Não é possível ler ou gravar o horário de vencimento 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 foi concluída.
deleted

boolean

Sinalização que indica se a tarefa foi excluída. Para tarefas atribuídas, este 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 nos espaços do Chat) são excluídas. Para excluir apenas a tarefa atribuída, acesse a plataforma de atribuição e remova a atribuição. O valor padrão é falso.
hidden

boolean

Sinalizador que indica se a tarefa está oculta. Esse é o caso se a tarefa tiver sido marcada como concluída quando a lista de tarefas foi apagada pela última vez. O valor padrão é falso. Este campo é somente leitura.
links[].type

string

Tipo de link, por exemplo, "e-mail".
links[].description

string

A descrição. Em HTML, tudo o que está entre <a> e </a>.
links[].link

string

O URL.
assignmentInfo

object (AssignmentInfo)

Apenas saída. Informações de contexto para tarefas atribuídas. É possível atribuir uma tarefa a um usuário em plataformas como os Documentos Google e os espaços do Chat. Esse campo é preenchido para tarefas atribuídas ao usuário atual e identifica de onde elas foram atribuídas. 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 plataforma de origem da tarefa atribuída. No momento, limitado a DOCUMENT ou SPACE.
Campo de união surface_info. Informações sobre a plataforma (Documentos, Espaços do Chat) em que esta 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 desta tarefa. No momento, o arquivo do Google 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 desta 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 foi atribuída com base em um documento.
SPACE A tarefa é atribuída em um espaço do Chat.

DriveResourceInfo

Informações sobre o recurso do Drive de onde uma tarefa foi atribuída (o documento, a 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 de onde uma tarefa foi atribuída.

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

string

Apenas saída. O espaço do Chat de origem desta 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.