teams_read_channel_messages

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

Liest die neuesten Beiträge eines Microsoft Teams-Kanals (team_id aus teams_list_teams, channel_id aus teams_list_channels), die ältesten zuerst, aus Microsoft 365. Nur Beiträge der obersten Ebene: Antworten sind nicht enthalten. Das Lesen von Kanalnachrichten erfordert eine Berechtigung, die ein Administrator der Microsoft 365-Organisation genehmigt; ohne sie lautet die Antwort consent_required und sagt, was zu tun ist. Liest höchstens 20 Seiten mit je 50 Beiträgen, einschließlich gelöschter. Wird das Lesen abgebrochen (durch diese Grenze oder weil dem Aufruf die Zeit ausging), enthält die Antwort truncated: true. Erfordert ein mit connect_m365_account verbundenes Microsoft 365-Arbeits- oder -Schulkonto (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 Festplattenvollzugriff, kann Stunden oder Tage im Rückstand sein); source in der Antwort gibt an, welche Quelle geantwortet hat (graph oder local_cache).

Erforderliche Eingaben

team_id
channel_id

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

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"
    },
    "channel_id": {
      "description": "Channel ID from teams_list_channels",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für teams_read_channel_messages. 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.

{
  "channel_id": "demo-channel-001",
  "team_id": "demo-team-001"
}

Windows