Method: notes.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan catatan.
Setiap panggilan daftar menampilkan halaman hasil dengan pageSize sebagai batas atas item yang ditampilkan. pageSize nol memungkinkan server memilih batas atas.
ListNotesResponse berisi maksimal pageSize entri. Jika masih ada hal lain yang perlu dicantumkan, nilai nextPageToken akan diberikan. (Token halaman adalah nilai buram.)
Untuk mendapatkan halaman hasil berikutnya, salin nextPageToken hasil ke pageToken permintaan berikutnya. Ulangi hingga nextPageToken yang ditampilkan dengan halaman hasil kosong.
notes.list menampilkan hasil yang konsisten saat menghadapi perubahan serentak, atau memberikan sinyal bahwa tidak dapat melakukannya dengan error ABORTED.
Permintaan HTTP
GET https://keep.googleapis.com/v1/notes
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
| Parameter |
pageSize |
integer
Jumlah hasil maksimum yang akan ditampilkan.
|
pageToken |
string
Kolom nextPageToken halaman sebelumnya.
|
filter |
string
Memfilter hasil daftar. Jika tidak ada filter yang diberikan, filter trashed akan diterapkan secara default. Kolom yang valid untuk difilter adalah: createTime, updateTime, trashTime, dan trashed. Sintaksis filter mengikuti spesifikasi pemfilteran AIP Google.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Respons saat mencantumkan halaman catatan.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"notes": [
{
object (Note)
}
],
"nextPageToken": string
} |
| Kolom |
notes[] |
object (Note)
Halaman catatan.
|
nextPageToken |
string
Kolom pageToken halaman berikutnya.
|
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/keephttps://www.googleapis.com/auth/keep.readonly
Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[],[],null,["# Method: notes.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListNotesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nLists notes.\n\nEvery list call returns a page of results with `pageSize` as the upper bound of returned items. A `pageSize` of zero allows the server to choose the upper bound.\n\nThe ListNotesResponse contains at most `pageSize` entries. If there are more things left to list, it provides a `nextPageToken` value. (Page tokens are opaque values.)\n\nTo get the next page of results, copy the result's `nextPageToken` into the next request's `pageToken`. Repeat until the `nextPageToken` returned with a page of results is empty.\n\nnotes.list return consistent results in the face of concurrent changes, or signals that it cannot with an ABORTED error.\n\n### HTTP request\n\n`GET https://keep.googleapis.com/v1/notes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of results to return. |\n| `pageToken` | `string` The previous page's `nextPageToken` field. |\n| `filter` | `string` Filter for list results. If no filter is supplied, the `trashed` filter is applied by default. Valid fields to filter by are: `createTime`, `updateTime`, `trashTime`, and `trashed`. Filter syntax follows the [Google AIP filtering spec](https://aip.dev/160). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response when listing a page of notes.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------|\n| ``` { \"notes\": [ { object (/workspace/keep/api/reference/rest/v1/notes#Note) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------|\n| `notes[]` | `object (`[Note](/workspace/keep/api/reference/rest/v1/notes#Note)`)` A page of notes. |\n| `nextPageToken` | `string` Next page's `pageToken` field. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/keep`\n- `https://www.googleapis.com/auth/keep.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
