connect_m365_account
Microsoft 365 · macOS · Windows
Efeito: escrita. 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
Conecta uma conta do Microsoft 365 (ou adiciona outra, ou faz login novamente em uma). A primeira chamada retorna uma prévia e não inicia nada; confirm: true gera um código de login. Chame de novo depois de se autenticar em microsoft.com/devicelogin para concluir a conexão. Passe include_channel_messages: true para também ler as mensagens dos canais do Teams e pesquisá-las — essa permissão exige um administrador da sua organização do Microsoft 365; sem essa aprovação o login é recusado e a conta mantém o acesso atual.
Entradas obrigatórias
O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.
Permissões e confirmação
O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.
- 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_type": {
"description": "\"work\" (default): a work or school Microsoft 365 account — mail, calendar, contacts, Teams. \"personal\": an Outlook.com / Hotmail / Live account — mail, calendar and contacts only (Microsoft has no Teams chats or directory for personal accounts, and asking for them makes Microsoft refuse the sign-in as an 'expired code'). Ask the person which one it is when unsure.",
"enum": [
"work",
"personal"
],
"type": "string"
},
"confirm": {
"description": "Must be true to start the sign-in. Without it the call returns a preview and does nothing.",
"type": "boolean"
},
"include_channel_messages": {
"description": "Also request access to Teams channel messages and message search. Needs an administrator of the Microsoft 365 organization; without that approval this sign-in is refused and the account keeps its current access.",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Exemplo documental
Exemplo de documentação para connect_m365_account. 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.
{
"confirm": false
}Windows
Finalidade
Conecta uma conta do Microsoft 365 (ou adiciona outra, ou faz login novamente em uma). A primeira chamada retorna uma prévia e não inicia nada; confirm=true gera um código de login, depois chame de novo após se autenticar em microsoft.com/devicelogin para concluir. Passe include_channel_messages: true para também ler as mensagens dos canais do Teams e pesquisá-las — essa permissão exige um administrador da sua organização do Microsoft 365; sem essa aprovação o login é recusado e a conta mantém o acesso atual.
Entradas obrigatórias
O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.
Permissões e confirmação
O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.
- 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 — Windows
{
"properties": {
"confirm": {
"description": "Must be true to start the sign-in. Without it, returns a preview.",
"type": "boolean"
},
"include_channel_messages": {
"description": "Also request access to Teams channel messages and message search. That permission needs an administrator of the Microsoft 365 organization; without that approval this sign-in is refused and the account keeps its current access.",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Exemplo documental
Exemplo de documentação para connect_m365_account. 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.
{
"confirm": false
}