주제
승인
모든 Chrome Enterprise Core API를 사용하기 전에 이 링크에 따라 API를 사용 설정하려는 프로젝트를 선택하여 Google Play Console에서 Admin SDK API를 사용 설정해야 합니다(아직 사용 설정되지 않은 경우).
여기에서 API에 액세스할 토큰을 얻는 방법에는 두 가지가 있습니다.
- 서비스 계정을 사용한 가장 기능이 포함된 Oauth 2.0("가장 기능으로 승인" 섹션 참조)
- 가장 기능이 없는 3-Legged Oauth2.0(Oauth2 가이드라인에 따라 요청을 승인할 수 있음)
Chrome Enterprise Core API에 대한 액세스를 승인하려면 다음 범위가 필요합니다.
https://www.googleapis.com/auth/admin.directory.device.chromebrowsers.readonly
또는
https://www.googleapis.com/auth/admin.directory.device.chromebrowsers
가장 기능으로 승인
가장 기능에 관한 서비스 계정을 만들려면 다음 단계를 따르세요.
- 서비스 계정을 만들고 이 서비스 계정에 필요한 서비스 계정 키를 갖습니다. 여기를 따라 서비스 계정을 만들고 서비스 계정 키를 가져올 수 있습니다.
- 이 서비스 계정의 클라이언트 ID는 위에 나열된 OAuth 범위에 대해 승인되어야 합니다. 이렇게 하려면 관리 콘솔의 보안 -> API 관리 -> 도메인 전체 위임 관리로 이동해야 합니다. 그런 다음 새 클라이언트를 추가합니다. 이 대화상자에서 클라이언트 ID는 서비스 계정의 고유 ID에 해당합니다.
서비스 계정 키를 사용하는 경우 선호하는 언어의 Google API 클라이언트 라이브러리를 사용하여 서비스 계정의 OAuth 액세스 토큰을 요청해야 합니다.
또한 OAuth 토큰 요청은 OAuth 토큰을 요청할 때 도메인의 관리자를 가장해야 합니다.
예를 들어 Java API 클라이언트 라이브러리를 사용하여 OAuth 토큰을 가져오는 샘플 코드는 다음과 같습니다.
package takeout.api.credentials;
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
public final class ApiRequestHelper {
public static String getAccessToken(
String serviceAccountKeyFilePath, String adminUserToImpersonate, Collection<String> scopes)
throws IOException {
InputStream is = new FileInputStream(serviceAccountKeyFilePath);
GoogleCredential credential =
GoogleCredential.fromStream(is).toBuilder()
.setServiceAccountScopes(scopes)
.setServiceAccountUser(adminUserToImpersonate)
.build();
if (!credential.refreshToken()) {
throw new RuntimeException(
String.format(
"Failed to fetch refresh token for service account defined in '%s' for user '%s' and"
+ " scopes '%s'",
serviceAccountKeyFilePath, adminUserToImpersonate, String.join(",", scopes)));
}
return credential.getAccessToken();
}
public static void printUsage() {
System.out.println(
"Usage: get_access_token <service account key file> <admin user> [<scope,scope>]");
}
public static void main(String[] args) throws Exception {
if (args.length < 2) {
printUsage();
return;
}
String scopes =
"https://www.googleapis.com/auth/admin.directory.device.chromebrowsers";
if (args.length >= 3) {
scopes = args[2];
}
System.out.println(
getAccessToken(args[0], args[1], new ArrayList<String>(Arrays.asList(scopes.split(",")))));
}
private ApiRequestHelper() {}
}
이 샘플 코드를 사용하면 API를 호출하는 데 사용할 수 있는 액세스 토큰을 가져올 수 있습니다. 예를 들어 키 파일이 /home/private_key.json에 저장되어 있고 요청에 사용할 관리자 계정이 [email protected]인 경우 다음과 같은 인수를 사용하여 실행 파일을 실행합니다.
ApiRequestHelper /home/private_key.json [email protected]
참고: 사용된 관리자 이메일은 서비스 계정의 이메일(<project-name>-<id>@<project-name>.iam.gserviceaccount.com 형식)이 아닙니다.
Chrome 브라우저
Chrome Enterprise Core에 등록된 Chrome 브라우저입니다.
리소스 표현
디렉터리 API의 Chrome 브라우저 리소스에 사용되는 JSON 템플릿은 다음과 같습니다.
{
"kind": "admin#directory#browserdevice",
"deviceId": 문자열,
"osPlatform": 문자열,
"osPlatformVersion": 문자열,
"osArchitecture": 문자열,
"osVersion": 문자열,
"machineName": 문자열,
"annotatedLocation": 문자열,
"annotatedUser": 문자열,
"annotatedAssetId": 문자열,
"annotatedNotes": 문자열,
"lastPolicyFetchTime": 날짜/시간,
"lastRegistrationTime": 날짜/시간,
"lastActivityTime":dateTime,
"lastStatusReportTime":dateTime,
"virtualDeviceId": 문자열,
"serialNumber": 문자열,
"orgUnitPath": 문자열,
"extensionCount":int,
"policyCount": 정수,
"safeBrowsingClickThroughCount": 정수,
"lastDeviceUser": 문자열,
"browserVersions": [문자열],
"lastDeviceUsers":[
"userName": 문자열,
"lastStatusReportTime": 날짜/시간,
]
"machinePolicies": [
"source": 문자열,
"name": 문자열,
"value": 문자열,
"error": 문자열,
]
"browsers": [
"browserVersion": 문자열,
"channel": 문자열,
"lastStatusReportTime": 날짜/시간,
"lastPolicyFetchTime": 날짜/시간,
"executablePath": 문자열,
"installedBrowserVersion": 문자열,
"plugins":[
"name": 문자열,
"description": 문자열,
"fileame" 문자열,
]
"profiles": [
"name": 문자열,
"id": 문자열,
"lastStatusReportTime": 날짜/시간,
"lastPolicyFectchTime": 날짜/시간,
"safeBrowsingWarnings": 정수,
"safeBrowsingWarningsClickThrough": 정수,
"chromeSignedinUserEmail": 문자열,
"extensionPolicies": [
"extensionId": 문자열,
"extensionName": 문자열,
"policies": [
"source": 문자열,
"name": 문자열,
"value": 문자열,
"error": 문자열,
]
]
"extensions": [
"extensionId": 문자열,
"version": 문자열,
"permissions": [문자열],
"name": 문자열,
"description": 문자열,
"appType": 문자열,
"homepageUrl": 문자열,
"installType": 문자열,
"configuredAppPolicy": 문자열,
"disabled": 불리언,
"icons": [
"size": 정수,
"url": 문자열,
]
]
"userPolicies": [
"source": 문자열,
"name": 문자열,
"value": 문자열,
"error": 문자열,
]
"safeBrowsingWarningsResetTime": 문자열
]
}
API 호출
계정의 모든 Chrome 브라우저 기기 검색하기
제한사항: 목록 요청으로 반환된 nextPageToken은 1시간 동안 유효합니다. 목록 요청에 Chrome 브라우저 기기가 많은 경우 모든 기기 등록정보를 완료하기 전에 페이지 토큰이 만료될 수 있습니다. 이 경우 쿼리에서 반환되는 기기 수를 줄이기 위해 목록 요청에 필터를 적용하는 것이 좋습니다. 일반적으로 OU별로 필터링하면 결과 수를 줄일 수 있습니다.
계정에 할당된 모든 Chrome 브라우저 기기의 목록을 반환하려면 다음 GET 요청을 사용하고 승인에 설명된 승인을 포함합니다. 가독성을 위해 이 코드 샘플에는 줄바꿈이 포함되어 있습니다.
GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers?projection={FULL|BASIC}&query={query string}&orderBy={orderBy
category}&sortOrder={ASCENDING|DESCENDING}&pageToken={token for next results
page, if applicable &maxResults=max number of results per page}
- customerId는 고객 Google 계정의 고유 식별자입니다.
- 계정 관리자를 가장할 때는 계정의 customerId를 나타내는 문자열 my_customer를 사용할 수도 있습니다. customerId 값을 가져오기 위한 다른 방법으로 사용자 검색 작업을 사용할 수 있습니다. 관리자 이메일 주소 또는 작업의 userKey 경로 매개변수에 포함된 관리자 고유 사용자 ID 값을 사용하세요.
요청에 사용할 수 있는 모든 쿼리 문자열 매개변수는 다음과 같습니다.
| 매개변수 | 유형 | 설명 |
|---|---|---|
| maxResults | 정수 | 반환할 결과의 최대 수입니다. 기본값은 100입니다. |
| orderBy | 문자열 | 결과 정렬에 사용할 Chrome 브라우저 기기 속성입니다. |
| 허용되는 값: | ||
| "id": Chrome 브라우저가 설치된 기기의 ID입니다. | ||
| "last_sync": Chrome 브라우저 기기가 마지막으로 등록되었거나, 마지막으로 정책 설정과 동기화되었거나, 보고서를 업로드한 날짜 및 시간입니다. | ||
| "machine_name": 기기와 연결된 컴퓨터의 이름입니다. | ||
| "extension_count": Chrome 브라우저 기기에서 보고된 총 확장 프로그램 수입니다. | ||
| "policy_count": Chrome 브라우저 기기에서 보고된 총 정책 수입니다. | ||
| "os_version": Chrome 브라우저가 설치된 기기의 OS입니다. | ||
| "last_signed_in_user": Chrome 브라우저 기기에 마지막으로 로그인한 사용자입니다. | ||
| "annotated_user": 관리자가 주석을 추가한 Chrome 브라우저 기기 사용자입니다. | ||
| "annotated_location": 관리자가 주석을 추가한 Chrome 브라우저 기기 위치입니다. | ||
| "annotated_asset_id": 관리자가 주석을 추가한 Chrome 브라우저 기기 자산 ID입니다. | ||
| "notes": 관리자가 주석을 추가한 Chrome 브라우저 기기 메모입니다. | ||
| "browser_version_channel": 기기에서 보고한 마지막 Chrome 버전 및 채널입니다. | ||
| "org_unit": 기기가 속한 조직 단위입니다. | ||
| "enrollment_date": 기기의 등록 날짜입니다. | ||
| "save_browsing_clickthrough": 이 기기에서 보고한 세이프 브라우징 클릭연결 수입니다. | ||
| "platform_major_version": OS 유형 및 메이저 버전입니다(예: Windows 10). | ||
| "last_activity": 기기의 마지막 활동 시간입니다. | ||
| "browser_version_sortable": 기기에 설치된 가장 오래된 브라우저 버전입니다. | ||
| "os_version_sortable": OS 유형 및 전체 버전입니다. | ||
| orgUnitPath | 문자열 | 조직 단위의 전체 경로 또는 고유 ID입니다. |
| groupId | 문자열 | groups/{group} 형식의 그룹의 전체 리소스 이름 또는 고유 ID입니다. |
| pageToken | 문자열 | pageToken 쿼리 매개변수는 쿼리 결과의 다음 페이지를 요청하는 데 사용됩니다. 후속 요청의 pageToken 쿼리 매개변수는 이전 응답의 nextPageToken입니다. |
| 프로젝션 | 문자열 | 선택한 필드 집합으로 반환되는 정보를 제한합니다. |
| 사용 가능한 값: | ||
| '기본' - 기본 메타데이터 필드 (예: 위에 나열된 관리 콘솔 브라우저 목록의 열에 있는 필드)만 포함합니다. | ||
| '전체': 위에 나열된 모든 메타데이터 필드를 포함합니다. | ||
| 검색어 | 문자열 | 아래 섹션(쿼리 언어 필터링)에 설명된 목록 페이지 쿼리 언어를 사용하여 문자열을 검색합니다. |
| sortOrder | 문자열 | 결과를 오름차순 또는 내림차순으로 반환하도록 지정합니다. orderBy 매개변수와 함께 사용해야 합니다. |
| 사용 가능한 값: | ||
| "ASCENDING" - 오름차순입니다. | ||
| "DESCENDING" - 내림차순입니다. |
예: 시스템 이름으로 기기 필터링
첫 번째 예시에서는 query=machine_name:CLIENT2012를 사용하여 특정 시스템 이름을 검색합니다. 응답에는 machineName이 help desk인 단일 Chrome 브라우저 리소스가 포함되어 있습니다.
JSON 요청
GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers?projection=BASIC&query=machine_name:CLIENT2012&orderBy=status
&sortOrder=ASCENDING&maxResults=100
JSON 응답
요청이 성공하면 HTTP 200 상태 코드가 반환됩니다. 쿼리 매개변수와 일치하는 브라우저 기기 목록과 함께 다음이 표시됩니다.
{
"kind": "directory#browserdevices",
"browsers": [
{
"deviceId": "device_id_value",
"kind": "admin#directory#browserdevice",
"osPlatform": "Windows",
"osVersion": "6.3.9600.19505",
"machineName": "CLIENT2012",
"lastRegistrationTime": "2019-11-04T00:29:17.484Z",
"lastActivityTime": "2019-11-04T00:29:17.484Z",
"virtualDeviceId": "virtual_device_id",
"orgUnitPath": "/Org-unit path",
},
],
"nextPageToken": "abcdefghijkl123"
}
Chrome 브라우저 기기 검색하기
Chrome 브라우저 기기의 속성을 가져오려면 다음 GET 요청을 사용하고 승인 요청에 설명된 승인을 포함합니다. 가독성을 위해 이 코드 샘플에는 줄바꿈이 포함되어 있습니다.
GET
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/deviceId?projection={FULL|BASIC}
- customerId는 고객 Google 계정의 고유 식별자입니다.
- 계정 관리자를 가장할 때는 계정의 customerId를 나타내는 문자열 my_customer를 사용할 수도 있습니다. customerId 값을 가져오기 위한 다른 방법으로 사용자 검색 작업을 사용할 수 있습니다. 관리자 이메일 주소 또는 작업의 userKey 경로 매개변수에 포함된 관리자 고유 사용자 ID 값을 사용하세요.
- deviceId는 기기의 고유 식별자이며 '모든 Chrome 브라우저 기기 검색' 작업의 응답에서 찾을 수 있습니다. 쿼리 문자열, 요청, 응답 속성은 API 참조를 참고하세요.
요청에 사용할 수 있는 모든 쿼리 문자열 매개변수는 다음과 같습니다.
| 매개변수 | 유형 | 설명 |
|---|---|---|
| deviceId | 문자열 | 기기의 고유 ID입니다. deviceId는 browsersdevices.list 메서드의 응답으로 반환됩니다. 참고: 이 매개변수는 필수 항목입니다. |
| 프로젝션 | 문자열 | 응답에 전체 속성 목록이 포함되어 있는지 또는 하위 집합만 포함되어 있는지 확인합니다. |
| 사용 가능한 값: | ||
| '기본': 기본 메타데이터 필드(예: 위에 나열된 관리 콘솔 브라우저 목록의 열에 있는 필드)만 포함합니다. | ||
| '전체': 위에 나열된 모든 메타데이터 필드를 포함합니다. |
예
JSON 요청
요청 예입니다. 가독성을 위해 이 코드 샘플에는 줄바꿈이 포함되어 있습니다.
GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/deviceId?projection=basic
JSON 응답
요청이 성공하면 HTTP 200 상태 코드가 반환됩니다. 응답에는 상태 코드와 함께 Chrome 브라우저 기기 속성이 반환됩니다.
{
"deviceId": "device_id_value",
"kind": "admin#directory#browserdevice",
"osPlatform": "Windows",
"osVersion": "6.3.9600.19542",
"machineName": "CLIENT2012",
"lastRegistrationTime": "2019-11-27T12:55:27.230Z",
"lastActivityTime": "2019-11-27T12:55:27.230Z",
"virtualDeviceId": "virtual_device_id",
"orgUnitPath": "/Org-unit path",
"deviceIdentifiersHistory": {
"records": [
{
"identifiers": {
"machineName": "CLIENT2012",
"serialNumber": "ABCD1234567890" },
"firstRecordTime": "2019-11-27T12:55:27.230Z",
"lastActivityTime": "2019-11-27T12:55:27.230Z"}
],
“has_device_id_collision”: “false”
}
}
쿼리 언어 필터링하기
목록 요청에 'query' 매개변수를 사용하는 경우 쿼리의 모든 검색어가 특정 브라우저 기기와 일치해야 유효합니다. 쿼리에 연산자 (필드)를 지정하지 않으면 내부적으로 색인이 생성된 모든 텍스트 필드에 지정된 검색어가 모두 포함된 브라우저가 검색됩니다. 예를 들어 쿼리가 'query=machine 73'인 경우 다음과 같이 브라우저 기기에서 반환될 수 있는 모든 필드에 'machine'과 '73'이라는 용어가 모두 있는 브라우저가 반환됩니다.
{
"deviceId": "device_id_value",
"kind": "admin#directory#browserdevice",
"osPlatform": "Windows",
"osVersion": "6.3.9600.19542",
"machineName": "machine_name",
"browser_versions": [
"73.0.0.0",
],
"lastActivityTime": "2019-11-27T12:55:27.230Z",
"virtualDeviceId": "virtual_device_id",
"orgUnitPath": "/Org-unit path",
}
참고 1: 단어 경계 (구두점 또는 공백)에서 매치가 이루어지므로 단어의 부분 일치는 불가능합니다. 위 예에서는 query='mach 73'을 실행할 수 없습니다.
참고 2: 단어 일치는 대소문자를 구분하지 않으므로 'machine'이 포함된 쿼리는 'machine'뿐만 아니라 'machine'과도 모두 일치하게 됩니다.
다음 필드를 지정하여 검색을 특정 필드로 타겟팅할 수 있습니다 (참고: 쿼리 단어는 대소문자를 구분하지 않지만 필드 이름은 대소문자를 구분합니다).
| 필드 | 설명 |
|---|---|
| machine_name | Chrome 브라우저 기기의 시스템 이름입니다. |
| os_platform | Chrome 브라우저 기기의 OS 플랫폼입니다. (예: Windows) |
| arch | Chrome 브라우저 기기의 CPU 아키텍처입니다. (예: x86_64) |
| os_version | Chrome 브라우저 기기의 OS 버전입니다. (예: 10.0.16299.904) |
| 위치 | Chrome 브라우저 기기의 주석이 달린 위치입니다. |
| 사용자 | Chrome 브라우저 기기의 주석이 달린 사용자입니다. |
| asset_id | Chrome 브라우저 기기의 주석이 달린 자산 ID입니다. |
| note | Chrome 브라우저 기기의 주석이 달린 메모입니다. |
| register | Chrome 브라우저 기기의 등록 시간입니다. |
| os | Chrome 브라우저 기기의 OS 플랫폼 및 주요 OS 버전(예: 'Windows 10') 결합 |
| browser_version | Chrome 브라우저 기기에 설치되고 보고된 Chrome 브라우저(예: 73)입니다. |
| enrollment_token | Chrome 브라우저 기기를 등록하는 데 사용된 등록 토큰입니다. |
| report | Chrome 브라우저 기기의 마지막 보고 시간입니다. |
| 동기화 | Chrome 브라우저 기기의 마지막 정책 동기화 시간입니다. |
| num_extensions | Chrome 브라우저 기기에서 보고된 확장 프로그램 수입니다. |
| num_policies | Chrome 브라우저 기기에서 보고된 정책 수입니다. |
| machine_user | Chrome 브라우저 기기의 마지막으로 보고된 사용자입니다. |
| last_activity | Chrome 브라우저 기기에서 마지막으로 활동(정책 가져오기 또는 보고)을 표시한 시간입니다. |
| has_device_id_collision | Chrome 브라우저에서 동일한 시스템으로 식별하는 여러 시스템은 기기 ID를 공유합니다. 지원 값은 true와 false입니다. |
시간을 허용하는 필드 (등록, 보고, 동기화, last_activity)의 경우 시간 형식은 YYYY-MM-DDThh:mm:ss (예: 2020-01-01T12:00:00)입니다. 시간에 대해 열리거나 닫힌 범위를 지정할 수도 있습니다.
|
양식 |
의미 |
예 |
|
datetime |
정확하게 지정된 날짜 또는 시간 |
2011-03-23 2011-04-26T14:23:05 |
|
datetime..datetime |
지정된 날짜 또는 시간을 포함하는 기간 |
2011-03-23..2011-04-26 |
|
datetime.. |
지정된 날짜나 시간 또는 그 이후 |
2011-04-26T14:23:05.. |
|
..datetime |
지정된 날짜나 시간 또는 그 이전 |
..2011-04-26T14:23:05 |
쿼리 필터링의 예
참고 1: 제공된 모든 예에서는 요청에 'query' 매개변수를 사용합니다. 이러한 매개변수 값은 URL에서 올바르게 이스케이프 처리되어야 합니다(예:, 다중 조건 요청이 있는 공백을 이스케이프 처리).
참고 2: 모든 쿼리는 요청에 'orgUnitPath' 쿼리 매개변수를 추가하여 특정 조직 단위로 추가로 필터링할 수 있습니다.
- 특정 단어가 포함된 시스템 이름을 사용하는 모든 기기를 찾습니다.
machine_name:LIX
- 특정 날짜 이후에 등록된 단어가 포함된 시스템 이름을 사용하는 모든 기기를 찾습니다.
machine_name:LIX register:2011-04-26..
machine_name:LIX register:..2011-04-26
현재 지원되지 않는 쿼리:
- 설치된 확장 프로그램 수가 특정 수 미만인 모든 기기를 찾습니다(숫자 값의 범위 쿼리는 지원되지 않음).
- 가능한 두 단어(쿼리에서 OR을 사용) 중 하나가 포함된 시스템 이름을 사용하는 모든 기기를 찾습니다.
Chrome 브라우저 기기 업데이트하기
계정에 할당된 Chrome 브라우저 기기의 주석이 달린 필드를 업데이트하려면 다음 PUT 요청을 사용하고 '승인' 섹션에 따라 가져온 액세스 토큰을 포함합니다.
PUT
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/{deviceId}
- customerId는 고객 Google 계정의 고유 식별자입니다.
- 계정 관리자를 가장할 때는 계정의 customerId를 나타내는 문자열 my_customer를 사용할 수도 있습니다. customerId 값을 가져오기 위한 다른 방법으로 사용자 검색 작업을 사용할 수 있습니다. 관리자 이메일 주소 또는 작업의 userKey 경로 매개변수에 포함된 관리자 고유 사용자 ID 값을 사용하세요.
- deviceId는 기기의 고유 식별자이며 '모든 Chrome 브라우저 기기 검색' 작업의 응답에서 찾을 수 있습니다. 쿼리 문자열, 요청, 응답 속성은 API 참조를 참고하세요.
요청에 사용할 수 있는 모든 페이로드 매개변수는 다음과 같습니다.
| 매개변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
| deviceId | 필수 | 문자열 | 기기의 고유 ID입니다. deviceId는 browsersdevices.list 메서드의 응답으로 반환됩니다. 참고: 이 매개변수는 필수 항목입니다. |
| annotatedUser | 선택사항 | 문자열 | 관리자가 주석을 추가한 기기의 사용자입니다. |
| annotatedLocation | 선택사항 | 문자열 |
관리자가 주석을 추가한 기기의 주소 또는 위치입니다. |
| annotatedNotes | 선택사항 | 문자열 | 관리자가 주석을 추가한 이 기기에 대한 참고사항 |
| annotatedAssetId | 선택사항 | 문자열 |
관리자가 주석 처리하거나 등록 시 지정한 자산 식별자입니다. |
예
JSON 요청
요청 예입니다. 가독성을 위해 이 코드 샘플에는 줄바꿈이 포함되어 있습니다.
PUT https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value{
"deviceId": "device_id_value",
"annotatedUser": "user 1"
}
JSON 응답
요청이 성공하면 HTTP 200 상태 코드가 반환됩니다. 응답에는 상태 코드와 함께 Chrome 브라우저 기기 속성이 반환됩니다.
{
"deviceId": "device_id_value",
"kind": "admin#directory#browserdevice",
"osPlatform": "Windows",
"osVersion": "6.3.9600.19542",
"machineName": "CLIENT2012",
"lastRegistrationTime": "2019-11-27T12:55:27.230Z",
"lastActivityTime": "2019-11-27T12:55:27.230Z",
"virtualDeviceId": "virtual_device_id",
"orgUnitPath": "/Org-unit path",
"annotatedUser": "user 1"
}
Chrome 브라우저 기기 삭제하기
계정에 할당된 Chrome 브라우저 기기를 삭제하려면 다음 DELETE 요청을 사용하고 '승인' 섹션에 따라 가져온 액세스 토큰을 포함합니다.
DELETE
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices
chromebrowsers/{deviceId}
- customerId는 고객 Google 계정의 고유 식별자입니다.
- 계정 관리자를 가장할 때는 계정의 customerId를 나타내는 문자열 my_customer를 사용할 수도 있습니다. customerId 값을 가져오기 위한 다른 방법으로 사용자 검색 작업을 사용할 수 있습니다. 관리자 이메일 주소 또는 작업의 userKey 경로 매개변수에 포함된 관리자 고유 사용자 ID 값을 사용하세요.
- deviceId는 기기의 고유 식별자이며 '모든 Chrome 기기 가져오기' 작업의 응답에서 찾을 수 있습니다. 쿼리 문자열, 요청, 응답 속성은 API 참조를 참고하세요.
예
요청 예:
DELETE https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value
JSON 응답
요청이 성공하면 HTTP 200 상태 코드가 반환됩니다.
조직 단위 간에 Chrome 브라우저 기기 이동하기
계정에 할당된 Chrome 브라우저 기기를 한 조직 단위에서 다른 조직 단위로 이동하려면 다음 POST 요청을 사용하고 '승인' 섹션에 따라 가져온 액세스 토큰을 포함합니다.
POST
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices/chromebrowsers/moveChromeBrowsersToOu
- customerId는 고객 Google 계정의 고유 식별자입니다.
- 계정 관리자를 가장할 때는 계정의 customerId를 나타내는 문자열 my_customer를 사용할 수도 있습니다. customerId 값을 가져오기 위한 다른 방법으로 사용자 검색 작업을 사용할 수 있습니다. 관리자 이메일 주소 또는 작업의 userKey 경로 매개변수에 포함된 관리자 고유 사용자 ID 값을 사용하세요.
요청에 사용할 수 있는 모든 페이로드 매개변수는 다음과 같습니다.
| 매개변수 | 유형 | 설명 |
|---|---|---|
| resource_ids | 문자열 목록 |
이동할 Chrome 브라우저 기기의 고유 기기 ID 목록입니다. 요청당 최대 600개의 브라우저를 이동할 수 있습니다. |
| org_unit_path | 문자열 |
기기를 이동할 대상 조직 단위입니다. 조직 단위의 전체 경로 또는 'id:' 접두사가 붙은 해당 ID입니다. |
예
요청 예입니다.
POST https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/moveChromeBrowsersToOu{
"org_unit_path": "/new-path",
"resource_ids": ["device_id_value_1","device_id_value_2"],
}JSON 응답
요청이 성공하면 HTTP 200 상태 코드가 반환됩니다.