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

teams_list_chats

Microsoft Teams · macOS · Windows

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

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

macOS

목적

Microsoft 365 계정의 Microsoft Teams 채팅(일대일 메시지, 그룹 채팅, 회의 채팅)을 최근 활동 순으로 나열하며 Microsoft 365에서 읽습니다. 각 채팅에는 id(teams_read_chat_messages용), 제목, 다른 참가자, 유형(oneOnOne, group 또는 meeting), 마지막 메시지가 있습니다. participants는 나머지 모든 멤버의 이름을 표시하며, 이름을 읽을 수 없는 멤버는 비워 두지 않고 "unnamed member"(또는 "unnamed member (external)")로 표시됩니다. participants_state는 이를 어디까지 신뢰할 수 있는지 알려 줍니다. resolved, unresolved(이름 없는 멤버가 한 명 이상), only_you(채팅에 다른 사람이 없음), unknown(멤버 목록을 읽을 수 없음, 이때 participant_count와 has_external_members는 없음)입니다. 50개 채팅씩 최대 20페이지까지 읽습니다. 그 한도에 걸리거나 호출 시간이 초과되어 읽기가 중단되면 응답에 truncated: true가 표시됩니다. connect_m365_account로 연결된 회사 또는 학교 Microsoft 365 계정이 필요합니다(개인 Microsoft 계정은 Teams 읽기를 지원하지 않습니다). Microsoft 365 계정이 전혀 연결되어 있지 않으면 대신 이 Mac의 Teams 앱 로컬 캐시를 읽습니다(전체 디스크 접근 권한이 필요하며 몇 시간 또는 며칠 뒤처질 수 있음). 응답의 source가 어느 쪽이 답했는지 알려 줍니다(graph 또는 local_cache).

필수 입력

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

권한 및 확인

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

영문 정식 기술 스키마 — 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 items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

문서 예시

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

{
  "limit": 5
}

Windows

목적

연결된 Microsoft 365 계정을 사용하여 Microsoft Graph를 통해 최근 Microsoft Teams 채팅 대화를 나열합니다. 50개 채팅씩 최대 20페이지까지 읽습니다. 그 한도에 걸리거나 호출 시간이 초과되어 읽기가 중단되면 응답에 truncated: true가 표시됩니다. participants는 나머지 모든 멤버의 이름을 표시하며, 이름을 읽을 수 없는 멤버는 비워 두지 않고 "unnamed member"(또는 "unnamed member (external)")로 표시됩니다. participants_state는 이를 어디까지 신뢰할 수 있는지 알려 줍니다. resolved, unresolved(이름 없는 멤버가 한 명 이상), only_you(채팅에 다른 사람이 없음), unknown(멤버 목록을 읽을 수 없음, 이때 participant_count와 has_external_members는 없음)입니다.

필수 입력

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

권한 및 확인

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

영문 정식 기술 스키마 — 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": "Maximum chats to return (default: 50)",
      "type": "number"
    }
  },
  "type": "object"
}

문서 예시

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

{
  "limit": 5
}