update_reminder
リマインダーと Microsoft To Do · macOS
効果: 書き込み. 状態: 条件付き提供.
「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。
macOS
目的
Reminders.app の既存のリマインダーを更新します。タイトル、期限、メモ、優先度を変更したり、繰り返す/繰り返さないようにしたり(recurrence)、別のリスト(list_name)に移動したりできます。reminder_id は list_reminders から取得してください。confirm=true が必要です。重要: 別のアカウントのリスト(例: iCloud ↔ Exchange)に移動すると、リマインダーが作り直され、id が変わります。その場合、応答には id_changed: true が付き、新しい id が reminder_id に、古い id が previous_reminder_id に入ります。この後の呼び出しの前に、必ず応答から reminder_id を取得してください。
必須入力
reminder_id
入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。
権限と確認
スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。
- このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。
英語の正規技術スキーマ — macOS
{
"properties": {
"confirm": {
"description": "Must be true to apply changes",
"type": "boolean"
},
"due_date": {
"description": "New ISO 8601 due date. Pass empty string to clear (optional)",
"type": "string"
},
"list_name": {
"description": "Move the reminder to this list (a name from get_reminder_folders) (optional). Moving to a list in ANOTHER account recreates the reminder and CHANGES its id — read the new one from reminder_id in the response (id_changed: true).",
"type": "string"
},
"notes": {
"description": "New notes text (optional)",
"type": "string"
},
"priority": {
"description": "Priority: none | low | medium | high (optional)",
"enum": [
"none",
"low",
"medium",
"high"
],
"type": "string"
},
"recurrence": {
"description": "Make it a repeating reminder: 'daily', 'weekly', 'monthly', or 'yearly' ('none' stops an existing repetition; omit to leave it as it is). A repeating reminder needs a due date.",
"enum": [
"daily",
"weekly",
"monthly",
"yearly",
"none"
],
"type": "string"
},
"recurrence_count": {
"description": "Total number of occurrences (optional). Mutually exclusive with recurrence_until; if neither is given it repeats indefinitely. Needs recurrence.",
"type": "integer"
},
"recurrence_interval": {
"description": "Repeat every N periods (optional, default 1 — e.g. recurrence='weekly' + recurrence_interval=2 = every 2 weeks). Needs recurrence.",
"type": "integer"
},
"recurrence_until": {
"description": "ISO 8601 date the repetition stops on (optional; takes precedence over recurrence_count). Needs recurrence.",
"type": "string"
},
"reminder_id": {
"description": "Reminder identifier from list_reminders",
"type": "string"
},
"title": {
"description": "New title (optional)",
"type": "string"
}
},
"required": [
"reminder_id"
],
"type": "object"
}ドキュメント例
update_reminder のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。
{
"confirm": false,
"reminder_id": "demo-reminder-001",
"title": "Review the launch checklist"
}