Method: notes.list

Wyświetla listę notatek.

Każde wywołanie listy zwraca stronę wyników z pageSize jako górną granicą zwracanych elementów. Wartość pageSize równa 0 pozwala serwerowi wybrać górną granicę.

Odpowiedź ListNotesResponse zawiera maksymalnie pageSize wpisów. Jeśli pozostało jeszcze więcej elementów do wylistowania, wartość nextPageToken jest podana. (tokeny strony to wartości nieprzezroczyste).

Aby uzyskać kolejną stronę wyników, skopiuj nextPageToken z wyników do pageToken w następnym żądaniu. Powtarzaj, aż nextPageToken zwróci pustą stronę wyników.

notes.list zwraca spójne wyniki w przypadku jednoczesnych zmian lub sygnalizuje, że nie może tego zrobić, wyświetlając błąd ABORTED.

Żądanie HTTP

GET https://keep.googleapis.com/v1/notes

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba wyników do zwrócenia.

pageToken

string

Pole nextPageToken na poprzedniej stronie.

filter

string

Filtrowanie wyników listy. Jeśli nie podasz filtra, domyślnie zostanie zastosowany filtr trashed. Dozwolone pola do filtrowania to: createTime, updateTime, trashTimetrashed.

Składnia filtra jest zgodna ze specyfikacją filtrowania AIP Google.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź podczas wyświetlania strony z notatkami.

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

Zapis JSON
{
  "notes": [
    {
      object (Note)
    }
  ],
  "nextPageToken": string
}
Pola
notes[]

object (Note)

strona z notatkami,

nextPageToken

string

Pole pageToken na następnej stronie.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

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