Chrome Enterprise Core'u kurma

Chrome Enterprise Core API'yi kullanma

Konular

Yetkilendirme 

Tüm Chrome Enterprise Core API'lerini kullanmadan önce bu bağlantıyı takip edip API'yi etkinleştirmek istediğiniz projeyi seçerek Google Developer Console'da Admin SDK API'yi (henüz etkin değilse) etkinleştirmeniz gerekir.

Buradan, API'ye erişmek için jeton almak üzere 2 seçeneğiniz vardır:

  1. Hizmet hesabı kullanarak kimliğe bürünme ile OAuth2.0 (Aşağıdaki "Kimliğe Bürünme ile Yetkilendirme " bölümünü okuyun)
  2. Kimliğe bürünme olmadan 3 aşamalı OAuth2.0 (OAuth2 Yönergeleri'ni uygulayarak isteklerinizi yetkilendirebilirsiniz)

Chrome Enterprise Core API'ye erişiminizi yetkilendirmek için aşağıdaki kapsamlar gereklidir:

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

veya

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

Kimliğe Bürünme ile Yetkilendirme

Kimliğe bürünme amacıyla bir hizmet hesabı kullanmak için şunları yapmanız gerekir:

  1.  Hizmet hesabı oluşturun ve bu hizmet hesabının gerekli hizmet hesabı anahtarlarını edinin. Hizmet hesabı oluşturmak ve hizmet hesabı anahtarları almak için buradaki adımları uygulayabilirsiniz. 
  2. Bu hizmet hesabının istemci kimliği, yukarıda listelenen OAuth kapsamları için yetkilendirilmelidir. Bunun için Yönetici Konsolu'nda Güvenlik -> API denetimleri -> Alan genelinde yetkiyi yönet bölümüne gitmeniz gerekir. Ardından yeni bir istemci eklersiniz. Bu iletişim kutusunda istemci kimliği, hizmet hesabınızın benzersiz kimliğine karşılık gelir.

Hizmet hesabı anahtarlarıyla, hizmet hesabınız için OAuth erişim jetonu istemek üzere tercih ettiğiniz dildeki Google API istemci kitaplıklarını kullanmanız gerekir. 

 

Ayrıca OAuth jetonu istenirken alanınızdaki bir yönetici kullanıcının kimliğine bürünülmesi gerekir. 

Örnek olarak, OAuth jetonunu almak için Java API istemci kitaplıklarının kullanıldığı örnek kodları aşağıda bulabilirsiniz.

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() {}
}

Bu örnek kodu kullanarak, API'yi çağırmak için kullanabileceğiniz bir erişim jetonu alabilirsiniz. Örneğin, anahtar dosyanız /home/private_key.json içinde depolanıyorsa ve istekte bulunmak için kullanmak istediğiniz yönetici hesabı admin@domain.com ise yürütülebilir dosyayı aşağıdaki bağımsız değişkenlerle çalıştırırsınız:

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

 

Not: Kullanılan yönetici e-postası hizmet hesabınızın e-postası değildir (<proje-adı>-<kimlik>@<proje-adı>.iam.gserviceaccount.com şeklindedir).

Chrome Tarayıcı

Chrome Enterprise Core'a kayıtlı Chrome Tarayıcılar.

Kaynak Temsili

Directory API'deki Chrome Tarayıcı kaynakları için aşağıdaki JSON şablonu kullanılır:

{

"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

  ]

}

API'yi çağırma 

Hesaplar için tüm Chrome Tarayıcı cihazlarını alma 

Sınırlama: Listeleme isteği tarafından döndürülen nextPageToken öğesinin kullanım ömrü 1 saattir. Listeleme isteğinizde çok sayıda Chrome Tarayıcı cihazı varsa tüm cihazları listeleme işlemini bitirmeden önce sayfa jetonunuzun süresi dolabilir. Bu durumda, sorgu tarafından döndürülen cihaz sayısını azaltmak için listeleme isteğinize filtre uygulayabilirsiniz. Genellikle kuruluş birimine göre filtreleme yapmak, sonuç sayısını azaltmak için iyi bir yöntemdir.

 

Bir hesaba atanmış tüm Chrome Tarayıcı cihazlarının listesini döndürmek için aşağıdaki GET isteğini kullanın ve Yetkilendirme bölümünde açıklanan yetkilendirmeyi ekleyin. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir.

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, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Bir hesap yöneticisinin kimliğine büründüğünüzde, hesabınızın müşteri kimliğini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da "Kullanıcı alma" işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı kimliği değerini kullanın.

Aşağıda, istekte kullanılabilecek tüm sorgu dizesi parametreleri belirtilmiştir:

Parametre Tür Açıklama
maxResults tam sayı Döndürülecek maksimum sonuç sayısı. Varsayılan ve maksimum değer 100'dür.
orderBy dize Sonuçları sıralamak için kullanılacak Chrome Tarayıcı cihaz özelliği.
    Kabul edilen değerler şunlardır:
    "id": Chrome Tarayıcı'nın yüklü olduğu cihazın kimliği.
    "last_sync": Chrome Tarayıcı cihazının son kaydedildiği, politika ayarlarıyla son senkronize edildiği veya rapor yüklediği tarih ve saat.
    "machine_name": Cihazla ilişkili makinenin adı.
    "extension_count": Chrome Tarayıcı cihazının bildirilen toplam uzantı sayısı.
    "policy_count": Chrome Tarayıcı cihazının bildirilen toplam politika sayısı.
    "os_version": Chrome Tarayıcı'nın yüklü olduğu cihazın işletim sistemi.
    "last_signed_in_user": (Chrome Tarayıcı cihazının son giriş yapan kullanıcısı).
    "annotated_user": Yönetici tarafından belirtildiği şekilde Chrome Tarayıcı cihazı kullanıcısı.
    "annotated_location": Yönetici tarafından belirtildiği şekilde Chrome Tarayıcı cihazının konumu.
    "annotated_asset_id": Yönetici tarafından belirtildiği şekilde Chrome Tarayıcı cihazının öğe kimliği.
    "notes": Yönetici tarafından belirtildiği şekilde Chrome Tarayıcı cihazı notları.
    "browser_version_channel": Cihaz tarafından bildirilen son Chrome sürümü ve kanal.
    "org_unit": Cihazın yer aldığı kuruluş birimi.
    "enrollment_date": Cihazın kayıt tarihi.
    "save_browsing_clickthrough": Bu cihazla bildirilen Güvenli Tarama tıklama sayısı.
    "platform_major_version": OS türü ve ana sürüm (ör. Windows 10).
    "last_activity": Cihazın son etkinlik zamanı.
    "browser_version_sortable": Cihazda yüklü en eski tarayıcı sürümü.
    "os_version_sortable": OS türü ve tam sürüm.
orgUnitPath dize Kuruluş biriminin tam yolu veya benzersiz kimliği.
groupId dize Grubun groups/{group} biçiminde tam kaynak adı veya benzersiz kimliği.
pageToken dize pageToken sorgu parametresi, sorgu sonuçlarının bir sonraki sayfasını istemek için kullanılır. Takip eden isteğin pageToken sorgu parametresi, önceki yanıtınızdaki nextPageToken parametresidir.
projeksiyon dize Seçili alan grubuna döndürülen bilgileri kısıtlayın.
    Kabul edilen değerler şunlardır:
    "BASIC: Yalnızca temel meta veri alanlarını (ör. yukarıda açıklanan Yönetici Konsolu tarayıcı listesinin sütunlarında bulunanlar) içerir.
    "FULL": Tüm meta veri alanlarını içerir (yukarıda belirtildiği gibi).
sorgu dize Aşağıdaki bölümde (Sorgu Dilini Filtreleme) açıklanan liste sayfası sorgu dilini kullanarak dizeleri arayın.
sortOrder dize Sonuçların artan düzende mi yoksa azalan düzende mi döndürüleceğini belirtir. orderBy parametresi ile kullanılmalıdır.
    Kabul edilen değerler şunlardır:
    "ASCENDING": Artan düzen.
    "DESCENDING": Azalan düzen.

Örnek: Cihazları makine adına göre filtreleme

Bu ilk örnekte, query=machine_name:CLIENT2012 kullanılarak belirli bir makine adı aranır. Yanıt, machineName'i yardım masası olan tek bir Chrome Tarayıcı kaynağı içerir:

JSON isteği

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 yanıtı

Başarılı bir istek, HTTP 200 durum kodu döndürür. Sorgu parametrelerinizle eşleşen tarayıcı cihazlarının listesiyle birlikte:

{
  "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 Tarayıcı cihazlarını alma 

Chrome Tarayıcı cihazlarının özelliklerini almak için aşağıdaki GET isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirmeyi dahil edin. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir.

GET
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/deviceId?projection={FULL|BASIC}
  • customerId, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Bir hesap yöneticisinin kimliğine büründüğünüzde, hesabınızın müşteri kimliğini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da "Kullanıcı alma" işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı kimliği değerini kullanın.
  • deviceId, cihazın benzersiz tanımlayıcısıdır ve "Tüm Chrome Tarayıcı cihazlarını alma" işleminin yanıtında bulunur. Sorgu dizeleri, istek ve yanıt özellikleri için API Referansı'na bakın.

Aşağıda, istekte kullanılabilecek tüm sorgu dizesi parametreleri belirtilmiştir:

Parametre Tür Açıklama
deviceId dize Cihazın benzersiz kimliği. deviceId'ler, devicedevices.list yönteminden gelen yanıtta döndürülür. Not: Bu parametre zorunludur.
projeksiyon dize Yanıtın özelliklerin tam listesini mi yoksa yalnızca bir kısmını mı içereceğini belirler.
    Kabul edilen değerler şunlardır:
    "BASIC: Yalnızca temel meta veri alanlarını (ör. yukarıda açıklanan Yönetici Konsolu tarayıcı listesinin sütunlarında bulunanlar) içerir.
    "FULL": (üm meta veri alanlarını içerir (yukarıda belirtildiği gibi).

Örnek

JSON isteği

Bir istek örneği. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir.

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

JSON yanıtı

Başarılı bir istek, HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte Chrome Tarayıcı cihazı özelliklerini döndürür:

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

Sorgu dilini filtreleme

 

Bir liste isteğinde "query" parametresini kullandığınızda sorgudaki her terimin geçerli olabilmesi için belirli bir tarayıcıda eşleşmesi gerekir. Sorguda operatör (alan) belirtmezseniz arama, dahili olarak dizine eklenmiş tüm metin alanlarında belirtilen terimlerin tümünün yer aldığı bir tarayıcı bulur. Örneğin, sorgunuz: "query=machine 73" ise bu sorgu, aşağıdaki gibi bir tarayıcı cihazında döndürülebilen tüm alanlarda hem "machine" hem de "73" terimini içeren bir tarayıcı döndürür:

{
  "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. Not: Eşleşme, kelime sınırlarında (noktalama işaretleri veya boşluklar) gerçekleştiğinden kelimeler üzerinde kısmi eşleşmeler yapamazsınız. Yukarıdaki örnekte, query='mach 73' değerini kullanamazsınız.

2. Not: Kelime eşleştirme, büyük/küçük harfe duyarlı değildir. Dolayısıyla "machine" içeren bir sorgu hem "machine" hem de "Machine" ile eşleşir.

 

Aramanızı belirli alanlara hedeflemek için aşağıdaki alanları belirtebilirsiniz (Not: Sorgu kelimeleri büyük/küçük harfe duyarlı olmasa da alan adları büyük/küçük harfe duyarlıdır).

Alan Açıklama
machine_name Chrome Tarayıcı cihazının makine adı.
os_platform Chrome Tarayıcı cihazının OS platformu. (ör. Windows)
arch Chrome Tarayıcı cihazının CPU mimarisi. (ör. x86_64)
os_version Chrome Tarayıcı cihazının OS sürümü. (ör. 10.0.16299.904)
location Chrome Tarayıcı cihazının belirtilen konumu.
user Chrome Tarayıcı cihazı için belirtilen kullanıcı.
asset_id Chrome Tarayıcı cihazının belirtilen öğe kimliği.
note Chrome Tarayıcı cihazının belirtilen notu.
register Chrome Tarayıcı cihazının kayıt zamanı.
os Chrome Tarayıcı cihazının OS platformu ve ana OS sürümü kombinasyonu (ör. "Windows 10").
browser_version Chrome Tarayıcı cihazında yüklü olduğu bildirilen Chrome Tarayıcı (ör. 73).
enrollment_token Chrome Tarayıcı cihazını kaydetmek için kullanılan kayıt jetonu.
report Chrome Tarayıcı cihazının son rapor zamanı.
senkronizasyon Chrome Tarayıcı cihazının son politika senkronizasyon zamanı.
num_extensions Chrome Tarayıcı cihazı tarafından bildirilen uzantıların sayısı.
num_policies Chrome Tarayıcı cihazı tarafından bildirilen politika sayısı.
machine_user Chrome Tarayıcı cihazının bildirilen son kullanıcısı.
last_activity Chrome Tarayıcı cihazının en son etkinlik (politika getirme veya raporlama) gösterdiği zaman.
has_device_id_collision Cihaz kimliği, Chrome Tarayıcı'nın aynı makine olarak tanımladığı birden fazla makine tarafından paylaşılır. true ve false değerleri desteklenir.

 

Zamanı kabul eden alanlar için (kayıt, raporlama, senkronizasyon, son_activity) tarih biçimi YYYY-MM-DDThh:mm:ss  şeklindedir(ör. 2020-01-01T12:00:00) şeklindedir. Zaman için açık veya kapalı aralıklar da belirtebilirsiniz:

 

Biçim

Anlamı

Örnekler

datetime

tam olarak belirtilen tarihte veya saatte

2011-03-23

2011-04-26T14:23:05

datetime..datetime

belirtilen tarih veya saat aralığında (belirtilenler de dahil)

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

datetime..

belirtilen tarih veya saatte ya da bu tarihten veya saatten sonra

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

..datetime

belirtilen tarih veya saatte ya da bu tarihten veya saatten önce

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

Sorguları filtreleme örneği

 

1. Not: Sağlanan tüm örneklerdeki istek bölümünde "query" parametresi kullanılır. Parametre değerinin URL'de doğru şekilde kod dışına alınması (yani çok koşullu isteklere sahip alanlardan çıkış yapması) gerekir.

2. Not: Tüm sorgular, isteğe "orgUnitPath" sorgu parametresi eklenerek belirli bir kuruluş birimine göre filtrelenebilir.

 

  1. Kelime içeren makine adı olan tüm cihazları bulun:
    1. machine_name:LIX
  2. Belirli bir tarihten sonra kaydedilen kelimeleri içeren makine adı olan tüm cihazları bulun:​
    1. machine_name:LIX register:​2011-04-26..
  3. ​Belirli bir tarihten önce kaydedilen kelimeleri içeren makine adı olan tüm cihazları bulun:​
    1. machine_name:LIX register:​..2011-04-26

 

Şu anda desteklenmeyen sorgular:

  1. Belirli bir sayıdan daha az uzantı yüklü olan tüm cihazları bulun (Sayısal değerler için aralık sorguları desteklenmez).
  2. Olası bir-iki kelimeden birini içeren makine adı olan sahip tüm cihazları bulun (sorgularda OR kullanarak).

 

Chrome Tarayıcı cihazlarını güncelleme 

Bir hesaba atanmış Chrome Tarayıcı cihazlarının ek açıklamalı alanlarını güncellemek için aşağıdaki PUT isteğini kullanın ve "Yetkilendirme" bölümünü inceleyerek elde edilen erişim jetonunu ekleyin. 

PUT
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/{deviceId}
  • customerId, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Bir hesap yöneticisinin kimliğine büründüğünüzde, hesabınızın müşteri kimliğini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da "Kullanıcı alma" işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı kimliği değerini kullanın.
  • deviceId, cihazın benzersiz tanımlayıcısıdır ve "Tüm Chrome Tarayıcı cihazlarını alma" işleminin yanıtında bulunur. Sorgu dizeleri, istek ve yanıt özellikleri için API Referansı'na bakın.

Aşağıda, istekte kullanılabilecek tüm yük parametreleri belirtilmiştir:

Parametre Zorunlu Tür Açıklama
deviceId zorunlu dize Cihazın benzersiz kimliği. deviceId'ler, devicedevices.list yönteminden gelen yanıtta döndürülür. Not: Bu parametre zorunludur.
annotatedUser isteğe bağlı dize Yönetici tarafından belirtildiği şekilde cihazın kullanıcısı.
annotatedLocation isteğe bağlı dize

Yönetici tarafından belirtildiği şekilde cihazın adresi veya konumu.
annotatedNotes isteğe bağlı dize Yönetici tarafından belirtildiği şekilde bu cihazla ilgili notlar.
annotatedAssetId isteğe bağlı dize

Yönetici tarafından belirtildiği şekilde veya kayıt sırasında paylaşılan öğe tanımlayıcısı.

Örnek

JSON isteği

Bir istek örneği. Okunabilirliği artırmak açısından bu kod örneğine satır sonları eklenmiştir.

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 yanıtı

Başarılı bir istek, HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte Chrome Tarayıcı cihazı özelliklerini döndürür:

{
  "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 Tarayıcı cihazlarını silme 

Bir hesaba atanmış Chrome Tarayıcı cihazlarını silmek için aşağıdaki DELETE isteğini kullanın ve "Yetkilendirme" bölümünü inceleyerek elde edilen erişim jetonunu ekleyin. 

DELETE
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices
chromebrowsers/{deviceId}
  • customerId, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Bir hesap yöneticisinin kimliğine büründüğünüzde, hesabınızın müşteri kimliğini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da "Kullanıcı alma" işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı kimliği değerini kullanın.
  • deviceId, cihazın benzersiz tanımlayıcısıdır ve "Tüm Chrome cihazları alma" işleminin yanıtında bulunur. Sorgu dizeleri, istek ve yanıt özellikleri için API Referansı'na bakın.

Örnek

Bir istek örneği:

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

 

JSON yanıtı

Başarılı bir istekte HTTP 200 durum kodu döndürülür. 

 

Chrome Tarayıcı cihazlarını kuruluş birimleri arasında taşıma

Bir hesaba atanmış Chrome Tarayıcı cihazlarını bir kuruluş biriminden diğerine taşımak için aşağıdaki POST isteğini kullanın ve "Yetkilendirme" bölümünü inceleyerek elde edilen erişim jetonunu ekleyin. 

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

 

  • customerId, müşterinin Google hesabının benzersiz bir tanımlayıcısıdır.
  • Bir hesap yöneticisinin kimliğine büründüğünüzde, hesabınızın müşteri kimliğini temsil eden my_customer dizesini de kullanabilirsiniz. customerId değerini almanın bir diğer yolu da "Kullanıcı alma" işlemini kullanmaktır. İşlemin userKey yolu parametresinde yönetici e-posta adresinizi veya yöneticinizin benzersiz kullanıcı kimliği değerini kullanın.

Aşağıda, istekte kullanılabilecek tüm yük parametreleri belirtilmiştir:

Parametre Tür Açıklama
resource_ids Dize listesi

Taşınacak Chrome Tarayıcı cihazlarının benzersiz cihaz kimliklerinin listesi. İstek başına en fazla 600 tarayıcı taşınabilir.
org_unit_path dize

Cihazların taşınacağı hedef kuruluş birimi. Kuruluş biriminin tam yolu veya "id:" ön ekli kimliği

 

Örnek

Bir istek örneği.

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 yanıtı

Başarılı bir istekte HTTP 200 durum kodu döndürülür. 

Bu size yardımcı oldu mu?

Bunu nasıl iyileştirebiliriz?
true
Arama
Aramayı temizle
Aramayı kapat
Ana menü
17190839400173334077
true
Yardım Merkezinde Arayın
true
true
true
true
true
410864
false
false