teams_read_channel_messages

Microsoft Teams · macOS · Windows

Effect: lezen. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Leest de meest recente berichten van een Microsoft Teams-kanaal (team_id uit teams_list_teams, channel_id uit teams_list_channels), oudste eerst, uit Microsoft 365. Alleen berichten op het hoogste niveau: antwoorden zijn niet opgenomen. Voor het lezen van kanaalberichten is een machtiging nodig die een beheerder van de Microsoft 365-organisatie goedkeurt; zonder die machtiging is het antwoord consent_required en staat erin wat u moet doen. Leest maximaal 20 pagina's van 50 berichten, inclusief verwijderde. Wanneer het lezen wordt afgekapt (door die grens, of omdat de aanroep geen tijd meer had) bevat het antwoord truncated: true. Vereist een Microsoft 365-werk- of schoolaccount dat is verbonden met connect_m365_account (persoonlijke Microsoft-accounts hebben geen Teams-leesrechten). Wanneer er helemaal geen Microsoft 365-account is verbonden, wordt in plaats daarvan de lokale cache van de Teams-app op deze Mac gelezen (vereist Volledige schijftoegang, kan uren of dagen achterlopen); source in het antwoord geeft aan welke van de twee heeft geantwoord (graph of local_cache).

Vereiste invoer

team_id
channel_id

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor teams_read_channel_messages. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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

Windows