书签资源类型

项目
03/08/2022

命名空间：microsoft.graph.search

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

书签是组织中常见Microsoft 搜索查询的结果中的管理答案。书签具有许多属性，使管理员能够更易于在组织中访问常见资源。

Methods

方法	返回类型	说明
列出书签	microsoft.graph.search.bookmark 集合	获取书签对象及其属性的列表。
创建书签	microsoft.graph.search.bookmark	创建新的书签对象。
获取书签	microsoft.graph.search.bookmark	读取书签对象的属性和关系。
更新书签	microsoft.graph.search.bookmark	更新书签对象的属性。
删除书签	无	删除书签对象。

属性

属性	类型	说明
id	String	书签的唯 (GUID) 标识符。继承自实体。
displayName	String	搜索结果中显示的书签名称。继承自 searchAnswer。
说明	String	搜索结果页上显示的书签说明。继承自 searchAnswer。
webUrl	String	书签 URL 链接。当用户在搜索结果中单击此书签时，他们将转到此 URL。继承自 searchAnswer。
lastModifiedBy	microsoft.graph.identitySet	创建或上次修改书签的用户的详细信息。继承自 searchAnswer。只读。
lastModifiedDateTime	DateTimeOffset	创建或编辑书签的时间戳。继承自 searchAnswer。只读。
categories	String collection	通常用于描述此书签的类别。例如，IT 和 HR。
availabilityStartDateTime	DateTimeOffset	书签开始显示为搜索结果的时间戳。设置为" `null` 始终可用"。
availabilityEndDateTime	DateTimeOffset	书签停止显示为搜索结果的时间戳。设置为" `null` 始终可用"。
languageTags	String collection	地理位置特定的语言名称列表，可以在其中查看此书签。每个语言标记值都遵循 {language}-{REGION} 模式。例如，美国 `en-US` 使用的英语。有关可能值的列表，请参阅支持的语言标记。
平台	microsoft.graph.devicePlatformType 集合	能够查看此书签的设备列表和操作系统。可取值为：`unknown`、`android`、`androidForWork`、`ios`、`macOS`、`windowsPhone81`、`windowsPhone81AndLater`、`windows10AndLater`、`androidWorkProfile`、`androidASOP`。
targetedVariations	microsoft.graph.search.answerVariant 集合	不同国家/地区或设备的书签变体。当你需要根据用户的设备、国家/地区或两者向用户显示不同的内容时，请使用。日期和组设置将应用于所有变体。
powerAppIds	String collection	与此Power Apps关联的列表。如果用户将现有Power Apps添加到书签，他们可以完成任务，例如输入休假时间或在搜索结果页上报告费用。
keywords	microsoft.graph.search.answerKeyword	触发此书签显示在搜索结果中的关键字。
state	microsoft.graph.search.answerState	书签的状态。可能的值是：、published``draft、`excluded`或 `unknownFutureValue`。
isSuggested	Boolean	如此如果此书签是由用户建议管理员或已缩小和 Microsoft 建议。只读。
groupIds	String collection	能够查看此书签的安全组列表。

关系

无。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.search.bookmark",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "webUrl": "String",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "categories": [
    "String"
  ],
  "availabilityStartDateTime": "String (timestamp)",
  "availabilityEndDateTime": "String (timestamp)",
  "languageTags": [
    "String"
  ],
  "platforms": [
    "String"
  ],
  "targetedVariations": [
    {
      "@odata.type": "microsoft.graph.search.answerVariant"
    }
  ],
  "powerAppIds": [
    "String"
  ],
  "keywords": {
    "@odata.type": "microsoft.graph.search.answerKeyword"
  },
  "state": "String",
  "isSuggested": "Boolean",
  "groupIds": [
    "String"
  ]
}

书签资源类型

Methods

属性

关系

JSON 表示形式

反馈