メモを一覧表示します。
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 |
返される結果の最大件数です。 |
pageToken |
前のページの |
filter |
リスト結果をフィルタします。フィルタを指定しない場合、デフォルトで フィルタ構文は Google AIP フィルタリング仕様に準拠しています。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
メモのページを一覧表示するときのレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{
"notes": [
{
object ( |
フィールド | |
---|---|
notes[] |
メモのページ。 |
nextPageToken |
次のページの |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/keep
https://www.googleapis.com/auth/keep.readonly
詳細については、承認ガイドをご覧ください。