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. È sempre "tasks#task".
id

string

Identificatore dell'attività.
etag

string

ETag della risorsa.
title

string

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

string

Solo output. Data e ora dell'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 "move" per spostare l'attività in un elemento principale diverso o al livello superiore. Un'attività principale non può mai essere un'attività assegnata (dagli spazi di Chat, da Documenti). Questo campo è di sola lettura.
position

string

Solo output. Stringa che indica la posizione dell'attività tra le attività correlate nella stessa attività principale o a livello superiore. Se questa stringa è maggiore della stringa di posizione corrispondente di un'altra attività in base all'ordinamento alfabetico, l'attività viene posizionata dopo l'altra attività nella stessa attività principale (o a livello superiore). Utilizza il metodo "move" 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 di scadenza dell'attività (come timestamp RFC 3339). Facoltativo. La data di scadenza registra solo le informazioni sulla data; la parte relativa all'ora del timestamp viene ignorata quando viene impostata la data di scadenza. Non è possibile leggere o scrivere la data 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

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 piattaforma di assegnazione e annulla l'assegnazione. Il valore predefinito è False.
hidden

boolean

Flag che indica se l'attività è nascosta. Questo accade se l'attività è 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", "generic", "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. È possibile assegnare un'attività a un utente, attualmente da piattaforme come Documenti e spazi di Chat. Questo campo viene compilato per le attività assegnate all'utente corrente e identifica la sorgente dell'assegnazione. 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 proviene l'attività assegnata. Attualmente limitato a DOCUMENT o SPACE.
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 avuto 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 ha avuto 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à è 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à (documento, 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 richiesta per accedere ai file condivisi tramite un link condiviso. Non obbligatorio per tutti i file. Consulta 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 di attività specificato.

delete

 Consente di eliminare 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.