Stay organized with collections
Save and categorize content based on your preferences.
The Chrome Management Profiles API allows administrators to view data and manage
remote commands of managed profiles on Chrome browsers. This set of APIs can be
used to list the managed profiles, retrieve a managed profile, delete the data
collected from managed profile, issue a remote command to a managed profile,
retrieve a remote command issued to a managed profile, and list remote commands
issued to a managed profile.
Quick overview of API methods
URLs are relative to
https://chromemanagement.googleapis.com/v1/customers/{customer_id}
[null,null,["Last updated 2025-07-11 UTC."],[[["\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/)."]]
