Chrome Management Chrome Browsers API를 사용하면 관리자가 데이터를 보고 Chrome Enterprise Core에 등록된 Chrome 브라우저를 관리할 수 있습니다. 이 API 집합을 사용하여 등록된 Chrome 브라우저를 나열하고, Chrome 브라우저를 검색하고, Chrome 브라우저의 주석 정보를 업데이트하고, 조직 단위 (OU) 간에 Chrome 브라우저를 이동하고, Chrome 브라우저에서 수집된 데이터를 삭제할 수 있습니다.
API 메서드 간략 개요
URL은 https://chromemanagement.googleapis.com/v1/customers/{customer_id}에 상대적입니다.
| 설명 | 상대 URL | Http 메소드 |
|---|---|---|
| 등록된 Chrome 브라우저 나열 | /chromeBrowsers | YouTube 최신 소식 |
| Chrome 브라우저 검색하기 | /chromeBrowsers/{browser_permanent_id} | YouTube 최신 소식 |
| Chrome 브라우저의 주석 정보 업데이트하기 | /chromeBrowsers/{browser_permanent_id} | PATCH |
| Chrome 브라우저를 새 조직 단위 (OU)로 이동하기 | /chromeBrowsers:move | POST |
| Chrome 브라우저에서 수집된 데이터 삭제하기 | /chromeBrowsers/{browser_permanent_id} | 삭제 |
요청 및 응답 예시는 코드 샘플을 참조하세요.
결과 필터링 중
/chromeBrowsers 메서드를 사용하여 Chrome 브라우저를 나열할 때 filter 쿼리 매개변수를 사용하여 결과의 범위를 좁힐 수 있습니다. 모든 필터 매개변수는 HTTP 요청으로 전송될 때 URL 이스케이프 처리되어야 합니다. AND 연산자를 사용하여 여러 조건을 결합할 수 있습니다.
- 문자열, 정수, Enum 필드:
=및:비교 연산자를 지원합니다. 와일드 카드*(접두사prefix*, 접미사*suffix, 하위 문자열*substring*또는 존재*)는machine_name,annotated_asset_id,browser_version에만=및:와 함께 지원됩니다(예:machine_name=LIX*또는browser_version:"*6367*"). 필드 이름이 없는 단순한 전역 문자열 리터럴 필터링도 지원됩니다. 색인이 생성된 문자열 필드에ABC가 포함된 경우ABC과 같은 단일 용어가 일치하고,AND또는 공백으로 결합된 여러 용어(예:machine AND 73또는machine 73)는 색인이 생성된 텍스트 필드에 지정된 모든 용어가 포함된 브라우저와 일치합니다(반면"machine 73"과 같은 따옴표로 묶인 여러 단어 문자열은 단일 필드 내에서 정확한 연속 구문과 일치함). - 타임스탬프 필드:
=,<=,>=비교 연산자를 지원합니다. 타임스탬프에는 큰따옴표로 묶인 RFC-3339 형식의 문자열이 필요합니다(예:"2020-01-01T12:00:00Z"또는"2012-04-21T11:30:00-04:00"). 닫힌 타임스탬프 범위는 비교를 사용하여 지정할 수 있습니다. - 조직 단위 필터링:
org_unit_path(예:org_unit_path=/Marketing)를 지정하여 특정 조직 단위에 속한 브라우저를 필터링할 수 있습니다. 단일 조직 단위 일치가 지원됩니다. - 그룹 필터링:
in_group함수 (예:in_group("groups/00gjdgxs0lm8l7o"))를 사용하여 특정 Cloud ID 그룹에 속한 브라우저를 필터링할 수 있습니다.
필터링 가능한 필드
| 필드 | 설명 |
|---|---|
browser_permanent_id
|
Chrome 브라우저 기기의 영구적인 고유 식별자입니다. |
last_policy_fetch_time
|
Chrome 브라우저 기기의 마지막 정책 가져오기 시간입니다. |
os_platform
|
Chrome 브라우저 기기의 OS 플랫폼입니다(예: WINDOWS, MAC, LINUX). |
os_architecture
|
Chrome 브라우저 기기의 OS 아키텍처입니다. |
os_version |
Chrome 브라우저 기기의 OS 버전입니다. |
machine_name
|
Chrome 브라우저 기기와 연결된 시스템의 이름입니다. |
annotated_location
|
Chrome 브라우저 기기의 주석이 달린 위치입니다. |
annotated_user
|
Chrome 브라우저 기기의 주석이 달린 사용자입니다. |
annotated_asset_id
|
Chrome 브라우저 기기의 주석이 달린 자산 ID입니다. |
annotated_note
|
Chrome 브라우저 기기의 주석이 달린 메모입니다. |
org_unit_path
|
Chrome 브라우저 기기의 조직 단위 경로입니다 (예: /Marketing). |
org_unit_id
|
Chrome 브라우저 기기의 조직 단위 ID입니다. |
last_registration_time
|
Chrome 브라우저 기기의 등록 시간입니다. |
os_platform_version
|
Chrome 브라우저 기기의 OS 플랫폼 및 메이저 버전입니다. |
browser_version
|
기기에 설치되고 보고된 Chrome 브라우저 버전입니다. |
last_status_report_time
|
Chrome 브라우저 기기의 마지막 상태 보고 시간입니다. |
extension_count
|
Chrome 브라우저 기기에 설치된 확장 프로그램 수입니다. |
policy_count
|
Chrome 브라우저 기기에 적용된 정책 수입니다. |
last_device_user |
기기에 마지막으로 로그인한 사용자입니다. |
last_activity_time
|
Chrome 브라우저 기기에서 마지막으로 활동 (정책 가져오기 또는 보고)을 표시한 시간입니다. |
device_id_collision
|
Chrome 브라우저에서 동일한 시스템으로 식별하는 여러 시스템에서 기기 ID를 공유하는지 여부 (true 또는 false) |
함수 필터링
| 함수 | 설명 |
|---|---|
in_group(string)
|
지정된 Cloud ID 그룹 리소스 이름 (형식: in_group("groups/{group_id}"))에 속하는 Chrome 브라우저 기기 목록을 필터링합니다. |
결과 정렬하기
orderBy 쿼리 매개변수를 사용하여 결과의 순서를 지정할 수 있습니다. 기본적으로 정렬은 오름차순입니다. 필드를 내림차순으로 지정하려면 필드 이름에 접미사 " desc"를 추가합니다 (예: last_activity_time
desc).
지정하지 않으면 기본 순서는 browser_permanent_id의 오름차순입니다.
지원되는 순서 지정 필드
browser_permanent_idlast_policy_fetch_timeannotated_userannotated_locationannotated_asset_idannotated_notesorg_unit_pathos_versionlast_registration_timeextension_countpolicy_countlast_device_usermachine_namebrowser_version_channelos_platform_versionlast_activity_timebrowser_version
관리자 권한
Chrome Browsers API는 관리자 역할 위임을 준수합니다.
| 메서드 | 관리자 권한 필요 |
|---|---|
| ListChromeBrowsers | '서비스 -> Chrome 관리 -> 설정 -> 관리 브라우저' 또는 '서비스 -> Chrome 관리 -> 설정 -> 관리 브라우저 -> 읽기' |
| GetChromeBrowser | '서비스 -> Chrome 관리 -> 설정 -> 관리 브라우저' 또는 '서비스 -> Chrome 관리 -> 설정 -> 관리 브라우저 -> 읽기' |
| UpdateChromeBrowser | '서비스 -> Chrome 관리 -> 설정 -> 관리 브라우저' |
| MoveChromeBrowsers | '서비스 -> Chrome 관리 -> 설정 -> 관리 브라우저' |
| DeleteChromeBrowser | '서비스 -> Chrome 관리 -> 설정 -> 관리 브라우저' |
관리자 역할 및 권한을 관리하려면 '관리 콘솔 -> 관리자 역할'로 이동하세요.
API 범위
Chrome Management Chrome Browsers API에는 다음 OAuth 범위가 필요합니다.
| 메서드 | OAuth 범위 필요 |
|---|---|
| ListChromeBrowsers | https://www.googleapis.com/auth/chrome.management.browsers 또는 https://www.googleapis.com/auth/chrome.management.browsers.readonly |
| GetChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers 또는 https://www.googleapis.com/auth/chrome.management.browsers.readonly |
| UpdateChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers |
| MoveChromeBrowsers | https://www.googleapis.com/auth/chrome.management.browsers |
| DeleteChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers |
자세한 내용은 인증 개요를 참조하세요.