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

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.

İ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) or datetime. Inclusive when only a date is given: 2026-10-02 returns the events of October 2 too. With a time, the range ends at that instant. Defaults to start_date + 7 days.",
      "type": "string"
    },
    "event_id": {
      "description": "Read exactly ONE event by its id (from a previous list — for a recurring event, the per-occurrence id) 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. Events come in start-time order, earliest first, so a limit keeps the earliest ones in the range. Optional; defaults to 100.",
      "type": "integer"
    },
    "offset": {
      "description": "Skip this many events first. A long answer is cut at 256 KB with truncated=true and next_offset: pass next_offset here to continue.",
      "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
}