书签资源类型

项目
05/24/2024

命名空间：microsoft.graph.search

重要

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

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

方法

方法	返回类型	Description
List	microsoft.graph.search.bookmark 集合	获取书签对象及其属性的列表。
创建	microsoft.graph.search.bookmark	Create新的书签对象。
Get	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 集合	通常用于描述此书签的类别。例如， `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"
}

通过

书签资源类型

方法

属性

关系

JSON 表示形式

反馈

其他资源