teams_call_history

Microsoft Teams · macOS · Windows

Wirkung: Lesen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Listet die Microsoft-Teams-Anrufe und -Besprechungen auf, die in den 50 jüngsten Chats des Kontos beendet wurden, die neuesten zuerst, aus Microsoft 365: Anruftyp (call, meeting oder screenShare), Teilnehmer, Start- und Endzeit sowie Dauer. Anrufe außerhalb eines Chats (Telefonanrufe, Kalenderbesprechungen ohne Chat) werden nicht aufgelistet, und Microsoft sagt nicht, wer einen Anruf gestartet hat oder ob er angenommen wurde: direction und answered sind immer leer. Optionale since/until (YYYY-MM-DD) grenzen den Zeitraum ein. Betrachtet die 50 jüngsten Chats und in jedem seine neuesten 50 nicht gelöschten Nachrichten (liest höchstens 20 Seiten mit je 50). Ein Chat, den das Konto nicht lesen kann (403 oder 404), wird übersprungen und in skipped_chats gezählt. Wird das Lesen abgebrochen (durch diese Grenze oder weil der Aufruf die Zeit überschritten hat), enthält die Antwort truncated: true. Erfordert ein mit connect_m365_account verbundenes Microsoft-365-Konto für Beruf oder Schule (persönliche Microsoft-Konten haben keinen Teams-Lesezugriff). Ist überhaupt kein Microsoft-365-Konto verbunden, liest es stattdessen den lokalen Cache der Teams-App auf diesem Mac (erfordert den Vollzugriff auf die Festplatte, kann Stunden oder Tage hinterherhinken); die source der Antwort sagt, welcher geantwortet hat (graph oder local_cache).

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "limit": {
      "description": "Max calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für teams_call_history. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "limit": 5
}

Windows

Zweck

Liest den Verlauf der Microsoft-Teams-Anrufe und -Besprechungen über Microsoft Graph (das verbundene Microsoft-365-Konto), abgeleitet aus den Ereignissen „Anruf beendet“ in Ihren jüngsten Teams-Chats. Jeder Anruf enthält Teilnehmer, Start-/Endzeit, Dauer, Anruftyp und eine stabile Anruf-ID. Optionale since/until (YYYY-MM-DD) grenzen den Zeitraum ein – z. B. holt ein täglicher Collector die Anrufe des Vortags. Betrachtet die 50 jüngsten Chats und in jedem seine neuesten 50 nicht gelöschten Nachrichten (liest höchstens 20 Seiten mit je 50). Ein Chat, den das Konto nicht lesen kann (403 oder 404), wird übersprungen und in skipped_chats gezählt. Wird das Lesen abgebrochen (durch diese Grenze oder weil der Aufruf die Zeit überschritten hat), enthält die Antwort truncated: true.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — Windows

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "limit": {
      "description": "Max calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

Dokumentationsbeispiel

{
  "limit": 5
}