初期設定
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
デベロッパーのセットアップ
クラウド プロジェクトで 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 Playground でアプリをテストします（方法を参照）。
方法 2: サービス アカウント
APIs & Services > Credentials > Create Credentials > Service account に移動します。- サービス アカウント名を入力して [
Create] をクリックします。
- サービス アカウント用のキーを作成します。[
Add Key] をクリックして「json」キーを作成します。安全な場所にファイルを保管してください。
- お客様用の適切な管理者権限があるサービス アカウントを使用します。
- お客様がドメイン全体の委任を設定すると、サービス アカウントが適切な権限を持つユーザー/管理者に成り代わることができる（方法を参照）
- お客様がサービス アカウントに対して適切な権限を持つ管理者ロールを直接付与することもできます（方法を参照）。
お客様のセットアップ
デベロッパーが作成したアプリケーションの種類によって、顧客管理者の設定オプションは異なります。
「OAuth 2.0 クライアント」アプリ
特別なセットアップは必要ありません。
アプリ ユーザーには適切な管理者権限が必要です（詳細）。
アプリのユーザーは、アプリの OAuth ポップアップ同意画面に同意する必要があります。必要に応じて、このアプリにドメイン全体の委任の使用を許可することができます（方法を参照）。この場合、ユーザーに対して OAuth ポップアップ同意画面は表示されません。
必要に応じて、アプリがブロックされていないかどうかを確認するか、アプリを明示的に信頼します（方法を参照）。
「サービス アカウント」のアプリ
サービス アカウントには、適切な管理者権限を付与する必要があります。これには、次の 2 つの方法があります。
- ドメイン全体の委任を許可して、サービス アカウントが適切な権限を持つ管理者になりすます（方法をご覧ください）。
- サービス アカウントの管理者ロールを直接付与します（方法をご覧ください）。
「入門」ガイド
アプリをブロックまたは信頼する方法
- 顧客管理者として管理コンソール（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 以外のスコープを入力する必要があります（デバイス、ユーザー、ブラウザ、組織部門、グループなどを管理する Directory API など）。
- [
Authorize] をクリックします。
管理者権限を管理する方法
Chrome Management API の各部分には、それぞれ異なる管理者権限が必要です。Reports API、App Details API、Telemetry API に必要な管理者権限を確認する。
権限を付与するには:
- 顧客管理者として管理コンソール（https://admin.google.com/）に移動します。
Admin roles ページに移動します。- 既存のロールを検索するか、必要な権限を持つ新しいロールを作成します。
- このロールは、ユーザーのメールアドレスまたはサービス アカウントのメールアドレスに割り当てます。
OAuth Playground でアプリをテストする方法
- Cloud コンソールで、アプリの OAuth クライアント ID を作成する際に（上記の OAuth 2.0 クライアント ID のセクションを参照）、アプリケーションの種類として [ウェブ アプリケーション] を選択します。
- [名前] を入力します。
- アプリをテストするには、[承認済みのリダイレクト URI] に
https://developers.google.com/oauthplayground を追加します。テストが完了したら、アプリからリダイレクト URI を削除できます。
Create をクリックして、「client ID」と「client secret」をコピーします。- OAuth Playground に移動します。
- 右上の歯車アイコン（[OAuth 2.0 Configuration]）をクリックし、[
Use your own OAuth credentials] を選択して、[OAuth Client ID] と [OAuth Client secret] を入力します。
OAuth Playground での手順
API を選択して承認します。
スコープの入力フィールドに https://www.googleapis.com/auth/chrome.management.reports.readonly（または他の API スコープ）を追加して、[Authorize APIs] をクリックします。顧客管理者アカウントを使用して承認します。利用規約に同意します。
認証コードをトークンと交換します。
[Exchange authorization code for tokens] をクリックします。必要に応じて、[Auto-refresh the token before it expires] をクリックします。
API へのリクエストを構成します。
[リクエスト URI] テキスト ボックスに API の URL を入力します。API 仕様に従って、「HTTP Method」、「Enter request body」などを変更します。たとえば、組織内でインストール済みのアプリの数をカウントするには、https://chromemanagement.googleapis.com/v1alpha1/customers/my_customer/reports:countInstalledApps という URL を使用します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は 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`"]]
