Method: notes.list

Listet Notizen auf.

Bei jedem Listenaufruf wird eine Seite mit Ergebnissen mit pageSize als Obergrenze für die zurückgegebenen Elemente zurückgegeben. Bei pageSize von null kann der Server die Obergrenze auswählen.

ListNotesResponse enthält höchstens pageSize Einträge. Wenn es noch mehr Dinge gibt, die aufgelistet werden müssen, wird ein nextPageToken-Wert bereitgestellt. Seitentokens sind intransparente Werte.

Kopiere den nextPageToken des Ergebnisses in den pageToken der nächsten Anfrage, um zur nächsten Ergebnisseite zu gelangen. Wiederholen Sie den Vorgang, bis das nextPageToken, das mit einer Seite mit Ergebnissen zurückgegeben wird, leer ist.

Notes.list gibt bei gleichzeitigen Änderungen konsistente Ergebnisse zurück oder signalisiert, dass dies mit dem Fehler ABORTED nicht möglich ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
pageSize

integer

Die maximale Anzahl von zurückzugebenden Ergebnissen.

pageToken

string

Das Feld nextPageToken der vorherigen Seite.

filter

string

Nach Listenergebnissen filtern. Wenn kein Filter angegeben ist, wird standardmäßig der Filter trashed angewendet. Gültige Felder zum Filtern sind: createTime, updateTime, trashTime und trashed.

Die Filtersyntax entspricht der Spezifikation für die AIP-Filterung von Google.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwort beim Auflisten einer Seite mit Notizen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "notes": [
    {
      object (Note)
    }
  ],
  "nextPageToken": string
}
Felder
notes[]

object (Note)

Eine Seite mit Notizen.

nextPageToken

string

Das Feld pageToken der nächsten Seite.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.