Utilizzare i parametri delle attività
Oltre ai parametri di ricerca standard utilizzabili con la maggior parte delle API di Google, è disponibile un insieme di parametri di Tasks.
I parametri di richiesta che si applicano solo a operazioni specifiche dell'API Google Tasks sono riassunti nella tabella seguente. Tutti i valori dei parametri devono essere codificati nell'URL.
| Parametro |
Significato |
Note |
Applicabilità |
completedMax |
Limite superiore relativo alla data di completamento di un'attività (come timestamp RFC 3339) in base al quale filtrare. |
- URL predefinito:
completedMax=2031-01-01
- Utilizza il formato timestamp RFC 3339. Ad esempio:
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
Limite inferiore per la data di completamento di un'attività (come timestamp RFC 3339) in base al quale filtrare. |
- URL predefinito:
completedMin=1970-01-01
- Utilizza il formato timestamp RFC 3339. Ad esempio:
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
limite superiore relativo alla data di scadenza di un'attività (come timestamp RFC 3339) per filtrare. |
- URL predefinito:
dueMax=2031-01-01
- Utilizza il formato timestamp RFC 3339. Ad esempio:
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
Limite inferiore per la data di scadenza di un'attività (come timestamp RFC 3339) in base al quale filtrare. |
- URL predefinito:
dueMin=1970-01-01
- Utilizza il formato timestamp RFC 3339. Ad esempio:
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
Il numero massimo di elementi da restituire con questa richiesta. |
- URL predefinito:
maxResults=20
- Valore massimo consentito:
maxResults=100.
|
- Recupero degli elenchi di attività di un utente
- Recupero attività
|
pageToken |
Token che specifica la pagina dei risultati da restituire. |
- L'impostazione predefinita prevede la restituzione della prima pagina.
|
- Recupero degli elenchi di attività di un utente
- Recupero attività
|
parent |
Specifica l'ID dell'attività padre dell'attività. |
- Nessun parametro indica un inserimento o uno spostamento al livello superiore dell'elenco delle attività.
|
- Creare un'attività
- Ordine di un'attività
|
previous |
Specifica l'ID attività precedente dell'attività. |
- Nessun parametro indica un inserimento o uno spostamento nella prima posizione dell'elenco secondario.
|
- Creare un'attività
- Ordine di un'attività
|
showCompleted |
Specifica se mostrare o meno le attività completate. |
- URL predefinito:
showCompleted=true
|
|
showDeleted |
Specifica se mostrare o meno le attività eliminate. |
- URL predefinito:
showDeleted=false
|
|
showHidden |
Specifica se mostrare o meno le attività nascoste. |
- URL predefinito:
showHidden=true
|
|
updatedMin |
Limite inferiore per il tempo dell'ultima modifica di un'attività (come timestamp RFC 3339) per filtrare. |
- Utilizza il formato timestamp RFC 3339. Ad esempio:
2010-08-09T10:57:00.000-08:00Z.
- L'impostazione predefinita non prevede il filtro in base all'ora dell'ultima modifica.
|
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-09-03 UTC.
[null,null,["Ultimo aggiornamento 2024-09-03 UTC."],[[["In addition to standard query parameters, the Google Tasks API utilizes specific parameters for refined task management."],["These parameters control filtering by due dates, completion dates, modification times, and the visibility of completed, deleted, or hidden tasks."],["Developers can use these parameters to retrieve specific sets of tasks based on various criteria, such as completion status and due dates, using RFC 3339 timestamps for filtering."],["Parameters like `maxResults` and `pageToken` allow for pagination and control over the number of tasks returned in a response."],["The `parent` and `previous` parameters enable developers to manage task hierarchy and ordering within task lists."]]],["The Google Tasks API uses specific parameters for operations, all of which require URL encoding. These parameters filter tasks by `completedMin/Max`, `dueMin/Max`, and `updatedMin` date ranges using RFC 3339 timestamps. `maxResults` limits the number of returned items, and `pageToken` specifies the result page. `parent` and `previous` parameters determine task order, while `showCompleted`, `showDeleted`, and `showHidden` control the visibility of tasks. These parameters apply to retrieving tasks and task lists, creating, and ordering tasks.\n"]]
