Method: tasks.list

Zwraca wszystkie zadania z określonej listy zadań. nie zwraca domyślnie przypisanych zadań (z Dokumentów, Pokojów czatu). Na liście może znajdować się do 20 000 nieukrytych zadań i do 100 000 zadań łącznie.

Żą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 zakończenia zadania (jako sygnatura czasowa RFC 3339), według której ma być filtrowana. Opcjonalnie. Domyślnie nie jest filtrowane według daty zakończenia.

completedMin

string

Dolna granica daty zakończenia zadania (jako sygnatura czasowa RFC 3339), według której ma być filtrowana. Opcjonalnie. Domyślnie nie jest filtrowane według daty zakończenia.

dueMax

string

Górna granica terminu zakończenia zadania (jako sygnatura czasowa RFC 3339), według której ma być filtrowany. Opcjonalnie. Domyślnie nie jest ono filtrowane według terminu.

dueMin

string

Dolna granica terminu zakończenia zadania (jako sygnatura czasowa RFC 3339), według której ma być filtrowany. Opcjonalnie. Domyślnie nie jest ono filtrowane według terminu.

maxResults

integer

Maksymalna liczba zadań zwróconych na jednej stronie. Opcjonalnie. Wartość domyślna to 20 (maks. dozwolona: 100).

pageToken

string

Token określający stronę wyników do zwrócenia. Opcjonalnie.

showCompleted

boolean

Flaga z informacją, czy w wyniku są zwracane ukończone zadania. Aby wyświetlać zadania ukończone we własnych klientach, takie jak interfejs internetowy czy aplikacje mobilne Google, musi też mieć wartość True. Opcjonalnie. Wartość domyślna to Prawda.

showDeleted

boolean

Flaga z informacją, czy w wyniku są zwracane usunięte zadania. Opcjonalnie. Wartość domyślna to Fałsz.

showHidden

boolean

Flaga z informacją, czy w wyniku są zwracane ukryte zadania. Opcjonalnie. Wartość domyślna to Fałsz.

updatedMin

string

Dolna granica czasu ostatniej modyfikacji zadania (jako sygnatura czasowa RFC 3339), według którego ma być filtrowana. Opcjonalnie. Domyślnie filtrowanie według czasu ostatniej modyfikacji nie jest filtrowane.

showAssigned

boolean

Opcjonalnie. Flaga z informacją, czy w wyniku są zwracane zadania przypisane do bieżącego użytkownika. Opcjonalnie. Wartość domyślna to 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. To zawsze „tasks#tasks”.

etag

string

Tag ETag zasobu.

nextPageToken

string

Token użyty do uzyskania dostępu do następnej strony tego wyniku.

items[]

object (Task)

Kolekcja zadań.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

Lista zadań

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

string

Typ zasobu. To zawsze „tasks#tasks”.

etag

string

Tag ETag zasobu.

nextPageToken

string

Token użyty do uzyskania dostępu do następnej strony tego wyniku.

items[]

object (Task)

Kolekcja zadań.