书签资源类型
命名空间:microsoft.graph.search
表示一个书签,该书签是组织中常见搜索查询的 Microsoft 搜索结果中的管理答案。 书签具有许多属性,使管理员能够在组织中更易于访问常见资源。
继承自 searchAnswer。
方法
方法 | 返回类型 | 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 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"
}