teams_call_history

Microsoft Teams · macOS · Windows

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

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

macOS

목적

Microsoft 365에서 계정의 최근 50개 채팅에서 종료된 Microsoft Teams 통화와 회의를 최신순으로 나열합니다. 통화 유형(call, meeting 또는 screenShare), 참가자, 시작 및 종료 시간, 길이가 포함됩니다. 채팅 밖의 통화(전화 통화, 채팅이 없는 캘린더 회의)는 나열되지 않으며, Microsoft는 누가 통화를 시작했는지 또는 응답했는지 알려 주지 않으므로 direction과 answered는 항상 비어 있습니다. 선택적 since/until(YYYY-MM-DD)로 범위를 좁힙니다. 최근 50개 채팅을 살펴보고 각 채팅에서 삭제되지 않은 최신 메시지 50개를 확인합니다(50개씩 최대 20페이지까지 읽음). 계정이 읽을 수 없는 채팅(403 또는 404)은 건너뛰며 skipped_chats에 집계됩니다. 그 한도에 걸리거나 호출 시간이 초과되어 읽기가 중단되면 응답에 truncated: true가 표시됩니다. connect_m365_account로 연결된 회사 또는 학교 Microsoft 365 계정이 필요합니다(개인 Microsoft 계정은 Teams 읽기를 지원하지 않습니다). Microsoft 365 계정이 전혀 연결되어 있지 않으면 대신 이 Mac의 Teams 앱 로컬 캐시를 읽습니다(전체 디스크 접근 권한이 필요하며 몇 시간 또는 며칠 뒤처질 수 있음). 응답의 source가 어느 쪽이 답했는지 알려 줍니다(graph 또는 local_cache).

필수 입력

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

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

영문 정식 기술 스키마 — 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"
    },
    "limit": {
      "description": "Max calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

문서 예시

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

{
  "limit": 5
}

Windows

목적

Microsoft Graph(연결된 Microsoft 365 계정)를 통해 최근 Teams 채팅의 통화 종료 이벤트에서 파생된 Microsoft Teams 통화 및 회의 기록을 읽습니다. 각 통화에는 참가자, 시작/종료 시간, 길이, 통화 유형, 안정적인 통화 id가 포함됩니다. 선택적 since/until(YYYY-MM-DD)로 범위를 좁힙니다. 예를 들어 일일 수집기는 전날의 통화를 가져옵니다. 최근 50개 채팅을 살펴보고 각 채팅에서 삭제되지 않은 최신 메시지 50개를 확인합니다(50개씩 최대 20페이지까지 읽음). 계정이 읽을 수 없는 채팅(403 또는 404)은 건너뛰며 skipped_chats에 집계됩니다. 그 한도에 걸리거나 호출 시간이 초과되어 읽기가 중단되면 응답에 truncated: true가 표시됩니다.

필수 입력

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

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

영문 정식 기술 스키마 — Windows

{
  "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"
    },
    "limit": {
      "description": "Max calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

문서 예시

{
  "limit": 5
}