list_calendar_events

Takvim · macOS

Etki: okuma. 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ç

Mac'in Calendar uygulamasındaki (Calendar.app, yerel/iCloud takvimleri) etkinlikleri bir tarih aralığında listeler veya event_id aracılığıyla TEK bir etkinliği tam olarak okur. Liste kayıtları notların önizlemesini gösterir (200 karakter ve notes_truncated bayrağı) ve katılımcı sayısını sınırlar; eksiksiz notlar ve tam katılımcı listesi için event_id iletin. Varsayılan aralık bugünden sonraki 7 gündür. Microsoft 365 takvimi için bunun yerine m365_list_events kullanın.

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 bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.

İngilizce kanonik teknik şema — macOS

{
  "properties": {
    "calendar": {
      "description": "Filter by calendar name — partial, case-insensitive (optional). To pick one of several same-titled calendars, qualify it as \"Account/Calendar\" (e.g. \"Exchange/Calendario\") using the source from list_calendar_names, or pass calendar_id.",
      "type": "string"
    },
    "calendar_id": {
      "description": "Filter by a single calendar UUID from list_calendar_names (optional).",
      "type": "string"
    },
    "calendar_ids": {
      "description": "Filter by multiple calendar UUIDs (optional).",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "end_date": {
      "description": "ISO 8601 date (YYYY-MM-DD). Defaults to start_date + 7 days.",
      "type": "string"
    },
    "event_id": {
      "description": "Read exactly ONE event by its id (from a previous list) with FULL notes and the complete attendee roster — required before editing notes of an event whose list entry says notes_truncated. When set, all other filters are ignored.",
      "type": "string"
    },
    "limit": {
      "description": "Max number of events to return (most recent first within the range). Optional; defaults to all in range.",
      "type": "integer"
    },
    "start_date": {
      "description": "ISO 8601 date (YYYY-MM-DD). Defaults to today.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Belge örneği

list_calendar_events 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.

{
  "limit": 5
}