Chrome 관리 등록 토큰 API를 사용하면 관리자가 Chrome Enterprise Core에 Chrome 브라우저를 등록하는 데 사용되는 등록 토큰을 관리할 수 있습니다. 이 API 집합은 기기의 등록 토큰을 생성, 검색, 나열, 취소하는 데 사용할 수 있습니다.
API 메서드 간략 개요
URL은 https://chromemanagement.googleapis.com/v1/customers/{customer_id}을 기준으로 합니다.
| 설명 | 상대 URL | Http 메소드 |
|---|---|---|
| 등록 토큰 만들기 | /enrollmentTokens | POST |
| 등록 토큰 가져오기 | /enrollmentTokens/{token_permanent_id} | YouTube 최신 소식 |
| 등록 토큰 나열 | /enrollmentTokens | YouTube 최신 소식 |
| 등록 토큰 취소 | /enrollmentTokens/{token_permanent_id}:revoke | POST |
요청 및 응답 예시는 코드 샘플을 참고하세요.
결과 필터링 중
/enrollmentTokens 메서드로 등록 토큰을 나열할 때 filter 쿼리 매개변수를 사용하여 결과를 좁힐 수 있습니다. 모든 필터 매개변수는 HTTP 요청으로 전송될 때 URL로 이스케이프되어야 합니다. AND 연산자를 사용하여 여러 조건을 결합할 수 있습니다.
- 문자열 및 Enum 필드:
=및:비교 연산자를 지원합니다. - 조직 단위 필터링:
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 |
자세한 내용은 인증 개요를 참고하세요.