İçeriğe geç
Tüm araçlar

update_reminder

Anımsatıcılar ve Microsoft To Do · macOS

Etki: yazma. Durum: koşullu kullanılabilir.

“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.

macOS

Amaç

Reminders.app'teki mevcut bir anımsatıcıyı günceller. Başlığı, bitiş tarihini, notları, önceliği değiştirin, tekrarlanmasını veya tekrarlamayı bırakmasını sağlayın (recurrence) ya da başka bir listeye taşıyın (list_name). reminder_id değerini list_reminders çıktısından alın. confirm=true gerekir. ÖNEMLİ: FARKLI bir hesaptaki bir listeye taşımak (ör. iCloud ↔ Exchange) anımsatıcıyı yeniden oluşturur, bu yüzden kimliği değişir; yanıt o zaman id_changed: true, yeni kimliği reminder_id içinde ve eskisini previous_reminder_id içinde taşır. Sonraki her çağrıdan önce reminder_id değerini her zaman yanıttan alın.

Zorunlu girdiler

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

İngilizce kanonik teknik şema — 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"
}

Belge örneği

update_reminder için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{
  "confirm": false,
  "reminder_id": "demo-reminder-001",
  "title": "Review the launch checklist"
}