书签资源类型

命名空间：microsoft.graph.search

重要

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

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

继承自 searchAnswer。

方法

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

属性

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

关系

无。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

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