Chrome Management Profiles API
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
借助 Chrome Management Profiles API,管理员可以查看数据并管理 Chrome 浏览器上受管理个人资料的远程命令。这组 API 可用于列出受管理的个人资料、检索受管理的个人资料、删除从受管理的个人资料收集的数据、向受管理的个人资料发出远程命令、检索向受管理的个人资料发出的远程命令,以及列出向受管理的个人资料发出的远程命令。
API 方法快速概览
网址相对于 https://chromemanagement.googleapis.com/v1/customers/{customer_id}
网址相对于 https://chromemanagement.googleapis.com/v1/customers/{customer_id}/profiles/{profile_permanent_id}
如需查看请求和响应示例,请参阅代码示例。
管理员权限
Profiles API 遵循管理员角色委托。
方法 |
需要管理员权限 |
ListChromeBrowserProfiles |
“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” 或“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器 -> 读取” |
GetChromeBrowserProfile |
“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” 或“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器 -> 读取” |
DeleteChromeBrowserProfile |
“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” |
CreateChromeBrowserProfileCommand |
“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” |
GetChromeBrowserProfileCommand |
“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” 或“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器 -> 读取” |
ListChromeBrowserProfileCommands |
“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器” 或“服务 -> Chrome 管理 -> 设置 -> 受管理的浏览器 -> 读取” |
如需管理管理员角色和权限,请访问“管理控制台 -> 管理员角色”。
API 范围
Chrome 管理个人资料 API 需要以下 OAuth 范围:
方法 |
所需的 OAuth 范围 |
ListChromeBrowserProfiles |
https://www.googleapis.com/auth/chrome.management.profiles 或 https://www.googleapis.com/auth/chrome.management.profiles.readonly |
GetChromeBrowserProfile |
https://www.googleapis.com/auth/chrome.management.profiles 或 https://www.googleapis.com/auth/chrome.management.profiles.readonly |
DeleteChromeBrowserProfile |
https://www.googleapis.com/auth/chrome.management.profiles |
CreateChromeBrowserProfileCommand |
https://www.googleapis.com/auth/chrome.management.profiles |
GetChromeBrowserProfileCommand |
https://www.googleapis.com/auth/chrome.management.profiles 或 https://www.googleapis.com/auth/chrome.management.profiles.readonly |
ListChromeBrowserProfileCommands |
https://www.googleapis.com/auth/chrome.management.profiles 或 https://www.googleapis.com/auth/chrome.management.profiles.readonly |
如需了解详情,请参阅身份验证概览。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eThe Chrome Management Profiles API enables administrators to view, retrieve, and delete data associated with managed profiles on Chrome browsers.\u003c/p\u003e\n"],["\u003cp\u003eAdmins need specific privileges like "Services -> Chrome Management -> Settings -> Managed Browsers" to access and manage profiles through the API.\u003c/p\u003e\n"],["\u003cp\u003eAPI methods include listing profiles, retrieving a specific profile, and deleting a profile's collected data, each with corresponding HTTP methods and relative URLs.\u003c/p\u003e\n"],["\u003cp\u003eProper OAuth scopes, such as \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.profiles\u003c/code\u003e, are necessary for authentication and authorization when using the API.\u003c/p\u003e\n"]]],[],null,["# Chrome Management Profiles API\n\nThe Chrome Management Profiles API allows administrators to view data and manage\nremote commands of managed profiles on Chrome browsers. This set of APIs can be\nused to list the managed profiles, retrieve a managed profile, delete the data\ncollected from managed profile, issue a remote command to a managed profile,\nretrieve a remote command issued to a managed profile, and list remote commands\nissued to a managed profile.\n\nQuick overview of API methods\n-----------------------------\n\nURLs are relative to\n`https://chromemanagement.googleapis.com/v1/customers/{customer_id}`\n\n| Description | Relative URL | Http method |\n|--------------------------------------------------|----------------------------------------------------------------------------------------------------|-------------|\n| List the managed profiles | [/profiles](/chrome/management/reference/rest/v1/customers.profiles/list) | GET |\n| Retrieve a managed profile | [/profiles/{profile_permanent_id}](/chrome/management/reference/rest/v1/customers.profiles/get) | GET |\n| Delete the data collected from a managed profile | [/profiles/{profile_permanent_id}](/chrome/management/reference/rest/v1/customers.profiles/delete) | DELETE |\n\nURLs are relative to\n`https://chromemanagement.googleapis.com/v1/customers/{customer_id}/profiles/{profile_permanent_id}`\n\n| Description | Relative URL | Http method |\n|---------------------------|------------------------------------------------------------------------------------------------|-------------|\n| Issue a remote command | [/commands](/chrome/management/reference/rest/v1/customers.profiles.commands/create) | POST |\n| Retrieve a remote command | [/commands/{command_id}](/chrome/management/reference/rest/v1/customers.profiles.commands/get) | GET |\n| List remote commands | [/commands](/chrome/management/reference/rest/v1/customers.profiles.commands/list) | GET |\n\nSee [code samples](/chrome/management/guides/samples_profilesapi) for example\nrequests and responses.\n\nAdmin Privileges\n----------------\n\nProfiles API respects administrator role delegation.\n\n| Method | Admin privileges required |\n|-----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| ListChromeBrowserProfiles | \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers\" or \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers -\\\u003e Read\" |\n| GetChromeBrowserProfile | \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers\" or \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers -\\\u003e Read\" |\n| DeleteChromeBrowserProfile | \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers\" |\n| CreateChromeBrowserProfileCommand | \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers\" |\n| GetChromeBrowserProfileCommand | \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers\" or \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers -\\\u003e Read\" |\n| ListChromeBrowserProfileCommands | \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers\" or \"Services -\\\u003e Chrome Management -\\\u003e Settings -\\\u003e Managed Browsers -\\\u003e Read\" |\n\nTo manage administrator roles and privileges visit \"Admin Console -\\\u003e Admin\nRoles\".\n| **Note:** administrator roles can be assigned directly to a Service Account.\n\nAPI scopes\n----------\n\nChrome Management Profiles API requires the following OAuth scopes:\n\n| Method | OAuth scopes required |\n|-----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| ListChromeBrowserProfiles | https://www.googleapis.com/auth/chrome.management.profiles or https://www.googleapis.com/auth/chrome.management.profiles.readonly |\n| GetChromeBrowserProfile | https://www.googleapis.com/auth/chrome.management.profiles or https://www.googleapis.com/auth/chrome.management.profiles.readonly |\n| DeleteChromeBrowserProfile | https://www.googleapis.com/auth/chrome.management.profiles |\n| CreateChromeBrowserProfileCommand | https://www.googleapis.com/auth/chrome.management.profiles |\n| GetChromeBrowserProfileCommand | https://www.googleapis.com/auth/chrome.management.profiles or https://www.googleapis.com/auth/chrome.management.profiles.readonly |\n| ListChromeBrowserProfileCommands | https://www.googleapis.com/auth/chrome.management.profiles or https://www.googleapis.com/auth/chrome.management.profiles.readonly |\n\nFor more information, see the\n[Authentication Overview](https://cloud.google.com/docs/authentication/)."]]