Chrome Management Profiles API
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
管理員可透過 Chrome 管理設定檔 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 |
詳情請參閱驗證總覽。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：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/)."]]
