使用 Microsoft 搜索 API 搜索首字母缩略词
可以使用 Microsoft Graph 中的 Microsoft 搜索 API 在组织中搜索首字母缩略词。 管理员可以在 Microsoft 365 管理中心或通过创建首字母缩略词 API 创建首字母缩略词。
注意
测试版中的搜索 API 架构已更改。 搜索请求和响应中的某些属性已重命名或删除。 有关详细信息,请参阅 架构更改弃用警告。 本主题中的示例显示了最新的架构。
创建首字母缩略词后,若要搜索它们,请在 searchRequest 中的 entityTypes 属性中将 指定 acronym
为 值。
POST https://graph.microsoft.com/v1.0/search/query
Content-Type: application/json
{
"requests": [
{
"entityTypes": [
"acronym"
],
"query": {
"queryString":"what is KQL"
}
}
]
}
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#search",
"value": [
{
"@odata.type": "#microsoft.graph.searchResponse",
"hitsContainers": [
{
"@odata.type": "#microsoft.graph.searchHitsContainer",
"hits": [
{
"@odata.type": "#microsoft.graph.searchHit",
"hitId": "a9f59c69-f4a1-42ac-820e-0f35114300f8",
"rank": 1,
"resource": {
"@odata.type": "#microsoft.graph.search.acronym",
"id": "a9f59c69-f4a1-42ac-820e-0f35114300f8",
"displayName": "KQL",
"description": "Kusto Query Language is a powerful tool to explore your data and discover patterns, identify anomalies and outliers, create statistical modeling, and more.",
"webUrl": "https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query",
"standsFor": "Kusto Query Language"
}
}
}
],
"total": 1,
"moreResultsAvailable": false
}
]
}
]
}
- 首字母缩略词搜索不支持排序、聚合和分页。
- 不支持将非应答实体类型组合搜索 (例如 driveItem 和 list) 。