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. Tipo di 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

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

string

Solo output. Identificatore dell'attività padre. Questo campo viene omesso se si tratta di un'attività di primo livello. Usa lo "spostamento" per spostare l'attività sotto un altro account principale o al livello superiore. Un'attività genitore non può mai essere assegnata (da Spazi di Chat o Documenti). Questo campo è di sola lettura.
position

string

Solo output. Stringa che indica la posizione dell'attività tra le attività di pari livello all'interno della stessa attività principale o al livello superiore. Se questa stringa è maggiore della stringa della posizione corrispondente di un'altra attività in base all'ordine lessicografico, l'attività viene posizionata dopo l'altra attività all'interno della stessa attività principale (o al livello superiore). Usa lo "spostamento" 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 "completato".
due

string

Data di scadenza dell'attività (come timestamp RFC 3339). (Facoltativo) La data di scadenza registra solo le informazioni relative alla data; la parte relativa all'ora del timestamp viene ignorata al momento dell'impostazione della 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à (come timestamp RFC 3339). Questo campo viene omesso se l'attività non è stata completata.
deleted

boolean

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

boolean

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

string

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

string

La descrizione. Pronuncia in HTML: tutto quello che c'è tra <a> e </a>.
links[].link

string

L'URL.
assignmentInfo

object (AssignmentInfo)

Solo output. Informazioni di contesto 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 indica da dove è 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),

  // 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.
}
Campi
surfaceType

enum (ContextType)

Solo output. Il tipo di piattaforma da cui ha origine l'attività assegnata. Attualmente limitato a DOCUMENT o SPACE.
Campo unione surface_info. Informazioni sulla piattaforma (Documenti, Spazi di Chat) da cui è stata assegnata l'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à. Attualmente, 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 ha origine 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à viene assegnata da un documento.
SPACE L'attività viene assegnata da uno spazio di Chat.

DriveResourceInfo

Informazioni sulla risorsa 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. È necessaria una chiave della risorsa per accedere ai file condivisi tramite un link condiviso. Non obbligatorio per tutti i file. Vedi anche developer.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 di attività specificato.

delete

 Elimina l'attività specificata dall'elenco di 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à di destinazione.

patch

 Aggiorna l'attività specificata.

update

 Aggiorna l'attività specificata.