connect_m365_account

Microsoft 365 · macOS · Windows

効果: 書き込み. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

Microsoft 365 アカウントを接続します（別のアカウントの追加や、再サインインにも使えます）。最初の呼び出しはプレビューを返し、何も開始しません。confirm: true でログインコードを取得します。microsoft.com/devicelogin で認証したあと、もう一度呼び出して接続を完了してください。include_channel_messages: true を渡すと、Teams のチャネルメッセージの読み取りと検索も可能になります。この権限には Microsoft 365 組織の管理者が必要で、承認がない場合はサインインが拒否され、アカウントは現在のアクセス権のままになります。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — 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"
}

ドキュメント例

connect_m365_account のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "confirm": false
}

Windows

目的

Microsoft 365 アカウントを接続します（別のアカウントの追加や、再サインインにも使えます）。最初の呼び出しはプレビューを返し、何も開始しません。confirm=true でログインコードを取得し、そのあと microsoft.com/devicelogin で認証してから、もう一度呼び出して完了してください。include_channel_messages: true を渡すと、Teams のチャネルメッセージの読み取りと検索も可能になります。この権限には Microsoft 365 組織の管理者が必要で、承認がない場合はサインインが拒否され、アカウントは現在のアクセス権のままになります。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — 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"
}

ドキュメント例

{
  "confirm": false
}