Method: notes.list

Listet Notizen auf.

Jeder Listenaufruf gibt eine Seite mit Ergebnissen zurück, wobei pageSize die Obergrenze der zurückgegebenen Elemente ist. Bei einem pageSize von null kann der Server die Obergrenze auswählen.

Die ListNotesResponse enthält höchstens pageSize Einträge. Wenn noch weitere Elemente aufgeführt werden müssen, wird der Wert nextPageToken zurückgegeben. Seiten-Token sind nicht transparente Werte.

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

notes.list gibt bei gleichzeitigen Änderungen konsistente Ergebnisse zurück oder signalisiert mit einem ABORTED-Fehler, dass dies 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

Filtern Sie nach Listenergebnissen. Wenn kein Filter angegeben ist, wird standardmäßig der Filter trashed angewendet. Gültige Felder, nach denen gefiltert werden kann, sind createTime, updateTime, trashTime und trashed.

Die Filtersyntax folgt der Google AIP-Filter-Spezifikation.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwort, wenn eine Notizseite aufgelistet wird.

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.