Użyj parametrów Listy zadań
Oprócz standardowych parametrów zapytania, których można używać z większością interfejsów API Google, dostępny jest też zestaw parametrów Listy zadań.
W tabeli poniżej znajdziesz podsumowanie parametrów żądań, które mają zastosowanie tylko do określonych operacji w Google Tasks API. Wszystkie wartości parametrów muszą być zakodowane na potrzeby adresu URL.
| Parametr |
Znaczenie |
Uwagi |
Obowiązywanie |
completedMax |
Górna granica daty zakończenia zadania (jako sygnatura czasowa RFC 3339), według której można filtrować dane. |
- Domyślny:
completedMax=2031-01-01
- Użyj formatu sygnatury czasowej RFC 3339. Na przykład:
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
Dolna granica daty zakończenia zadania (jako sygnatura czasowa RFC 3339), według której można filtrować dane. |
- Domyślny:
completedMin=1970-01-01
- Użyj formatu sygnatury czasowej RFC 3339. Na przykład:
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
Górna granica terminu oddania zadania (jako sygnatura czasowa RFC 3339), według której można filtrować dane. |
- Domyślny:
dueMax=2031-01-01
- Użyj formatu sygnatury czasowej RFC 3339. Na przykład:
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
Dolna granica terminu oddania zadania (jako sygnatura czasowa RFC 3339), według której można filtrować dane. |
- Domyślny:
dueMin=1970-01-01
- Użyj formatu sygnatury czasowej RFC 3339. Na przykład:
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
Maksymalna liczba elementów, które zostaną zwrócone w odpowiedzi na to żądanie. |
- Domyślny:
maxResults=20
- Maksymalna dozwolona wartość:
maxResults=100.
|
- Pobieranie list zadań użytkownika
- Pobieram zadania
|
pageToken |
Token określający stronę wyników do zwrócenia. |
- Domyślnie wyświetlana jest pierwsza strona.
|
- Pobieranie list zadań użytkownika
- Pobieram zadania
|
parent |
Podaj identyfikator nadrzędnego zadania zadania. |
- Brak parametrów oznacza wstawienie lub przeniesienie na najwyższy poziom listy zadań.
|
- Tworzenie zadania
- Zamawianie zadania
|
previous |
Podaj poprzedni identyfikator zadania. |
- Brak parametrów oznacza wstawienie lub przeniesienie na pierwszą pozycję na liście podrzędnej.
|
- Tworzenie zadania
- Zamawianie zadania
|
showCompleted |
Określ, czy wyświetlać ukończone zadania. |
- Domyślny:
showCompleted=true
|
|
showDeleted |
Określ, czy wyświetlać usunięte zadania. |
- Domyślny:
showDeleted=false
|
|
showHidden |
Określ, czy wyświetlać ukryte zadania. |
- Domyślny:
showHidden=true
|
|
updatedMin |
Dolna granica czasu ostatniej modyfikacji zadania (jako sygnatura czasowa RFC 3339), według której można filtrować. |
- Użyj formatu sygnatury czasowej RFC 3339. Na przykład:
2010-08-09T10:57:00.000-08:00Z.
- Ustawieniem domyślnym nie jest filtrowanie według czasu ostatniej modyfikacji.
|
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-09-03 UTC.
[null,null,["Ostatnia aktualizacja: 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"]]
