Method: tasks.list

Zwraca wszystkie zadania na określonej liście zadań. Nie zwraca przypisanych zadań domyślnie (z Dokumentów lub pokojów czatu). Użytkownik może mieć maksymalnie 20 tys. nieukrytych zadań na liście i łącznie maksymalnie 100 tys. zadań.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
tasklist

string

Identyfikator listy zadań.

Parametry zapytania

Parametry
completedMax

string

Górna granica daty ukończenia zadania (jako sygnatura czasowa RFC 3339), według której można filtrować. Opcjonalnie: Domyślnie nie filtruje według daty zakończenia.

completedMin

string

Dolny limit daty ukończenia zadania (jako sygnatura czasowa zgodna ze standardem RFC 3339), według której można filtrować. Opcjonalnie: Domyślnie nie filtruje według daty zakończenia.

dueMax

string

Górna granica terminu wykonania zadania (jako sygnatura czasowa RFC 3339), według której można filtrować. Opcjonalnie: Domyślnie nie można filtrować według terminu.

dueMin

string

Dolna granica terminu wykonania zadania (jako sygnatura czasowa RFC 3339), według której można filtrować. Opcjonalnie: Domyślnie nie można filtrować według terminu.

maxResults

integer

Maksymalna liczba zadań zwracanych na jednej stronie. Opcjonalnie: Wartość domyślna to 20 (maksymalnie dozwolona wartość to 100).

pageToken

string

Token określający stronę z wynikami, która ma zostać zwrócona. Opcjonalnie:

showCompleted

boolean

Flaga wskazująca, czy w wyniku zwracane są ukończone zadania. Pamiętaj, że aby wyświetlać zadania wykonane w kliencie własnym, np. w interfejsie internetowym i aplikacjach mobilnych Google, musisz też ustawić wartość showHidden na prawdę. Opcjonalnie: Wartość domyślna to True.

showDeleted

boolean

Flaga wskazująca, czy usunięte zadania są zwracane w wyniku. Opcjonalnie: Wartość domyślna to False (fałsz).

showHidden

boolean

Flaga wskazująca, czy ukryte zadania są zwracane w wyniku. Opcjonalnie: Wartość domyślna to False (fałsz).

updatedMin

string

Dolna granica czasu ostatniej modyfikacji zadania (jako sygnatura czasowa zgodna ze specyfikacją RFC 3339), według której można filtrować. Opcjonalnie: Domyślnie nie filtruje według czasu ostatniej modyfikacji.

showAssigned

boolean

Opcjonalnie: Flaga wskazująca, czy w wyniku zwracane są zadania przypisane do bieżącego użytkownika. Opcjonalnie: Wartość domyślna to False (fałsz).

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

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

string

Typ zasobu. Zawsze jest to „tasks#tasks”.

etag

string

ETag zasobu.

nextPageToken

string

Token używany do uzyskiwania dostępu do następnej strony z tymi wynikami.

items[]

object (Task)

Kolekcja zadań.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.

Zadania

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

string

Typ zasobu. Zawsze jest to „tasks#tasks”.

etag

string

ETag zasobu.

nextPageToken

string

Token używany do uzyskiwania dostępu do następnej strony z tymi wynikami.

items[]

object (Task)

Kolekcja zadań.