用户和开发者应能够微调 Topics API,以提高内容相关性。本页介绍了如何管理和自定义 Topics API,以满足用户的偏好设置和需求。
以用户身份选择停用
用户必须能够:
- 了解 Topics API 的用途。
- 识别与用户的浏览活动相关联的主题。
- 了解 API 何时在使用中。
- 提供用于启用或停用该 API 的控件。
- 控制要与 API 调用方共享哪些主题。
Topics API 提供简单易懂的分类,方便用户了解和控制浏览器可能会为他们建议的主题。Chrome 会在 chrome://settings/adPrivacy/interests
上提供 Topics API 的相关信息和设置。
用户可以通过以下方式屏蔽不想与 API 调用方分享的主题类别:
- 屏蔽浏览器已为其分配的主题。
- 在
chrome://settings/adPrivacy/interests/manage
中主动屏蔽不感兴趣的广泛主题类别。在这种情况下,用户无需等待系统分配主题,即可将其屏蔽。

API 调用方无法在无痕模式下获得主题,当浏览记录被清除后,这些主题也会一并清除。
在以下情况下,返回的主题列表将为空:
- 用户在
chrome://settings/adPrivacy/interests
的浏览器设置中停用了 Topics API。 - 用户清除了其主题(使用
chrome://settings/adPrivacy/interests
上的浏览器设置)或清除了其 Cookie。 - 浏览器处于无痕模式。
- 用户屏蔽了所有可能的主题。
该说明文档详细介绍了隐私保护目标以及该 API 如何努力实现这些目标。
作为开发者选择停用
您可以选择为网站上的特定网页停用主题计算功能,只需在相应网页上添加 Permissions-Policy: browsing-topics=()
Permissions-Policy 标头,即可阻止为该网页上的所有用户计算主题。之后访问您网站上的其他网页不会受到影响:如果您设置了政策来阻止某个网页使用 Topics API,则不会影响其他网页。
您还可以使用 Permissions-Policy
标头来控制第三方对 Topics API 的访问权限,从而控制哪些第三方可以访问您网页上的主题。作为标头的参数,请使用 self
和您要允许访问该 API 的任何网域。例如,如需在所有浏览情境(除了您自己的来源和 https://example.com
)中完全停用 Topics API,请设置以下 HTTP 响应标头:
Permissions-Policy: browsing-topics=(self "https://example.com")
另请参阅
请查看我们的资源,以便更好地了解 Web 版 Topics API。
- 观看 Topics 的演示、协作和演示视频。
- 请参阅 Chrome 标志列表,这些标志可让开发者自定义 Topics API 以进行测试。
- 了解用户和开发者如何控制该 API。
- 查看相关资源,获取技术解说和支持。提问、互动和分享反馈。