REST Resource: tasks

Risorsa: attività

Rappresentazione 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
}
Campi
kind

string

Tipo della risorsa. Si tratta sempre di "attività#attività".

id

string

Identificatore dell'attività.

etag

string

ETag della risorsa.

title

string

Titolo dell'attività. Lunghezza massima consentita: 1024 caratteri.

updated

string

Data e ora dell'ultima modifica dell'attività (come timestamp RFC 3339).

parent

string

Identificatore dell'attività padre. Questo campo viene omesso se si tratta di un'attività di primo livello. Questo campo è di sola lettura. Utilizza il metodo "sposta" per spostare l'attività sotto un altro genitore o al livello superiore.

position

string

Stringa che indica la posizione dell'attività tra le relative attività gemelle nella stessa attività principale o al livello più alto. Se questa stringa è superiore alla stringa di posizione corrispondente di un'altra attività in base all'ordinamento lessicografico, l'attività viene posizionata dopo l'altra attività nella stessa attività principale (o nel livello superiore). Questo campo è di sola lettura. Utilizza il metodo "move" per spostare l'attività in un'altra posizione.

notes

string

Note che descrivono l'attività. Campo facoltativo. Lunghezza massima consentita: 8192 caratteri.

status

string

Stato dell'attività. Può essere "needsAction" o "completed".

due

string

Data di scadenza dell'attività (sotto forma di timestamp RFC 3339). Campo facoltativo. La data di scadenza registra solo le informazioni relative alla data; la parte dell'ora del timestamp viene ignorata quando si imposta la data di scadenza. Non è possibile leggere o scrivere l'ora di scadenza di un'attività tramite l'API.

completed

string

Data di completamento dell'attività (sotto forma di timestamp RFC 3339). Questo campo viene omesso se l'attività non è stata completata.

deleted

boolean

Flag che indica se l'attività è stata eliminata. Il valore predefinito è False.

hidden

boolean

Flag che indica se l'attività è nascosta. Questo avviene se l'attività è stata contrassegnata come completata al momento dell'ultima cancellazione dell'elenco. Il valore predefinito è False. Questo campo è di sola lettura.

links[].type

string

Tipo di link, ad esempio "email".

links[].description

string

La descrizione. Parlare in HTML: tutto ciò che è compreso tra <a> e </a>.

links[].link

string

L'URL.

Metodi

clear

Cancella tutte le attività completate dall'elenco di attività specificato.

delete

Elimina l'attività specificata dall'elenco delle attività.

get

Restituisce l'attività specificata.

insert

Crea una nuova attività nell'elenco di attività specificato.

list

Restituisce tutte le attività nell'elenco di attività specificato.

move

Sposta l'attività specificata in un'altra posizione nell'elenco di attività.

patch

Aggiorna l'attività specificata.

update

Aggiorna l'attività specificata.