초기 설정
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
개발자를 위한 설정
클라우드 프로젝트에 API 제품군 사용 설정
- Cloud 콘솔(https://console.cloud.google.com/)로 이동합니다.
- 기존 클라우드 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
APIs & Services > Enable APIs and Services 페이지로 이동합니다.- 'Chrome'을 검색합니다.
- 'Chrome Management API'를 선택합니다.
- 서비스 약관을 숙지하세요.
Enable 아이콘을 클릭합니다.
사용자 인증 정보 만들기
대안 1: OAuth 2.0 클라이언트 ID
- 'OAuth 2.0 클라이언트 ID'를 만들기 전에 먼저 애플리케이션에 대한 정보로 OAuth 동의 화면을 구성해야 합니다.
Cloud 콘솔에서
APIs & Services > OAuth consent screen로 이동합니다.
동의 화면 구성 페이지에서 범위를 입력합니다.
- Reports API의 경우
https://www.googleapis.com/auth/chrome.management.reports.readonly을 추가합니다.
- App Details API의 경우
https://www.googleapis.com/auth/chrome.management.appdetails.readonly을 추가합니다.
- Telemetry API의 경우
https://www.googleapis.com/auth/chrome.management.telemetry.readonly을 추가합니다.
추가된 범위는 민감한 정보이므로 확인을 위해 앱을 제출해야 할 수도 있습니다. 그러지 않으면 내부용 앱이 아닌 경우 사용자에게 보안 경고 화면이 표시될 수 있습니다.
APIs & Services > Credentials > Create Credentials > OAuth client ID로 이동하여 단계에 따라 사용자 인증 정보를 만듭니다.
원하는 경우 OAuth 플레이그라운드에서 앱을 테스트합니다 (방법 참고).
대안 2: 서비스 계정
APIs & Services > Credentials > Create Credentials > Service account 페이지로 이동합니다.- 서비스 계정 이름을 입력하고
Create를 클릭합니다.
- 서비스 계정의 키를 만듭니다.
Add Key를 클릭하고 'json' 키를 만듭니다. 안전한 위치에서 파일을 추적합니다.
- 고객에게 적절한 관리자 권한이 있는 서비스 계정을 사용합니다.
- 고객은 도메인 전체 위임을 설정할 수 있으며, 그러면 서비스 계정이 적절한 권한이 있는 사용자/관리자를 가장할 수 있습니다 (방법 참고).
- 또는 고객이 서비스 계정에 적절한 권한이 있는 관리자 역할을 직접 부여할 수 있습니다 (방법 참조).
고객용 설정
개발자가 만든 애플리케이션 유형에 따라 고객 관리자의 설정 옵션이 달라집니다.
'OAuth 2.0 클라이언트' 앱
특별한 설정은 필요하지 않습니다.
앱 사용자에게 적절한 관리자 권한이 필요합니다 (방법 참조).
앱 사용자가 앱 OAuth 팝업 동의 화면에 동의해야 합니다.
필요한 경우 앱에서 도메인 전체 위임을 사용하도록 허용할 수 있습니다 (방법 참고). 이렇게 하면 사용자의 OAuth 팝업 동의 화면이 생략됩니다.
필요한 경우 앱이 차단되지 않았는지 또는 앱을 명시적으로 신뢰하는지 확인합니다 (방법 참조).
'서비스 계정' 앱
서비스 계정에는 적절한 관리자 권한이 부여되어야 합니다.
다음 두 가지 방법 중 하나로 확인할 수 있습니다.
- 서비스 계정이 적절한 권한이 있는 관리자를 가장할 수 있도록 도메인 전체 위임을 허용합니다 (방법 참고).
- 서비스 계정에 관리자 역할을 직접 부여합니다 (방법 참조).
'방법' 가이드
앱을 차단하거나 신뢰하는 방법
- 고객 관리자로서 관리 콘솔 (https://admin.google.com/)으로 이동합니다.
Security > Access and data control > API controls로 이동합니다.App access control 섹션에서 Manage third party app access 아이콘을 클릭합니다.- '연결된 앱' 목록에 앱이 표시되지 않으면 새 앱을 구성할 수 있습니다.
- 이제 앱을 명시적으로 차단하거나 앱을 명시적으로 신뢰할 수 있습니다.
도메인 전체 위임을 사용 설정하는 방법
- 고객 관리자로서 관리 콘솔 (https://admin.google.com/)으로 이동합니다.
Security > Access and data control > API controls > Domain-wide delegation로 이동합니다.Add new 아이콘을 클릭합니다.- 클라이언트 ID ('서비스 계정 고유 ID' 또는 '앱 클라이언트 ID')를 입력합니다.
- 필요한 모든 OAuth 범위를 입력하세요. 앱에 따라 Chrome Management API 이상의 범위를 입력해야 할 수 있습니다. 예를 들어 기기, 사용자, 브라우저, OU, 그룹 등을 관리하려면 Directory API를 사용해야 합니다.
Authorize 아이콘을 클릭합니다.
관리자 권한 관리 방법
Chrome Management API마다 다른 관리자 권한이 필요합니다. Reports API, App Details API 또는 Telemetry API에 필요한 관리자 권한을 확인하세요.
권한을 부여하려면 다음 단계를 따르세요.
- 고객 관리자로서 관리 콘솔 (https://admin.google.com/)으로 이동합니다.
Admin roles 페이지로 이동합니다.- 기존 역할을 찾거나 필요한 권한을 보유한 새 역할을 만드세요.
- 사용자 이메일 주소 또는 서비스 계정 이메일 주소에 이 역할을 할당합니다.
OAuth 플레이그라운드에서 앱을 테스트하는 방법
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eDevelopers need to enable the Chrome Management API, create credentials (OAuth or Service Account), and understand setup options for customer admins.\u003c/p\u003e\n"],["\u003cp\u003eCustomer admins need to configure settings based on the developer's application type, potentially granting privileges or enabling domain-wide delegation.\u003c/p\u003e\n"],["\u003cp\u003e"How to" guides provide detailed instructions for blocking/trusting apps, enabling domain-wide delegation, managing admin privileges, and testing in OAuth Playground.\u003c/p\u003e\n"],["\u003cp\u003eDifferent Chrome Management APIs require specific admin privileges, and detailed information is available in their respective guides.\u003c/p\u003e\n"],["\u003cp\u003eOAuth 2.0 Client apps need user consent or Domain-Wide Delegation, while Service Account apps require explicit admin privilege grants.\u003c/p\u003e\n"]]],[],null,["# Initial Setup\n\nSetup for a developer\n---------------------\n\n### Enable API suite for cloud project\n\n- Navigate to Cloud Console: \u003chttps://console.cloud.google.com/\u003e.\n- Select existing cloud project or create a new one.\n- Go to `APIs & Services \u003e Enable APIs and Services`.\n- Search for \"Chrome\".\n- Select \"Chrome Management API\".\n- Familiarize yourself with Terms of Service.\n- Click `Enable`.\n\n### Create Credentials\n\n#### Alternative 1: OAuth 2.0 Client IDs\n\n- Before you are able to create \"OAuth 2.0 Client ID\" you need to first configure the OAuth consent screen with information about your application. In Cloud Console, go to `APIs & Services \u003e OAuth consent screen`.\n- In your consent screen config page, enter the scopes:\n\n - For Reports API add: `https://www.googleapis.com/auth/chrome.management.reports.readonly`\n - For App Details API add: `https://www.googleapis.com/auth/chrome.management.appdetails.readonly`\n - For Telemetry API add: `https://www.googleapis.com/auth/chrome.management.telemetry.readonly`\n\n Note that added scopes are sensitive, so you may need to submit your app for verification. Otherwise, users may see a security warning screen if your app is not internal.\n- Go to `APIs & Services \u003e Credentials \u003e Create Credentials \u003e OAuth client ID` and follow the steps to create the credentials.\n\n- Optionally, test your app in OAuth Playground (see [How to](#how_to_test_your_app_in_oauth_playground)).\n\n#### Alternative 2: Service Account\n\n- Go to `APIs & Services \u003e Credentials \u003e Create Credentials \u003e Service account`.\n- Enter service account name and click `Create`.\n- Create a key for your service account. Click `Add Key` and create \"json\" key. Keep track of the file in a secure location.\n- Use your service account with proper admin privileges for customer:\n - Customer may set up Domain-Wide Delegation and then the service account can impersonate a user/admin who has proper privileges (see [how](#how_to_enable_domain-wide_delegation))\n - or customer may grant an admin role with proper privileges to the service account directly (see [how](#how_to_manage_admin_privileges)).\n\nSetup for a customer\n--------------------\n\nDepending on which application type the developer created, the customer admin has different setup options.\n\n#### \"OAuth 2.0 Client\" Apps\n\nNo special setup is needed.\n\nApp users require proper admin privileges (see [how](#how_to_manage_admin_privileges)).\n\nApp users need to agree to the app OAuth pop-up consent screen.\nOptionally, you can allow this app to use Domain-Wide Delegation (see [how](#how_to_enable_domain-wide_delegation)), which will omit the OAuth pop-up consent screen for users.\n\nOptionally verify if the app isn't blocked, or trust the app explicitly (see [how](#how_to_block_or_trust_an_app)).\n\n#### \"Service Account\" Apps\n\nThe service account must be granted proper admin privileges.\nYou can do this in either of two ways:\n\n- Allow Domain-Wide Delegation so the Service Account can impersonate an admin that has proper privileges (see [how](#how_to_enable_domain-wide_delegation)).\n- Grant Admin Roles for the service account directly (see [how](#how_to_manage_admin_privileges)).\n\n\"How to\" guides\n---------------\n\n### How to block or trust an app\n\n- As customer admin, go to Admin Console (https://admin.google.com/).\n- Navigate to `Security \u003e Access and data control \u003e API controls`.\n- In the `App access control` section, click `Manage third party app access`.\n- If you don't see the app in the 'Connected apps' list, you can configure a new app.\n- You can now block the app or trust the app explicitly.\n\n### How to enable domain-wide delegation\n\n- As customer admin, go to Admin Console (https://admin.google.com/).\n- Navigate to `Security \u003e Access and data control \u003e API controls \u003e Domain-wide delegation`.\n- Click `Add new`.\n- Enter client ID (\"service account unique id\" or \"app client ID\").\n- Enter all necessary OAuth scopes. Depending on the app, you may need to enter scopes for more than just Chrome Management API; e.g. the Directory API for managing devices, users, browsers, OUs, groups, etc.\n- Click `Authorize`.\n\n### How to manage admin privileges\n\nFor different portions of the Chrome Management APIs, different admin privileges\nare needed. See which admin privileges are required for\n[Reports API](/chrome/management/guides/reports_api),\n[App Details API](/chrome/management/guides/app_details_api), or\n[Telemetry API](/chrome/management/guides/telemetry_api).\n\nTo grant privileges:\n\n- As customer admin, go to Admin Console (https://admin.google.com/).\n- Navigate to `Admin roles` page.\n- Find an existing role or create a new role with the necessary privileges.\n- Assign this role to the user email address or the service account email address.\n\n### How to test your app in OAuth Playground\n\n- In Cloud Console, when creating an OAuth client ID for your app (see above [OAuth 2.0 Client IDs](/chrome/management/guides/setup#alternative_1_oauth_20_client_ids) section) select application type \"Web Applications\".\n- Enter a 'Name'.\n- To test your app, add `https://developers.google.com/oauthplayground` to the \"Authorized redirect URIs\" field. You can remove the redirect URI from your app when you're done testing.\n- Click `Create` and copy \"client ID\" and \"client secret\".\n- Go to [OAuth Playground](https://developers.google.com/oauthplayground/)\n- Click the gear icon in the top right corner ('OAuth 2.0 Configuration'), select `Use your own OAuth credentials`, and enter \"OAuth Client ID\" and \"OAuth Client secret\".\n- Follow these steps in OAuth Playground\n\n - Select \\& authorize APIs.\n\n Add `https://www.googleapis.com/auth/chrome.management.reports.readonly` (or other api scope) in the scope input field and click 'Authorize APIs'.\n Authorize using a customer admin account. Agree to the terms.\n - Exchange authorization code for tokens.\n\n Click `Exchange authorization code for tokens`. Optionally, click `Auto-refresh the token before it expires`.\n - Configure request to API.\n\n Enter your API URL in the 'Request URI' text box. Modify 'HTTP Method', 'Enter request body', etc. as per the API specification.\n For example, use the following URL to count the installed Apps in your organization: `https://chromemanagement.googleapis.com/v1alpha1/customers/my_customer/reports:countInstalledApps`"]]
