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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}
Campi
kind

string

Solo output. Il tipo di risorsa. Questo valore è sempre "tasks#task".
id

string

Identificatore dell'attività.
etag

string

ETag della risorsa.
title

string

Il titolo dell'attività. Lunghezza massima consentita: 1024 caratteri.
updated

string

Solo output. Data/ora ultima modifica dell'attività (come timestamp RFC 3339).
parent

string

Solo output. Identificatore dell'attività principale. Questo campo viene omesso se si tratta di un'attività di primo livello. Utilizza il metodo "Sposta" per spostare l'attività in un altro elemento principale o al primo livello. Un'attività principale non può mai essere un'attività assegnata (da spazi di Chat, Documenti). Questo campo è di sola lettura.
position

string

Solo output. Stringa che indica la posizione dell'attività tra le attività di pari livello nella stessa attività principale o a livello principale. Se questa stringa è maggiore della 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 al primo livello). Utilizza il metodo "Sposta" per spostare l'attività in un'altra posizione.
notes

string

Note che descrivono l'attività. Le attività assegnate da Documenti Google non possono avere note. Facoltativo. Lunghezza massima consentita: 8192 caratteri.
status

string

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

string

Data programmata per l'attività (come timestamp RFC 3339). Facoltativo. Rappresenta il giorno in cui l'attività deve essere completata o in cui è visibile nella griglia del calendario. Non rappresenta la scadenza dell'attività. Vengono registrate solo le informazioni sulla data; la parte relativa all'ora del timestamp viene eliminata quando viene impostato questo campo. Non è possibile leggere o scrivere l'ora in cui è pianificata un'attività utilizzando l'API.
completed

string

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

boolean

Flag che indica se l'attività è stata eliminata. Per le attività assegnate, questo campo è di sola lettura. Possono essere eliminate solo chiamando tasks.delete, nel qual caso vengono eliminate sia l'attività assegnata sia l'attività originale (in Documenti o negli spazi di Chat). Per eliminare solo l'attività assegnata, vai alla superficie del compito e annulla l'assegnazione dell'attività da lì. Il valore predefinito è False.
hidden

boolean

Flag che indica se l'attività è nascosta. Questo accade se l'attività era stata contrassegnata come completata l'ultima volta che l'elenco delle attività è stato cancellato. Il valore predefinito è False. Questo campo è di sola lettura.
links[].type

string

Tipo di link, ad esempio "email", "generico", "chat_message", "keep_note".
links[].description

string

La descrizione (potrebbe essere vuota).
links[].link

string

L'URL.
assignmentInfo

object (AssignmentInfo)

Solo output. Informazioni contestuali per le attività assegnate. Un'attività può essere assegnata a un utente, attualmente possibile da piattaforme come Documenti e spazi di Chat. Questo campo viene compilato per le attività assegnate all'utente corrente e identifica la posizione da cui è stata assegnata l'attività. Questo campo è di sola lettura.

AssignmentInfo

Informazioni sull'origine dell'assegnazione dell'attività (documento, spazio di Chat).

Rappresentazione JSON 
{
  "linkToTask": string,
  "surfaceType": enum (ContextType),

  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
}
Campi
surfaceType

enum (ContextType)

Solo output. Il tipo di superficie da cui ha origine questa attività assegnata. Al momento limitato a DOCUMENTO o SPAZIO.
Campo unione surface_info. Informazioni sulla piattaforma (Documenti, spazi di Chat) da cui è stata assegnata questa attività. surface_info può essere solo uno dei seguenti:
driveResourceInfo

object (DriveResourceInfo)

Solo output. Informazioni sul file di Drive da cui ha origine questa attività. Al momento, il file di Drive può essere solo un documento. Questo campo è di sola lettura.
spaceInfo

object (SpaceInfo)

Solo output. Informazioni sullo spazio di Chat da cui proviene questa attività. Questo campo è di sola lettura.

ContextType

Il prodotto associato all'attività.

Enum
CONTEXT_TYPE_UNSPECIFIED Valore sconosciuto per il contesto di questa attività.
GMAIL L'attività viene creata da Gmail.
DOCUMENT L'attività è assegnata da un documento.
SPACE L'attività viene assegnata da uno spazio di Chat.

DriveResourceInfo

Informazioni sulla risorsa di Drive da cui è stata assegnata un'attività (il documento, il foglio e così via).

Rappresentazione JSON 
{
  "driveFileId": string,
  "resourceKey": string
}
Campi
driveFileId

string

Solo output. Identificatore del file nell'API Drive.
resourceKey

string

Solo output. Chiave della risorsa necessaria per accedere ai file condivisi tramite un link condiviso. Non obbligatorio per tutti i file. Vedi anche developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Informazioni sullo spazio di Chat da cui è stata assegnata un'attività.

Rappresentazione JSON 
{
  "space": string
}
Campi
space

string

Solo output. Lo spazio di Chat da cui ha origine questa attività. Il formato è "spaces/{space}".

Metodi

clear

 Cancella tutte le attività completate dall'elenco delle 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 attività specificato.

move

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

patch

 Aggiorna l'attività specificata.

update

 Aggiorna l'attività specificata.