본문으로 건너뛰기
모든 도구

connect_m365_account

Microsoft 365 · macOS · Windows

효과: 쓰기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

Microsoft 365 계정을 연결합니다(다른 계정을 추가하거나 다시 로그인하는 경우 포함). 첫 번째 호출은 미리보기를 반환하며 아무것도 시작하지 않고, confirm: true로 설정하면 로그인 코드를 받습니다. microsoft.com/devicelogin에서 인증한 후 다시 호출하여 연결을 완료하세요. Teams 채널 메시지를 읽고 검색하려면 include_channel_messages: true를 전달하세요. 이 권한에는 Microsoft 365 조직 관리자의 승인이 필요하며, 승인이 없으면 로그인이 거부되고 계정은 현재의 접근 권한을 유지합니다.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

영문 정식 기술 스키마 — 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에서 인증한 후 다시 호출하여 완료하세요. Teams 채널 메시지를 읽고 검색하려면 include_channel_messages: true를 전달하세요. 이 권한에는 Microsoft 365 조직 관리자의 승인이 필요하며, 승인이 없으면 로그인이 거부되고 계정은 현재의 접근 권한을 유지합니다.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

영문 정식 기술 스키마 — 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"
}

문서 예시

connect_m365_account 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "confirm": false
}