알림

사무실 복귀 전략을 세우고 있나요? Chrome OS를 어떻게 활용할 수 있을지 알아보세요.

Chrome 브라우저 클라우드 관리 설정

Chrome 브라우저 클라우드 관리 API 사용

Topics

승인 

모든 Chrome 브라우저 클라우드 관리 API를 사용하기 전에 이 링크에 따라 사용 설정할 프로젝트를 선택하여 Google Play Console에서 Admin SDK API를 사용 설정해야 합니다 (아직 사용 설정되지 않은 경우). 있습니다.

여기에서 API에 액세스하기 위한 토큰을 얻는 방법에는 두 가지가 있습니다.

  1. 서비스 계정을 사용한 가장 기능이 포함된 Oauth 2.0("가장 기능으로 승인" 섹션 참조)
  2. 가장 기능이 없는 3-Legged Oauth2.0 (Oauth2 가이드라인에 따라 요청을 승인할 수 있음)

Chrome 브라우저 클라우드 관리 API에 대한 액세스를 승인하려면 다음 범위가 필요합니다.

https://www.googleapis.com/auth/admin.directory.device.chromebrowsers.readonly

또는

https://www.googleapis.com/auth/admin.directory.device.chromebrowsers

가장 기능으로 승인

가장 기능에 관한 서비스 계정을 만들려면 다음 단계를 따르세요.

  1.  서비스 계정을 만들고 이 서비스 계정에 필요한 서비스 계정 키를 갖습니다. 여기를 따라 서비스 계정을 만들고 서비스 계정 키를 가져올 수 있습니다. 
  2. 이 서비스 계정의 클라이언트 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에 저장되어 있으며 요청하는 데 사용할 관리자 계정이 admin@domain.com이면 실행 가능한 파일을 다음 인수로 실행합니다.

ApiRequestHelper /home/private_key.json admin@domain.com

 

참고:  사용된 관리자 이메일은 서비스 계정의 이메일(<project-name>-<id>@<project-name>.iam.gserviceaccount.com 형식)이 아닙니다.

Chrome 브라우저

Chrome 브라우저 클라우드 관리에 등록된 Chrome 브라우저

리소스 표현

디렉터리 API의 Chrome 브라우저 리소스에 사용되는 JSON 템플릿은 다음과 같습니다.

{

"kind": "admin#directory#browserdevice",

"deviceId": 문자열,

"osPlatform": 문자열,

"osPlatformVersion": 문자열,

"osArchitecture": 문자열,

"osVersion": 문자열,

"machineName": 문자열,

"annotationdLocation": 문자열,

"annotationdUser": 문자열,

"annotationdAssetId": 문자열,

"annotationdNotes": 문자열,

"lastPolicyFetchTime": 날짜/시간,

"lastRegistrationTime": 날짜/시간,

"lastActivityTime": 날짜/시간,

"lastStatusReportTime": 날짜/시간,

"virtualDeviceId": 문자열,

"serialNumber": 문자열,

"orgUnitPath": 문자열,

"extensionCount": 정수,

"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": 문자열,

      "organizeAppPolicy": 문자열,

      "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 브라우저 기기에서 마지막으로 로그인한 사용자입니다.
    "annotationd_user" - 관리자가 주석을 추가한 Chrome 브라우저 기기 사용자입니다.
    "annotationd_location" - 관리자가 주석을 추가한 Chrome 브라우저 기기 위치입니다.
    "annotationd_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입니다.
프로젝션 문자열 선택된 필드 집합으로 반환되는 정보를 제한합니다.
    사용 가능한 값:
    '기본' - 기본 메타데이터 필드 (예: 위에 나열된 관리 콘솔 브라우저 목록의 열에 있는 필드)만 포함합니다.
    'FULL' - 모든 메타데이터 필드 포함 (위에 열거됨)
검색어 문자열 아래 섹션(쿼리 언어 필터링)에 설명된 목록 페이지 쿼리 언어를 사용하여 문자열을 검색합니다.
sortOrder 문자열 결과를 오름차순으로 또는 내림차순으로 반환할지 여부입니다. orderBy 매개변수와 함께 사용해야 합니다.
    사용 가능한 값:
    "ASCENDING" - 오름차순입니다.
    "DESCENDING" - 내림차순입니다.

예: 시스템 이름으로 기기 필터링

첫 번째 예시에서는 query=machine_name:CLIENT2012를 사용하여 특정 시스템 이름을 검색합니다. 응답에는 단일 Chrome 브라우저 리소스가 포함됩니다. 여기서 machineName은 헬프 데스크입니다.

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 메서드의 응답으로 반환됩니다. 참고: 이 매개변수는 필수 항목입니다.
프로젝션 문자열 응답에 속성의 전체 목록을 포함할지 아니면 하위 집합만 포함할지 결정합니다.
    사용 가능한 값:
    '기본': 기본 메타데이터 필드 (예: 위에 열거된 관리 콘솔 브라우저 목록의 열에 있는 필드)만 포함됩니다.
    'FULL': 모든 메타데이터 필드 포함 (위에 열거됨)

예

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 기기 ID는 Chrome 브라우저에서 동일한 시스템으로 식별한 여러 시스템에서 공유됩니다. 지원 값은 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' 쿼리 매개변수를 추가하여 모든 쿼리를 특정 조직 단위로 필터링할 수 있습니다.

 

  1. 다음 단어가 포함된 시스템 이름을 사용하는 모든 기기를 찾습니다.
    1. machine_name:LIX
  2. 특정 날짜 이후에 등록된 단어가 포함된 시스템 이름을 사용하는 모든 기기를 찾습니다.
    1. machine_name:LIX register:​2011-04-26..
  3. 특정 날짜 이전에 등록된 단어가 포함된 시스템 이름을 사용하는 모든 기기를 찾습니다.
    1. machine_name:LIX register:​..2011-04-26

 

현재 지원되지 않는 쿼리:

  1. 특정 수의 확장 프로그램이 설치된 모든 기기를 찾습니다 (숫자 값에 대한 범위 쿼리는 지원되지 않음).
  2. 가능한 두 단어 중 하나가 포함된 시스템 이름이 있는 모든 기기를 찾습니다 (쿼리에서 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 상태 코드가 반환됩니다. 

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?

도움이 더 필요하신가요?

다음 단계를 시도해 보세요.

도움말 커뮤니티에 게시하기 커뮤니티 회원의 답변 받기
true
검색
검색어 지우기
검색 닫기
기본 메뉴
1305673221183166430
true
도움말 센터 검색
true
true
true
true
true
410864
false
false