Method: notes.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Notları listeler.
Her liste çağrısı, döndürülen öğelerin üst sınırı olarak pageSize içeren bir sonuç sayfası döndürür. pageSize değeri sıfır olduğunda sunucu üst sınırı seçer.
ListNotesResponse en fazla pageSize giriş içerir. Listelenecek başka öğeler varsa nextPageToken değeri sağlanır. (Sayfa jetonları opak değerlerdir.)
Sonuçların bir sonraki sayfasını almak için sonucun nextPageToken değerini sonraki isteğin pageToken değerine kopyalayın. Sonuç sayfası döndürülen nextPageToken boş olana kadar işlemi tekrarlayın.
notes.list, eşzamanlı değişiklikler karşısında tutarlı sonuçlar döndürür veya ABORTED hatasıyla bunu yapamayacağını belirtir.
HTTP isteği
GET https://keep.googleapis.com/v1/notes
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler |
pageSize |
integer
Döndürülecek maksimum sonuç sayısı.
|
pageToken |
string
Önceki sayfanın nextPageToken alanı.
|
filter |
string
Liste sonuçlarını filtreleyin. Hiçbir filtre sağlanmazsa varsayılan olarak trashed filtresi uygulanır. Filtre uygulanabilecek geçerli alanlar: createTime, updateTime, trashTime ve trashed. Filtre söz dizimi, Google AIP filtreleme spesifikasyonuna uyar.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Not sayfası listelenirken verilen yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"notes": [
{
object (Note)
}
],
"nextPageToken": string
} |
| Alanlar |
notes[] |
object (Note)
Notlar sayfası.
|
nextPageToken |
string
Sonraki sayfanın pageToken alanı.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/keephttps://www.googleapis.com/auth/keep.readonly
Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
