list_notes
メモ · macOS
効果: 読み取り. 状態: 条件付き提供.
「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。
macOS
目的
Apple Notes アプリのメモを一覧表示します。必要に応じてフォルダで絞り込めます。ページネーションに対応し、`limit` は1回あたり最大500なので、それ以上の limit を要求せず `offset` でページ送りしてください(offset=500 は501~1000件目を返します)。応答には `total`(一致するメモの総数)と `has_more`(このページより後に残りがあるか)が含まれるため、すべて取得できたか推測する必要はありません。`total_is_estimated` が件数は下限値にすぎないと示す場合でも、`has_more` が false になるまでページ送りすれば正確です。ライブラリ全体を読むには order="id" を渡します。order パラメーターを参照してください。
必須入力
このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。
権限と確認
スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。
- このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。
英語の正規技術スキーマ — macOS
{
"properties": {
"folder": {
"type": "string"
},
"limit": {
"default": "50",
"description": "Notes per page (default 50, capped at 500). To get more, page with offset.",
"type": "integer"
},
"offset": {
"default": "0",
"description": "How many notes to skip (default 0). offset=500 with limit=500 returns notes 501-1000. An offset past the end returns an empty page with has_more=false, not an error.",
"minimum": 0,
"type": "integer"
},
"order": {
"default": "modified",
"description": "order: \"modified\" (default) sorts newest-modified first — what you want to SHOW someone, but NOT safe for paging: modification date changes, so a note edited between two calls jumps to the front and another note is pushed past your cursor and never returned. \"id\" sorts by the note's immutable store id — stable, never renumbered, new notes append at the end — so use order=\"id\" to walk an entire library page by page: edits and insertions mid-crawl are safe with it. One case it cannot cover, because pages are addressed by offset: if a note is DELETED mid-crawl, every note after the hole shifts one slot back and the note that was on the page boundary is skipped, silently. If completeness matters, re-run the crawl and reconcile against total, or crawl while nothing is deleting notes.",
"type": "string"
}
},
"type": "object"
}ドキュメント例
list_notes のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。
{
"limit": 5
}