Chrome Management Enrollment Tokens API を使用すると、管理者は Chrome Enterprise Core に Chrome ブラウザを登録するために使用される登録トークンを管理できます。この API セットを使用すると、デバイスの登録トークンを作成、取得、一覧表示、取り消しを行うことができます。
API メソッドの概要
URL は https://chromemanagement.googleapis.com/v1/customers/{customer_id} に対する相対 URL です
| 説明 | 相対 URL | HTTP メソッド |
|---|---|---|
| 登録トークンを作成する | /enrollmentTokens | POST |
| 登録トークンを取得する | /enrollmentTokens/{token_permanent_id} | GET |
| 登録トークンを一覧表示する | /enrollmentTokens | GET |
| 登録トークンを取り消す | /enrollmentTokens/{token_permanent_id}:revoke | POST |
リクエストとレスポンスの例については、コードサンプルをご覧ください。
結果をフィルタリングする
/enrollmentTokens メソッドを使用して登録トークンを一覧表示する場合は、filter クエリ パラメータを使用して結果を絞り込むことができます。HTTP リクエストで送信されるすべてのフィルタ パラメータは、URL エスケープする必要があります。複数の条件は、AND 演算子を使用して組み合わせることができます。
- 文字列フィールドと列挙型フィールド:
=比較演算子と:比較演算子をサポートします。 - 組織部門のフィルタリング:
org_unit_pathまたはorg_unit_idを指定して、特定の組織部門用に作成されたトークンをフィルタできます。
フィルタリング可能なフィールド
| フィールド | 説明 |
|---|---|
device_type
|
登録トークンが使用されるデバイスタイプ（現在は CHROME_BROWSER）。 |
token_state
|
登録トークンの状態（ACTIVE、EXPIRED、REVOKED）。 |
org_unit_path
|
登録トークンの組織部門のパス（例: /Marketing）。 |
org_unit_id
|
登録トークンの組織部門の難読化された ID。 |
管理者権限
Chrome Management Enrollment Tokens API は、管理者ロールの委任を尊重します。
| メソッド | 必要な管理者権限 |
|---|---|
| CreateEnrollmentToken | [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] |
| GetEnrollmentToken | [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] または [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] -> [読み取り] |
| ListEnrollmentTokens | [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] または [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] -> [読み取り] |
| RevokeEnrollmentToken | [サービス] -> [Chrome 管理] -> [設定] -> [管理対象ブラウザ] |
管理者ロールと権限を管理するには、[管理コンソール] -> [管理者ロール] にアクセスしてください。
API スコープ
Chrome Management Enrollment Tokens API には、次の OAuth スコープが必要です。
| メソッド | 必要な OAuth スコープ |
|---|---|
| CreateEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| GetEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens または https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| ListEnrollmentTokens | https://www.googleapis.com/auth/chrome.management.enrollmenttokens または https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| RevokeEnrollmentToken | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
詳細については、認証の概要をご覧ください。