Method: tasks.list

Restituisce tutte le attività nell'elenco di attività specificato. Non restituisce le attività assegnate per impostazione predefinita (da Documenti, Spazi di Chat). Un utente può avere fino a 20.000 attività non nascoste per elenco e fino a 100.000 attività in totale alla volta.

Richiesta HTTP

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
tasklist

string

Identificatore dell'elenco di attività.

Parametri di query

Parametri
completedMax

string

Limite superiore relativo alla data di completamento di un'attività (come timestamp RFC 3339) in base al quale filtrare. (Facoltativo) L'impostazione predefinita non è filtrare in base alla data di completamento.

completedMin

string

Limite inferiore per la data di completamento di un'attività (come timestamp RFC 3339) in base al quale filtrare. (Facoltativo) L'impostazione predefinita non è filtrare in base alla data di completamento.

dueMax

string

Limite superiore della data di scadenza di un'attività (come timestamp RFC 3339) in base al quale filtrare. (Facoltativo) L'impostazione predefinita non è filtrare in base alla data di scadenza.

dueMin

string

Limite inferiore per la data di scadenza di un'attività (come timestamp RFC 3339) in base al quale filtrare. (Facoltativo) L'impostazione predefinita non è filtrare in base alla data di scadenza.

maxResults

integer

Numero massimo di attività restituite per una pagina. (Facoltativo) Il valore predefinito è 20 (numero massimo consentito: 100).

pageToken

string

Token che specifica la pagina dei risultati da restituire. (Facoltativo)

showCompleted

boolean

Flag che indica se nel risultato vengono restituite attività completate. Tieni presente che showHidden deve essere impostato su True anche per mostrare le attività completate nei client proprietari, ad esempio l'interfaccia utente web e le app mobile di Google. (Facoltativo) Il valore predefinito è True.

showDeleted

boolean

Flag che indica se nel risultato vengono restituite attività eliminate. (Facoltativo) Il valore predefinito è False.

showHidden

boolean

Contrassegno che indica se nel risultato vengono restituite attività nascoste. (Facoltativo) Il valore predefinito è False.

updatedMin

string

Limite inferiore relativo all'ora dell'ultima modifica di un'attività (come timestamp RFC 3339) in base al quale filtrare. (Facoltativo) Per impostazione predefinita, non è possibile filtrare in base all'ora dell'ultima modifica.

showAssigned

boolean

(Facoltativo) Contrassegno che indica se nel risultato vengono restituite attività assegnate all'utente corrente. (Facoltativo) Il valore predefinito è False.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Campi
kind

string

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

etag

string

ETag della risorsa.

nextPageToken

string

Token utilizzato per accedere alla pagina successiva di questo risultato.

items[]

object (Task)

Raccolta di attività.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

Tasks

Rappresentazione JSON
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Campi
kind

string

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

etag

string

ETag della risorsa.

nextPageToken

string

Token utilizzato per accedere alla pagina successiva di questo risultato.

items[]

object (Task)

Raccolta di attività.