list_calendar_events

Calendario · macOS

Effetto: lettura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Elenca gli eventi dall'app Calendario del Mac (Calendar.app, calendari locali/iCloud) in un intervallo di date o legge l'evento ONE per intero tramite event_id. Note di anteprima delle voci dell'elenco (200 caratteri, flag notes_truncated) e limite dei partecipanti; passa event_id per ottenere le note complete e l'elenco completo. Valore predefinito a oggi + 7 giorni. Per un calendario Microsoft 365 utilizzare invece m365_list_events.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per list_calendar_events. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "limit": 5
}