Method: notes.list
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
メモを一覧表示します。
リスト呼び出しごとに、返されるアイテムの上限として pageSize
を含む結果ページが返されます。pageSize
を 0 にすると、サーバーが上限を選択できます。
ListNotesResponse には最大 pageSize
個のエントリが含まれます。一覧表示する項目がさらにある場合は、nextPageToken
値が返されます。(ページトークンは不透明な値です)。
次のページの結果を取得するには、結果の nextPageToken
を次のリクエストの pageToken
にコピーします。結果のページとともに返される nextPageToken
が空になるまで繰り返します。
notes.list は、同時変更が発生した場合でも一貫した結果を返します。また、ABORTED エラーで、返せないことを通知します。
HTTP リクエスト
GET https://keep.googleapis.com/v1/notes
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ |
pageSize |
integer
返される結果の最大件数です。
|
pageToken |
string
前のページの nextPageToken フィールド。
|
filter |
string
リスト結果をフィルタします。フィルタが指定されていない場合、デフォルトで trashed フィルタが適用されます。フィルタに使用できる有効なフィールドは、createTime 、updateTime 、trashTime 、trashed です。 フィルタの構文は、Google AIP フィルタリング仕様に従います。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
メモのページをリストしたときのレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
{
"notes": [
{
object (Note )
}
],
"nextPageToken": string
} |
フィールド |
notes[] |
object (Note )
メモのページ。
|
nextPageToken |
string
次のページの pageToken フィールド。
|
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/keep
https://www.googleapis.com/auth/keep.readonly
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 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)."]]