teams_search_messages
Microsoft Teams · macOS · Windows
효과: 읽기. 상태: 조건부 제공.
‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.
macOS
목적
Microsoft Search로 Microsoft 365 계정의 Microsoft Teams 채팅 및 채널 메시지를 텍스트로, 선택적으로 보낸 사람과 날짜 범위로 검색합니다. 어느 채팅인지 몰라도 어디서 논의되었는지 찾는 데 사용하세요. 결과는 Microsoft의 관련도순(최신순이 아님)으로 나오며, body는 일치 부분 주변의 스니펫이지 메시지 전체가 아닙니다. 나머지는 teams_read_chat_messages로 채팅을 읽으세요. 검색의 최대 4페이지에서 최대 100개의 결과를 반환합니다. 읽기가 그 한도 때문에, 또는 호출이 시간 초과되어 중단되면 응답에 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"
},
"from_sender": {
"description": "Only messages from this sender (name or email; optional)",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "integer"
},
"query": {
"description": "Text to search for",
"type": "string"
},
"since": {
"description": "Only messages on/after this date, YYYY-MM-DD (optional)",
"type": "string"
},
"until": {
"description": "Only messages on/before this date, YYYY-MM-DD (optional)",
"type": "string"
}
},
"required": [],
"type": "object"
}문서 예시
teams_search_messages 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.
{
"limit": 5,
"query": "launch checklist"
}Windows
목적
Microsoft Teams 채팅 및 1:1 메시지 기록(모든 대화를 한 번에)을 텍스트, 보낸 사람 이름 및/또는 날짜 범위로 검색합니다. 어느 채팅인지 몰라도 Teams에서 어디서 논의되었는지 찾는 데 사용하세요. 일치하는 메시지를(관련도가 높은 순으로) 각각 스니펫과 출처 채팅과 함께 반환합니다. 검색의 최대 4페이지에서 최대 100개의 결과를 반환합니다. 읽기가 그 한도 때문에, 또는 호출이 시간 초과되어 중단되면 응답에 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"
},
"from_sender": {
"description": "Filter to a sender by name (optional)",
"type": "string"
},
"limit": {
"description": "Max results (default 25, max 100)",
"type": "integer"
},
"query": {
"description": "Text to find in messages",
"type": "string"
},
"since": {
"description": "Only messages on/after this date, YYYY-MM-DD (optional)",
"type": "string"
},
"until": {
"description": "Only messages on/before this date, YYYY-MM-DD (optional)",
"type": "string"
}
},
"type": "object"
}문서 예시
teams_search_messages 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.
{
"limit": 5,
"query": "launch checklist"
}