Menyiapkan Chrome Enterprise Core

Menggunakan Chrome Enterprise Core API

Topik

Otorisasi 

Sebelum menggunakan semua Chrome Enterprise Core API, Anda harus mengaktifkan Admin SDK API (jika belum diaktifkan) di Google Developer Console dengan mengikuti link ini, lalu memilih project yang API-nya ingin Anda aktifkan.

Dari sana, Anda memiliki 2 pilihan untuk mendapatkan token guna mengakses API:

  1. Oauth2.0 dengan peniruan identitas menggunakan akun layanan (Baca di bawah bagian "Memberi Otorisasi dengan Peniruan Identitas")
  2. 3-legged Oauth2.0 tanpa peniruan identitas (Anda dapat mengizinkan permintaan Anda dengan mengikuti Pedoman Oauth2)

Cakupan berikut diperlukan untuk mengizinkan akses ke Chrome Enterprise Core API:

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

atau

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

Memberi Otorisasi dengan Peniruan Identitas

Bagi kami akun layanan untuk peniruan identitas, Anda harus:

  1.  Membuat akun layanan dan memiliki kunci akun layanan yang diperlukan untuk akun layanan ini. Anda dapat mengikuti bagian ini untuk membuat akun layanan dan mendapatkan kunci akun layanan. 
  2. Client ID untuk akun layanan ini harus diberi otorisasi untuk cakupan OAuth yang tercantum di atas. Untuk melakukannya, Anda harus membuka Konsol Admin di bagian Keamanan -> Kontrol API -> Kelola delegasi seluruh domain. Kemudian, Anda akan menambahkan klien baru. Pada dialog ini, Client ID sesuai dengan ID Unik akun layanan Anda.

Dengan kunci akun layanan, Anda harus menggunakan Library Klien Google API dari bahasa pilihan Anda untuk meminta Token Akses OAuth bagi akun layanan Anda. 

 

Selain itu, permintaan Token OAuth juga harus meniru identitas pengguna admin di domain Anda saat meminta Token OAuth. 

Sebagai contoh, berikut adalah beberapa kode contoh yang menggunakan Library Klien Java API untuk mengambil token 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() {}
}

Dengan menggunakan kode contoh ini, Anda akan dapat mengambil token akses yang dapat digunakan untuk memanggil API. Misalnya, jika file kunci Anda disimpan di /home/private_key.json dan akun admin yang ingin Anda gunakan untuk membuat permintaan adalah admin@domain.com, Anda akan menjalankan file yang dapat dieksekusi dengan argumen berikut:

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

 

Catatan: Email admin yang digunakan bukan email akun layanan Anda (yaitu email dengan format <project-name>-<id>@<project-name>.iam.gserviceaccount.com).

Browser Chrome

Browser Chrome yang terdaftar di Chrome Enterprise Core.

Representasi Resource

Template JSON berikut digunakan untuk resource Chromebrowser di Directory API:

{

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

"deviceId": string,

"osPlatform": string,

"osPlatformVersion": string,

"osArchitecture":string,

"osVersion": string,

"machineName": string,

"annotatedLocation": string,

"annotatedUser": string,

"annotatedAssetId": string,

"annotatedNotes": string,

"lastPolicyFetchTime": dateTime,

"lastRegistrationTime": dateTime,

"lastActivityTime":dateTime,

"lastStatusReportTime":dateTime,

"virtualDeviceId": string,

"serialNumber": string,

"orgUnitPath": string,

"extensionCount":int,

"policyCount": int,

"safeBrowsingClickThroughCount": int,

"lastDeviceUser": string,

"browserVersions": [string],

"lastDeviceUsers":[

  "userName": strin,

  "lastStatusReportTime":dateTime,

  ]

"machinePolicies": [

  "source": string,

  "name": string,

  "value": string,

  "error": string,

  ]

"browsers": [

  "browserVersion": string,

  "channel": string,

  "lastStatusReportTime": dateTime,

  "lastPolicyFetchTime": dateTime,

  "executablePath": string,

  "installedBrowserVersion": string,

  "plugins":[

    "name": string,

    "description": string,

    "fileame" string,

    ]

  "profiles": [

    "name": string,

    "id": string,

    "lastStatusReportTime": dateTime,

    "lastPolicyFectchTime": dateTime,

    "safeBrowsingWarnings": int,

    "safeBrowsingWarningsClickThrough": int,

    "chromeSignedinUserEmail": string,

    "extensionPolicies": [

      "extensionId": string,

      "extensionName": string,

      "policies": [

        "source": string,

        "name": string,

        "value": string,

        "error": string,

      ]

    ]

    "extensions": [

      "extensionId": string,

      "version": string,

      "permissions": [string],

      "name": string,

      "description":string,

      "appType": string,

      "homepageUrl": string,

      "installType": string,

      "configuredAppPolicy": string,

      "disabled": boolean,

      "icons": [

        "size": int,

        "url": string, 

      ]

    ]

    "userPolicies": [

      "source": string,

      "name": string,

      "value": string,

      "error": string,

    ]

    "safeBrowsingWarningsResetTime": string

  ]

}

Memanggil API 

Mengambil semua perangkat browser Chrome untuk akun 

Batasan: nextPageToken yang ditampilkan oleh permintaan listingan memiliki masa berlaku 1 jam. Jika permintaan listingan Anda memiliki perangkat browser Chrome dalam jumlah besar, masa berlaku token halaman Anda dapat berakhir sebelum Anda dapat menyelesaikan listingan semua perangkat. Dalam kasus ini, Anda mungkin ingin menerapkan filter ke permintaan listingan untuk mengurangi jumlah perangkat yang ditampilkan oleh kueri. Biasanya, memfilter menurut OU merupakan cara efektif untuk mengurangi jumlah hasil yang ditampilkan.

 

Untuk menampilkan daftar semua perangkat browser Chrome yang ditetapkan ke akun, gunakan permintaan GET berikut dan sertakan otorisasi yang dijelaskan di Otorisasi. Agar mudah dibaca, contoh kode ini diberi pemisahan baris.

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 adalah ID unik Akun Google pelanggan.
  • Saat meniru administrator akun, Anda juga dapat menggunakan string my_customer yang mewakili customerId akun Anda. Cara lain untuk mendapatkan nilai customerId adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilai ID pengguna unik administrator Anda di parameter jalur userKey operasi.

Berikut adalah referensi untuk semua parameter string kueri yang dapat digunakan dalam permintaan:

Parameter Jenis Deskripsi
maxResults bilangan bulat Jumlah hasil maksimum yang akan ditampilkan. Jumlah default dan maksimumnya adalah 100.
orderBy string Properti perangkat browser Chrome yang akan digunakan untuk mengurutkan hasil.
    Nilai yang dapat diterima adalah
    "id" - ID perangkat yang menginstal browser Chrome.
    "last_sync" - Tanggal dan waktu perangkat browser Chrome terakhir didaftarkan, terakhir disinkronkan dengan setelan kebijakan, atau terakhir mengupload laporan.
    "machine_name" - Nama perangkat yang terkait dengan perangkat.
    "extension_count" - Jumlah total ekstensi browser Chrome yang dilaporkan.
    "policy_count" - Jumlah total kebijakan yang dilaporkan di perangkat browser Chrome.
    "os_version" - OS perangkat tempat browser Chrome diinstal.
    "last_signed_in_user" - Pengguna terakhir yang login di perangkat browser Chrome.
    "annotated_user" - Pengguna perangkat browser Chrome seperti yang dianotasi oleh administrator.
    "annotated_location" - Lokasi perangkat browser Chrome seperti yang dianotasi oleh administrator.
    "annotated_asset_id" - ID aset perangkat browser Chrome seperti yang dianotasi oleh administrator.
    "notes" - Catatan perangkat browser Chrome seperti yang dianotasi oleh administrator.
    "browser_version_channel" - Saluran dan versi Chrome terakhir yang dilaporkan oleh perangkat.
    "org_unit" - Unit Organisasi tempat perangkat berada.
    "enrollment_date" - Tanggal pendaftaran perangkat.
    "save_browsing_clickthrough" - Jumlah klik-tayang Safe Browsing yang telah dilaporkan perangkat ini.
    "platform_major_version" - Jenis OS dan versi utama, misalnya (Windows 10).:
    "last_activity" - Waktu aktivitas terakhir untuk perangkat.:
    "browser_version_sortable" - Versi browser terlama yang diinstal di perangkat.:
    "os_version_sortable" - Jenis OS dan versi lengkap.:
orgUnitPath string Jalur lengkap unit organisasi atau ID uniknya.
groupId string Nama resource lengkap grup dalam bentuk groups/{group} atau ID uniknya.
pageToken string Parameter kueri pageToken digunakan untuk meminta halaman hasil kueri berikutnya. Parameter kueri pageToken untuk permintaan berikutnya adalah nextPageToken dari respons Anda sebelumnya.
projection string Membatasi informasi yang ditampilkan pada sekumpulan kolom yang dipilih.
    Nilai yang dapat diterima adalah:
    "BASIC" - Hanya menyertakan kolom metadata dasar (yaitu, kolom yang ditemukan di kolom daftar browser konsol admin seperti yang disebutkan di atas)
    "Full" - Menyertakan semua kolom metadata (seperti yang disebutkan di atas)
kueri string String penelusuran menggunakan bahasa kueri halaman daftar yang dijelaskan di bagian bawah (Filter Bahasa Kueri).
sortOrder string Apakah akan menampilkan hasil dalam urutan menaik atau menurun. Harus digunakan dengan parameter orderBy.
    Nilai yang dapat diterima adalah:
    "ASCending" - Urutan menaik.
    "DESCENDING" - Urutan menurun.

Contoh: Filter perangkat menurut nama perangkat

Contoh pertama ini menelusuri nama perangkat tertentu menggunakan query=machine_name:CLIENT2012. Respons berisi satu resource browser Chrome, di mana MachineName merupakan pusat bantuan:

Permintaan 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

Respons JSON

Permintaan yang berhasil akan menampilkan kode status HTTP 200. Bersama dengan daftar perangkat browser yang cocok dengan parameter kueri Anda:

{
  "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"
}

Mengambil perangkat browser Chrome 

Untuk mengambil properti perangkat browser Chrome, gunakan permintaan GET berikut dan sertakan otorisasi yang dijelaskan dalam Permintaan otorisasi. Agar mudah dibaca, contoh kode ini diberi pemisahan baris.

GET
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/deviceId?projection={FULL|BASIC}
  • customerId adalah ID unik Akun Google pelanggan.
  • Saat meniru administrator akun, Anda juga dapat menggunakan string my_customer yang mewakili customerId akun Anda. Cara lain untuk mendapatkan nilai customerId adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilai ID pengguna unik administrator Anda di parameter jalur userKey operasi.
  • deviceId adalah ID unik untuk perangkat dan ditemukan sebagai respons terhadap operasi Ambil semua perangkat browser Chrome. Untuk properti string kueri, permintaan, dan respons, lihat Referensi API.

Berikut adalah referensi untuk semua parameter string kueri yang dapat digunakan dalam permintaan:

Parameter Jenis Deskripsi
deviceId string ID unik perangkat. deviceIds ditampilkan dalam respons dari metode browsersdevices.list. Catatan: Parameter ini wajib diisi.
projection string Menentukan apakah respons berisi daftar lengkap properti atau hanya sebagian.
    Nilai yang dapat diterima adalah:
    "BASIC": Hanya menyertakan kolom metadata dasar (yaitu, kolom yang ditemukan di kolom daftar browser konsol admin seperti yang disebutkan di atas)
    "Full": Menyertakan semua kolom metadata (seperti yang disebutkan di atas)

Contoh

Permintaan JSON

Contoh permintaan Agar mudah dibaca, contoh kode ini diberi pemisahan baris.

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/deviceId?projection=basic

Respons JSON

Permintaan yang berhasil akan menampilkan kode status HTTP 200. Bersama dengan kode status, respons akan menampilkan properti perangkat browser 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”
  }
}

Memfilter bahasa kueri

 

Jika menggunakan parameter "query" dalam permintaan daftar, setiap istilah dalam kueri harus cocok dengan perangkat browser tertentu agar valid. Jika Anda tidak menetapkan operator (kolom) dalam kueri, penelusuran akan menemukan browser yang memiliki semua istilah yang ditentukan di seluruh kolom teks yang diindeks secara internal. Misalnya, jika kueri Anda adalah: "query=machine 73", kueri ini akan menampilkan browser yang memiliki istilah "komputer" dan "73" di semua kolom yang dapat ditampilkan dalam perangkat browser seperti berikut:

{
  "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",
}

 

Catatan 1: Pencocokan terjadi pada batas kata (tanda baca atau spasi) sehingga Anda tidak dapat melakukan pencocokan sebagian pada kata. Dalam contoh di atas, Anda tidak akan dapat melakukan query='mach 73'.

Catatan 2: Pencocokan kata tidak peka huruf besar/kecil sehingga kueri dengan "machine" akan cocok dengan "Machine" serta "machine".

 

Anda dapat menentukan kolom berikut untuk menargetkan penelusuran ke kolom tertentu (Catatan: meskipun kata kueri tidak peka huruf besar/kecil, nama kolomnya peka).

Kolom Deskripsi
machine_name Nama perangkat untuk perangkat browser Chrome.
os_platform Platform OS untuk perangkat browser Chrome. (misalnya Windows)
arch Arsitektur CPU untuk perangkat browser Chrome. (misalnya x86_64)
os_version Versi OS untuk perangkat browser Chrome. (misalnya 10.0.16299.904)
lokasi Lokasi yang dianotasi untuk perangkat browser Chrome.
pengguna Pengguna yang dianotasi untuk perangkat browser Chrome.
asset_id ID aset yang dianotasi untuk perangkat browser Chrome.
catatan Catatan yang dianotasi untuk perangkat browser Chrome.
register Waktu pendaftaran untuk perangkat browser Chrome.
os Platform gabungan OS dan versi OS utama untuk perangkat browser Chrome (mis. "Windows 10")
browser_version Browser Chrome yang dilaporkan diinstal di perangkat browser Chrome (misalnya, 73)
enrollment_token Token pendaftaran yang digunakan untuk mendaftarkan perangkat browser Chrome.
laporan Waktu laporan terakhir untuk perangkat browser Chrome
sinkronisasi Waktu sinkronisasi kebijakan terakhir untuk perangkat browser Chrome.
num_extensions Jumlah ekstensi yang dilaporkan oleh perangkat browser Chrome.
num_policies Jumlah kebijakan yang dilaporkan oleh perangkat browser Chrome.
machine_user Pengguna perangkat Chrome terakhir yang dilaporkan.
last_activity Terakhir kali perangkat browser Chrome menampilkan aktivitas (pengambilan atau pelaporan kebijakan).
has_device_id_collision ID perangkat digunakan bersama oleh beberapa perangkat yang diidentifikasi oleh Browser Chrome sebagai perangkat yang sama. Nilai yang didukung adalah true dan false.

 

Untuk kolom yang menerima waktu (pendaftaran, laporan, sinkronisasi, last_activity) format waktunya adalah YYYY-MM-DDThh:mm:ss (misalnya 2020-01-01T12:00:00). Anda juga dapat menentukan rentang terbuka atau tertutup untuk waktu:

 

Formulir

Arti

Contoh

datetime

persis pada tanggal atau waktu yang ditetapkan

2011-03-23

2011-04-26T14:23:05

datetime..datetime

dalam (termasuk) interval tanggal atau waktu yang ditetapkan

2011-03-23..2011-04-26

datetime..

pada atau setelah tanggal atau waktu yang ditetapkan

2011-04-26T14:23:05..

..datetime

pada atau sebelum tanggal atau waktu yang ditetapkan

..2011-04-26T14:23:05
 

Contoh kueri filter

 

Catatan 1: Semua contoh yang diberikan menggunakan parameter 'query' dalam permintaan. Nilai parameter harus di-escape dengan benar di URL (yaitu untuk meng-escape spasi dengan permintaan multi-kondisi).

Catatan 2: Semua kueri dapat difilter lebih lanjut untuk Unit Organisasi tertentu dengan menambahkan parameter kueri 'orgUnitPath' ke permintaan.

 

  1. Temukan semua perangkat dengan nama mesin yang berisi kata:
    1. machine_name:LIX
  2. Temukan semua perangkat dengan nama perangkat yang berisi kata yang terdaftar setelah tanggal tertentu:​
    1. machine_name:LIX register:​2011-04-26..
  3. ​Temukan semua perangkat dengan nama perangkat yang berisi kata yang terdaftar sebelum tanggal tertentu:​
    1. machine_name:LIX register:​..2011-04-26

 

Kueri yang saat ini tidak didukung:

  1. Temukan semua perangkat yang ekstensinya terinstal kurang dari jumlah tertentu (kueri rentang untuk nilai numerik tidak didukung).
  2. Temukan semua perangkat yang memiliki nama perangkat yang berisi salah satu dari dua kemungkinan kata (menggunakan OR dalam kueri).

 

Mengupdate perangkat browser Chrome 

Untuk memperbarui kolom yang dianotasi pada perangkat browser Chrome yang ditetapkan ke akun, gunakan permintaan PUT berikut dan sertakan token akses yang diperoleh dengan mengikuti bagian "Otorisasi". 

PUT
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/{deviceId}
  • customerId adalah ID unik Akun Google pelanggan.
  • Saat meniru administrator akun, Anda juga dapat menggunakan string my_customer yang mewakili customerId akun Anda. Cara lain untuk mendapatkan nilai customerId adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilai ID pengguna unik administrator Anda di parameter jalur userKey operasi.
  • deviceId adalah ID unik untuk perangkat dan ditemukan sebagai respons terhadap operasi Ambil semua perangkat browser Chrome. Untuk properti string kueri, permintaan, dan respons, lihat Referensi API.

Berikut adalah referensi untuk semua parameter payload yang dapat digunakan dalam permintaan:

Parameter Wajib Jenis Deskripsi
deviceId wajib string ID unik perangkat. deviceIds ditampilkan dalam respons dari metode browsersdevices.list. Catatan: Parameter ini wajib diisi.
annotatedUser opsional string Pengguna perangkat seperti yang dianotasi oleh administrator.
annotatedLocation opsional string

Alamat atau lokasi perangkat seperti yang dicatat oleh administrator.
annotatedNotes opsional string Catatan tentang perangkat ini seperti yang dianotasi oleh administrator
annotatedAssetId opsional string

ID aset seperti yang dianotasi oleh administrator atau ditentukan selama pendaftaran.

Contoh

Permintaan JSON

Contoh permintaan Agar mudah dibaca, contoh kode ini diberi pemisahan baris.

PUT https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value

{

  "deviceId": "device_id_value",
  "annotatedUser": "user 1"
}

Respons JSON

Permintaan yang berhasil akan menampilkan kode status HTTP 200. Bersama dengan kode status, respons akan menampilkan properti perangkat browser 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"
}

 

Menghapus perangkat browser Chrome 

Untuk menghapus perangkat browser Chrome yang ditetapkan ke akun, gunakan permintaan DELETE berikut dan sertakan token akses yang diperoleh dengan mengikuti bagian "Otorisasi". 

DELETE
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices
chromebrowsers/{deviceId}
  • customerId adalah ID unik Akun Google pelanggan.
  • Saat meniru administrator akun, Anda juga dapat menggunakan string my_customer yang mewakili customerId akun Anda. Cara lain untuk mendapatkan nilai customerId adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilai ID pengguna unik administrator Anda di parameter jalur userKey operasi.
  • deviceId adalah ID unik untuk perangkat dan ditemukan sebagai respons terhadap operasi Ambil semua perangkat Chrome. Untuk properti string kueri, permintaan, dan respons, lihat Referensi API.

Contoh

Contoh permintaan:

DELETE https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value

 

Respons JSON

Permintaan yang berhasil akan menampilkan kode status HTTP 200. 

 

Memindahkan perangkat browser Chrome antar-unit organisasi 

Untuk memindahkan perangkat browser Chrome yang ditetapkan ke akun dari satu unit organisasi ke unit organisasi lainnya, gunakan permintaan POST berikut dan sertakan token akses yang diperoleh dengan mengikuti bagian "Otorisasi". 

POST
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices/chromebrowsers/moveChromeBrowsersToOu

 

  • customerId adalah ID unik Akun Google pelanggan.
  • Saat meniru administrator akun, Anda juga dapat menggunakan string my_customer yang mewakili customerId akun Anda. Cara lain untuk mendapatkan nilai customerId adalah dengan menggunakan operasi Mengambil pengguna. Gunakan alamat email administrator atau nilai id pengguna unik administrator Anda di parameter jalur userKey operasi.

Berikut adalah referensi untuk semua parameter payload yang dapat digunakan dalam permintaan:

Parameter Jenis Deskripsi
resource_ids Daftar string

Daftar ID perangkat unik dari perangkat browser Chrome yang akan dipindahkan. Maksimum 600 browser dapat dipindahkan per permintaan.
org_unit_path string

Unit organisasi tujuan tempat perangkat akan dipindahkan. Jalur lengkap unit organisasi atau ID-nya diawali dengan "id:"

 

Contoh

Contoh permintaan

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"],
}

Respons JSON

Permintaan yang berhasil akan menampilkan kode status HTTP 200. 

Apakah ini membantu?

Bagaimana cara meningkatkannya?
true
Telusuri
Hapus penelusuran
Tutup penelusuran
Menu utama
14156203312289772339
true
Pusat Bantuan Penelusuran
true
true
true
true
true
410864
false
false