Method: notes.list

Listet Notizen auf

Jeder Listenaufruf gibt eine Ergebnisseite mit pageSize als Obergrenze der zurückgegebenen Elemente zurück. Bei pageSize von null kann der Server die Obergrenze auswählen.

Die ListNotesResponse enthält höchstens pageSize Einträge. Wenn mehr Einträge aufgelistet werden müssen, wird ein nextPageToken-Wert angezeigt. (Seitentokens sind undurchsichtige Werte.)

Wenn Sie die nächste Ergebnisseite sehen möchten, kopieren Sie den nextPageToken des Ergebnisses in die pageToken der nächsten Anfrage. Wiederholen Sie diesen Vorgang, bis nextPageToken mit einer Ergebnisseite zurückgegeben wird.

„notes.list“ liefert konsistente Ergebnisse bei gleichzeitigen Änderungen oder Signalen, die bei einem ABORTED-Fehler nicht berücksichtigt werden können.

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 Google AIP-Filterspezifikation.

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 auf 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.