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

todo_complete_task

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

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ç

Bir Microsoft To Do görevini tamamlandı olarak işaretler. Microsoft hesabı Reminders'a eklendiğinde To Do ile eşitlenen Apple Reminders üzerinden çalışır; bu yüzden değişiklik bir sonraki eşitlemeden sonra To Do'da görünür. todo_list_tasks içindeki task_id değerini tercih edin. Bunun yerine `title` verilirse, başlığı o metni içeren (büyük/küçük harf duyarsız) tek açık görevi tamamlar; birden fazla eşleşme varsa HİÇBİRİNİ tamamlamaz ve bunları task_id değerleriyle listeler. `list` olmadan yalnızca To Do listelerinde değil, tüm Reminders listelerinde arar. confirm olmadan çağrılırsa önizleme döndürür; tamamlamak için confirm=true iletin.

Zorunlu girdiler

Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.

İ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 complete",
      "type": "boolean"
    },
    "list": {
      "description": "List name to narrow search by title (optional)",
      "type": "string"
    },
    "task_id": {
      "description": "Task ID from todo_list_tasks",
      "type": "string"
    },
    "title": {
      "description": "Task title (partial match, alternative to task_id)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Belge örneği

todo_complete_task 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,
  "title": "Planning meeting"
}

Windows

Amaç

Outlook masaüstü uygulaması üzerinden Microsoft To Do / Outlook Tasks içindeki bir görevi tamamlandı olarak işaretler; yalnızca Windows. confirm=true olmadan hiçbir şey değişmez: çağrı konuyu ve listeyi yansıtan, görevi aramayan bir önizleme döndürür; bu yüzden görevin var olup olmadığını söylemez. confirm=true ile konusu `subject` değerine eşit olan görevi arar (kısmi eşleşme yok, görev ID'si yok) ve %100'de tamamlandı olarak ayarlar. `list` olmadan yalnızca kök Tasks klasöründe arar, alt klasörlerinde aramaz; `list` ile (todo_list_tasks içinden bir ad veya tam yol) yalnızca orada arar ve bilinmeyen ya da birden fazla klasörle eşleşen bir liste hatayla reddedilir. O klasörde aynı konuyu paylaşan birden fazla AÇIK görev varsa hiçbiri tamamlanmaz: çağrı başarısız olur ve her biri bir task_id ile adayları listeler; birini tamamlamak için o task_id ile yeniden çağırın. Eksik bir görev 'not found' döndürür ve Outlook'tan gelen, değişikliği doğrulamayan bir yanıt asla başarı değil, hatadır. Görev silinmez; bu sunucuda onu yeniden açacak araç yoktur.

Zorunlu girdiler

Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.

İ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 — Windows
{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "Task list or folder to complete the task in, by name or full path as reported by todo_list_tasks (default: only the root Tasks folder). Disambiguates when the same subject exists in more than one list. The name the cloud catalog (Mac) advertises.",
      "type": "string"
    },
    "subject": {
      "description": "Task subject (exact match)",
      "type": "string"
    },
    "task_id": {
      "description": "A task_id listed by this tool when several open tasks share the subject. Completes exactly that task; subject and list are not needed.",
      "type": "string"
    },
    "title": {
      "description": "Alias for `subject` — the name the cloud catalog (Mac) advertises. Exact match here, unlike the Mac tool's partial match.",
      "type": "string"
    }
  },
  "type": "object"
}

Belge örneği

todo_complete_task 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,
  "title": "Planning meeting"
}