ms-teams-chat-messages
Microsoft Graph API를 이용하여 지정한 사용자가 참여한 1:1 및 그룹 채팅 메시지를 조회합니다.
문법
ms-teams-chat-messages [profile=STRING] user=STRING [duration=STRING] [from=DATETIME] [to=DATETIME] [limit=INT] [include-system=BOOL]
옵션
- user=STRING
- 필수 옵션. 조회 대상 사용자의 계정(UPN) 또는 개체 ID. 여러 명은 쉼표(,)로 구분해서 입력합니다. 예: hong@example.com,user@example.com
- profile=STRING
- 선택 옵션. Microsoft Teams Graph API 접속 프로파일 식별자. 미지정 시 등록된 모든 Microsoft Teams Graph API 접속 프로파일을 조회합니다.
- duration=STRING
- 선택 옵션. 현재 시각으로부터 일정 시간 범위 이내의 메시지로 한정합니다. 예: 10m, 1h, 1d
- from=DATETIME
- 선택 옵션. 조회 시작 시각. 미지정 시 종료 시각의 1일 전.
- to=DATETIME
- 선택 옵션. 조회 종료 시각. 미지정 시 현재 시각.
- limit=INT
- 선택 옵션. 사용자별로 조회할 최대 메시지 수. 1 이상의 정수를 지정합니다.
- include-system=BOOL
- 선택 옵션. 멤버 변경 등 시스템 이벤트 메시지를 포함할지 여부. (기본값: f)
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| _time | 날짜 | 시각 | 메시지 생성 시각 |
| profile | 문자열 | 접속 프로파일 | 조회에 사용한 접속 프로파일 식별자. 예: ms_teams_graph |
| user | 문자열 | 조회 대상 사용자 | 메시지를 조회한 대상 사용자. 예: hong@example.com |
| msg_id | 문자열 | 메시지 ID | 메시지 식별자 |
| chat_id | 문자열 | 채팅 ID | 메시지가 속한 채팅 식별자. 같은 대화의 메시지는 값이 동일함 |
| updated | 날짜 | 수정 시각 | 메시지 최종 수정 시각. 조회 기간은 이 값을 기준으로 판정함 |
| msg_type | 문자열 | 메시지 유형 | message, chatEvent, typing, systemEventMessage |
| from_user_id | 문자열 | 발신자 ID | 발신자 개체 ID. 발신자 정보가 없으면 null |
| from_user_name | 문자열 | 발신자 이름 | 발신자 표시 이름. 예: 홍길동 |
| msg | 문자열 | 메시지 | HTML 태그를 제거한 메시지 본문. 예: 회의 자료 공유드립니다 |
| content_type | 문자열 | 본문 형식 | 원본 본문 형식. html 또는 text |
| importance | 문자열 | 중요도 | normal, high, urgent |