teams_list_channels

Microsoft Teams · macOS · Windows

Efeito: leitura. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Lista os canais de uma equipe do Microsoft Teams (team_id de teams_list_teams), por nome, a partir do Microsoft 365. O id do canal alimenta teams_read_channel_messages. Lê no máximo 20 páginas de canais. Quando a leitura é cortada (por esse limite, ou porque a chamada ficou sem tempo), a resposta traz truncated: true. Requer uma conta corporativa ou escolar do Microsoft 365 conectada com connect_m365_account (contas pessoais da Microsoft não têm leituras do Teams). Quando não há nenhuma conta do Microsoft 365 conectada, lê em vez disso o cache local do app do Teams neste Mac (requer Acesso Total ao Disco, pode estar horas ou dias atrasado); o source da resposta diz qual deles respondeu (graph ou local_cache).

Entradas obrigatórias

team_id

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — 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"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para teams_list_channels. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "team_id": "demo-team-001"
}

Windows