Chrome Enterprise Core instellen

De Chrome Enterprise Core API gebruiken

Volgende: Aan de slag met Postman API-integratie voor Chrome Enterprise Core

Onderwerpen

Autorisatie

Voordat je alle Chrome Enterprise Core API's gebruikt, moet je de Admin SDK API aanzetten (als dit nog niet is gebeurd) in de Google Developer Console. Klik hiervoor op deze link en selecteer het project waarvoor je de API wilt aanzetten.

Daarna heb je 2 opties om een token te krijgen voor toegang tot de API:

Oauth2.0 met nabootsing van identiteit met een serviceaccount (lees het gedeelte Autoriseren met nabootsing van identiteit hieronder)
Driezijdige Oauth2.0 zonder nabootsing van identiteit (je kunt je verzoeken autoriseren op basis van de Oauth2-richtlijn)

De volgende bereiken zijn nodig om je toegang tot de Chrome Enterprise Core API te autoriseren:

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

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

Autoriseren met nabootsing van identiteit

Als je een serviceaccount voor nabootsing van identiteit wilt gebruiken, moet je het volgende doen:

Maak een serviceaccount en gebruik de vereiste serviceaccountsleutels voor dit serviceaccount. Volg hier hoe je een serviceaccount maakt en de serviceaccountsleutels ophaalt.
De client-ID voor dit serviceaccount moet zijn geautoriseerd voor de bovenstaande OAuth-bereiken. Hiervoor ga je naar de Beheerdersconsole onder Beveiliging -> API-functies -> Domeinbrede machtiging beheren. Vervolgens voeg je een nieuwe client toe.In dit dialoogvenster komt de client-ID overeen met de unieke ID van je serviceaccount.

Met de serviceaccountsleutels moet je de Google API-clientbibliotheken van je voorkeurstaal gebruiken om een OAuth-toegangstoken aan te vragen voor je serviceaccount.

Daarnaast moet het OAuth-tokenverzoek ook een beheerder van je domein nabootsen wanneer je de OAuth-token aanvraagt.

Dit is een voorbeeld van een code die de Java API-clientbibliotheken gebruikt om de OAuth-token op te halen.

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

Met deze voorbeeldcode kun je een toegangstoken ophalen die je kunt gebruiken om de API aan te roepen. Als het sleutelbestand bijvoorbeeld is opgeslagen in /home/private_key.json en het beheerdersaccount dat je wilt gebruiken om het verzoek in te dienen is beheerder@domein.com, moet je het volgende uitvoerbaar bestand uitvoeren met de volgende argumenten:

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

Opmerking: Het e-mailadres voor beheer dat wordt gebruikt, is niet het e-mailadres van je serviceaccount (in de vorm <projectnaam>-<id>@<projectnaam>.iam.gserviceaccount.com).

Chrome-browser

Chrome-browsers die zijn ingeschreven voor Chrome Enterprise Core.

Bronweergave

De volgende json-template wordt gebruikt voor Chrome-browserresources in de Directory API:

{

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

"deviceId": tekenreeks,

"osPlatform": tekenreeks,

"osPlatformVersion": tekenreeks,

"osArchitecture": tekenreeks,

"osVersion": tekenreeks,

"machineName": tekenreeks,

"annotatedLocation": tekenreeks,

"annotatedUser": tekenreeks,

"annotatedAssetId": tekenreeks,

"annotatedNotes": tekenreeks,

"lastPolicyFetchTime": dateTime,

"lastRegistrationTime": dateTime,

"lastActivityTime": dateTime,

"lastStatusReportTime": dateTime,

"virtualDeviceId": tekenreeks,

"serialNumber": tekenreeks,

"orgUnitPath": tekenreeks,

"extensionCount": int,

"policyCount": int,

"safeBrowsingClickThroughCount": int,

"lastDeviceUser": tekenreeks,

"browserVersions": [tekenreeks],

"lastDeviceUsers":[

"userName": tekenreeks,

"lastStatusReportTime": dateTime,

]

"machinePolicies": [

"source": tekenreeks,

"name": tekenreeks,

"value": tekenreeks,

"error": tekenreeks,

]

"browsers": [

"browserVersion": tekenreeks,

"channel": tekenreeks,

"lastStatusReportTime": dateTime,

"lastPolicyFetchTime": dateTime,

"executablePath": tekenreeks,

"installedBrowserVersion": tekenreeks,

"plugins":[

"name": tekenreeks,

"description": tekenreeks,

"fileame" tekenreeks,

]

"profiles": [

"name": tekenreeks,

"id": tekenreeks,

"lastStatusReportTime": dateTime,

"lastPolicyFectchTime": dateTime,

"safeBrowsingWarnings": int,

"safeBrowsingWarningsClickThrough": int,

"chromeSignedinUserEmail": tekenreeks,

"extensionPolicies": [

"extensionId": tekenreeks,

"extensionName": tekenreeks,

"policies": [

"source": tekenreeks,

"name": tekenreeks,

"value": tekenreeks,

"error": tekenreeks,

]

"extensions": [

"extensionId": tekenreeks,

"version": tekenreeks,

"permissions": [tekenreeks],

"name": tekenreeks,

"description":tekenreeks,

"appType": tekenreeks,

"homepageUrl": tekenreeks,

"installType": tekenreeks,

"configuredAppPolicy": tekenreeks,

"disabled": boolean,

"icons": [

"size": int,

"url": tekenreeks,

]

"userPolicies": [

"source": tekenreeks,

"name": tekenreeks,

"value": tekenreeks,

"error": tekenreeks,

]

"safeBrowsingWarningsResetTime": tekenreeks

]

}

De API aanroepen

Alle Chrome-browserapparaten voor een account ophalen

Beperking: de nextPageToken die door het vermeldingsverzoek wordt geretourneerd, heeft een levensduur van 1 uur. Als je vermeldingsverzoek een groot aantal Chrome-browserapparaten bevat, kan de paginatoken verlopen voordat je alle apparaten kunt vermelden. In dit geval kun je een filter toepassen op het vermeldingsverzoek om het aantal apparaten te verminderen dat door de zoekopdracht wordt geretourneerd. Filteren op organisatie-eenheid is meestal een goede manier om het aantal resultaten te beperken.

Als je een lijst wilt ophalen met alle Chrome-browserapparaten die aan een account zijn toegewezen, gebruik je het volgende GET-verzoek en voeg je de autorisatie toe die wordt beschreven in Autorisatie. Dit codevoorbeeld bevat regeleinden om het beter leesbaar te maken:

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}

De customerId is de unieke ID van het Google-account van de klant.
Als je de identiteit van een accountbeheerder nabootst, kun je ook de tekenreeks my_customer gebruiken. Deze vertegenwoordigt de customerId van je account. Je kunt de waarde voor customerId ook ophalen met de bewerking Retrieve a user (Een gebruiker ophalen). Gebruik je beheerdersmailadres of de unieke waarde van de gebruikers-ID van de beheerder in de padparameter userKey van de bewerking.

Hieronder vind je een overzicht van alle parameters voor de querytekenreeks die je kunt gebruiken in het verzoek:

Parameter	Type	Beschrijving
maxResults	geheel getal	Maximum aantal resultaten dat wordt geretourneerd. Standaard, de maximumwaarde is 100.
orderBy	tekenreeks	Property van het Chrome-browserapparaat die moet worden gebruikt om resultaten te sorteren.
		Geaccepteerde waarden zijn
		"id": De ID van het apparaat waarop de Chrome-browser is geïnstalleerd.
		"last_sync": De datum en tijd waarop het Chrome-browserapparaat voor het laatst is geregistreerd, voor het laatst is gesynchroniseerd met beleidsinstellingen of een rapport heeft geüpload.
		"machine_name": De naam van de machine die aan het apparaat is gekoppeld.
		"extension_count": Het totale aantal gerapporteerde extensies op het Chrome-browserapparaat.
		"policy_count": Het totale aantal gerapporteerde beleidsregels voor het Chrome-browserapparaat.
		"os_version": Het OS van het apparaat waarop de Chrome-browser is geïnstalleerd.
		"last_signed_in_user": De laatste ingelogde gebruiker van het Chrome-browserapparaat.
		"annotated_user": de gebruiker van het Chrome-browserapparaat zoals geannoteerd door de beheerder.
		"annotated_location": de apparaatlocatie van de Chrome-browser zoals geannoteerd door de beheerder.
		"annotated_asset_id": de apparaat-ID van de Chrome-browser, zoals geannoteerd door de beheerder.
		"notes": Notities over het Chrome-browserapparaat zoals geannoteerd door de beheerder.
		"browser_version_channel": De laatste Chrome-versie en het kanaal dat door het apparaat is gerapporteerd.
		"org_unit": de organisatie-eenheid waarin het apparaat zich bevindt.
		"enrollment_date": de inschrijvingsdatum van het apparaat.
		"save_browsing_clickthrough": Het aantal Safe Browsing-doorklikken dat dit apparaat heeft gemeld.
		platform_major_version: Het OS-type en de hoofdversie, bijv. (Windows 10):
		"last_activity": De laatste activiteitstijd voor het apparaat:
		"browser_version_sortable": De oudste browserversie die op het apparaat is geïnstalleerd:
		"os_version_sortable": Het OS-type en de volledige versie:
orgUnitPath	tekenreeks	Het volledige pad van de organisatie-eenheid of de unieke ID.
groupId	tekenreeks	De volledige bronnaam van de groep in de vorm `groups/{group}` of de unieke ID.
pageToken	tekenreeks	De queryparameter pageToken wordt gebruikt om de volgende pagina met zoekresultaten op te vragen. De queryparameter pageToken voor het vervolgverzoek is de nextPageToken uit de vorige reactie.
projectie	tekenreeks	Beperk de geretourneerde informatie tot een reeks geselecteerde velden.
		Geaccepteerde waarden zijn:
		"BASIC": bevat alleen de basismetadatavelden (de velden die zijn gevonden in de kolommen van de browserlijst in de Beheerdersconsole zoals hierboven vermeld).
		"FULL": bevat alle metadatavelden (zoals hierboven vermeld)
query	tekenreeks	Zoektekenreeks met behulp van de lijsttaal van de querytaal die wordt beschreven in het onderstaande gedeelte (Filter Query Language).
sortOrder	tekenreeks	Of resultaten in oplopende of aflopende volgorde moeten worden geretourneerd. Moet worden gebruikt met de parameter orderBy.
		Geaccepteerde waarden zijn:
		"ASCENDING": oplopende volgorde.
		"DESCENDING": aflopende volgorde.

Voorbeeld: apparaten filteren op machinenaam

In dit eerste voorbeeld wordt gezocht naar een specifieke machinenaam met query=machine_name:CLIENT2012. De reactie bevat één Chrome-browserresource, waarbij de machineName helpdesk is:

Json-verzoek

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-reactie

Als een verzoek is geslaagd, wordt er een HTTP 200-statuscode geretourneerd. Een lijst met browsers die overeenkomen met je queryparameters:

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

Een Chrome-browserapparaat ophalen

Als je de property's van een Chrome-browserapparaat wilt ophalen, gebruik je het volgende GET-verzoek en voeg je de autorisatie toe die wordt beschreven in Autorisatieverzoeken. Dit codevoorbeeld bevat regeleinden om het beter leesbaar te maken:

GET
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/deviceId?projection={FULL|BASIC}

De customerId is de unieke ID van het Google-account van de klant.
Als je de identiteit van een accountbeheerder nabootst, kun je ook de tekenreeks my_customer gebruiken. Deze vertegenwoordigt de customerId van je account. Je kunt de waarde voor customerId ook ophalen met de bewerking Retrieve a user (Een gebruiker ophalen). Gebruik je beheerdersmailadres of de unieke waarde van de gebruikers-ID van de beheerder in de padparameter userKey van de bewerking.
De deviceId is een unieke ID voor een apparaat en staat in de reactie van de bewerking Alle Chrome-browserapparaten ophalen. Ga naar de API-referentie voor de querytekenreeksen en verzoek- en reactieproperty's.

Hieronder vind je een overzicht van alle parameters voor de querytekenreeks die je kunt gebruiken in het verzoek:

Parameter	Type	Beschrijving
deviceId	tekenreeks	De unieke ID van het apparaat. De apparaat-ID's (deviceIds) worden geretourneerd in de reactie van de methode browsersdevices.list. Opmerking: Deze parameter is vereist.
projectie	tekenreeks	Bepaalt of de reactie de volledige lijst met property's bevat of alleen een subset.
		Geaccepteerde waarden zijn:
		"BASIC": bevat alleen de basismetadatavelden (de velden in de lijsten met browsers in de Beheerdersconsole zoals hierboven vermeld).
		"FULL": bevat alle metadatavelden (zoals hierboven vermeld).

Voorbeeld

Json-verzoek

Dit is een voorbeeldverzoek Dit codevoorbeeld bevat regeleinden om het beter leesbaar te maken:

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

JSON-reactie

Als een verzoek is geslaagd, wordt er een HTTP 200-statuscode geretourneerd. Naast de statuscode worden de apparaatproperty's van de Chrome-browser geretourneerd:

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

Filter query language

Als je de queryparameter in een lijstverzoek gebruikt, moet elke term in de query overeenkomen met een specifiek browserapparaat om geldig te zijn.Als je geen operatoren (velden) specificeert in de zoekopdracht, wordt er voor de zoekopdracht een browser gevonden met alle gespecificeerde termen in alle intern geïndexeerde tekstvelden. Als je zoekopdracht bijvoorbeeld "query=machine 73" is, wordt een browser geretourneerd die zowel de term 'machine' als '73' bevat in alle velden die op een browserapparaat zoals hieronder kunnen worden geretourneerd:

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

Opmerking 1 : Er wordt gezocht naar woordgrenzen (interpunctie of spatie), zodat je geen gedeeltelijke overeenkomsten voor woorden kunt maken. In het bovenstaande voorbeeld zou je geen query kunnen uitvoeren op ='mach 73'.

Opmerking 2: Woordovereenkomsten zijn niet-hoofdlettergevoelig, dus een zoekopdracht met 'machine' komt overeen met zowel 'Machine' als 'machine'.

Je kunt de volgende velden specificeren om de zoekopdracht te targeten op specifieke velden (Opmerking: Hoewel de zoektermen niet hoofdlettergevoelig zijn, zijn de veldnamen hoofdlettergevoelig).

Veld	Beschrijving
machine_name	De machinenaam voor het Chrome-browserapparaat.
os_platform	Het OS-platform voor het Chrome-browserapparaat. (bijv. Windows)
arch	De CPU-architectuur voor het Chrome-browserapparaat. (bijv. x86_64)
os_version	De OS-versie voor het Chrome-browserapparaat. (bijvoorbeeld 10.0.16299.904)
location	De geannoteerde locatie voor het Chrome-browserapparaat.
user	De geannoteerde gebruiker voor het Chrome-browserapparaat.
asset_id	De geannoteerde item-ID voor het Chrome-browserapparaat.
note	De geannoteerde notitie voor het Chrome-browserapparaat.
register	Het registratietijdstip voor het Chrome-browserapparaat.
os	Het gecombineerde OS-platform en de hoofd-OS-versie voor het Chrome-browserapparaat (bijv. Windows 10)
browser_version	Een gerapporteerde Chrome-browser die is geïnstalleerd op het Chrome-browserapparaat (bijv. 73)
enrollment_token	De inschrijftoken die is gebruikt om het Chrome-browserapparaat te registreren.
report	De laatste rapportagetijd voor het Chrome-browserapparaat
sync	De tijd van de laatste beleidssynchronisatie voor het Chrome-browserapparaat.
num_extensions	Het aantal extensies dat door het Chrome-browserapparaat is gemeld.
num_policies	Het aantal beleidsregels dat door het Chrome-browserapparaat is gemeld.
machine_user	De laatst gemelde gebruiker van het Chrome-browserapparaat.
last_activity	De laatste keer dat het Chrome-browserapparaat activiteit heeft getoond (beleid ophalen of rapporteren).
has_device_id_collision	De apparaat-ID wordt gedeeld door meerdere machines die de Chrome-browser als dezelfde machine herkent. Ondersteunde waarden zijn `true` en `false`.

Voor velden die tijd accepteren (register, report, sync, last_activity) is de tijdnotatie YYYY-MM-DDThh:mm:ss (bij. 2020-01-01T12:00:00). Je kunt ook open of gesloten bereiken voor de tijd specificeren:

Formulier	Betekenis	Voorbeelden
datetime	precies op de gegeven datum of tijd	2011-03-23 2011-04-26T14:23:05
datetime..datetime	binnen de gegeven datum- of tijdsinterval (inclusief de gegeven begin- en einddatum)	2011-03-23..2011-04-26
datetime..	op of na de gegeven datum of tijd	2011-04-26T14:23:05..
..datetime	op of voor de gegeven datum of tijd	..2011-04-26T14:23:05

Voorbeelden van filterquery's

Opmerking 1: Alle gegeven voorbeelden gebruiken de parameter query in het verzoek. De parameterwaarde moet correct van een escape-teken worden voorzien in de URL (dat wil zeggen, spaties moeten van een escape-teken worden voorzien met verzoeken met meerdere voorwaarden).

Opmerking 2: Alle query's kunnen verder worden gefilterd op een bepaalde organisatie-eenheid door de queryparameter orgUnitPath aan het verzoek toe te voegen.

Zoek alle apparaten met een machinenaam die een woord bevatten:
1. machine_name:LIX
Zoek alle apparaten met een machinenaam die een woord bevat dat na een bepaalde datum is geregistreerd:
1. machine_name:LIX register:2011-04-26..
Zoek alle apparaten met een machinenaam die een woord bevat dat vóór een bepaalde datum is geregistreerd:
1. machine_name:LIX-register:..2011-04-26

Niet-ondersteunde query's:

Zoek alle apparaten waarop minder dan een bepaald aantal extensies is geïnstalleerd (bereikquery's voor numerieke waarden worden niet ondersteund).
Zoek alle apparaten met een machinenaam die 1 van 2 mogelijke woorden bevat (met OR in query's).

Een Chrome-browserapparaat updaten

Als je de geannoteerde velden van een Chrome-browserapparaat wilt updaten dat aan een account is toegewezen, gebruik je het volgende PUT-verzoek en voeg je de toegangstoken toe die je krijgt door het gedeelte Autorisatie te volgen.

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

De customerId is de unieke ID van het Google-account van de klant.
Als je de identiteit van een accountbeheerder nabootst, kun je ook de tekenreeks my_customer gebruiken. Deze vertegenwoordigt de customerId van je account. Je kunt de waarde voor customerId ook ophalen met de bewerking Retrieve a user (Een gebruiker ophalen). Gebruik je beheerdersmailadres of de unieke waarde van de gebruikers-ID van de beheerder in de padparameter userKey van de bewerking.
De deviceId is een unieke ID voor een apparaat en staat in de reactie van de bewerking Alle Chrome-browserapparaten ophalen. Ga naar de API-referentie voor de querytekenreeksen en verzoek- en reactieproperty's.

Dit is een overzicht van alle payload-parameters die je kunt gebruiken in het verzoek:

Parameter	Vereist	Type	Beschrijving
deviceId	vereist	tekenreeks	De unieke ID van het apparaat. De apparaat-ID's (deviceIds) worden geretourneerd in de reactie van de methode browsersdevices.list. Opmerking: Deze parameter is vereist.
annotatedUser	optioneel	tekenreeks	Gebruiker van het apparaat zoals geannoteerd door de beheerder.
annotatedLocation	optioneel	tekenreeks	Adres of locatie van het apparaat zoals geannoteerde door de beheerder.
annotatedNotes	optioneel	tekenreeks	Notities over dit apparaat zoals geannoteerd door de beheerder
annotatedAssetId	optioneel	tekenreeks	Item-ID zoals geannoteerd door de beheerder of gespecificeerd tijdens de inschrijving.

Voorbeeld

Json-verzoek

Dit is een voorbeeldverzoek Dit codevoorbeeld bevat regeleinden om het beter leesbaar te maken:

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-reactie

Als een verzoek is geslaagd, wordt er een HTTP 200-statuscode geretourneerd. Naast de statuscode worden de apparaatproperty's van de Chrome-browser geretourneerd:

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

Een Chrome-browserapparaat verwijderen

Als je een Chrome-browserapparaat wilt verwijderen dat aan een account is toegewezen, gebruik je het volgende DELETE-verzoek en voeg je de toegangstoken toe die je krijgt door het gedeelte Autorisatie te volgen.

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

De customerId is de unieke ID van het Google-account van de klant.
Als je de identiteit van een accountbeheerder nabootst, kun je ook de tekenreeks my_customer gebruiken. Deze vertegenwoordigt de customerId van je account. Je kunt de waarde voor customerId ook ophalen met de bewerking Retrieve a user (Een gebruiker ophalen). Gebruik je beheerdersmailadres of de unieke waarde van de gebruikers-ID van de beheerder in de padparameter userKey van de bewerking.
De deviceId is een unieke ID voor een apparaat en staat in de reactie van de bewerking Alle Chrome-apparaten ophalen. Ga naar de API-referentie voor de querytekenreeksen en verzoek- en reactieproperty's.

Voorbeeld

Dit is een voorbeeldverzoek

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

JSON-reactie

Als een verzoek is geslaagd, wordt er een HTTP 200-statuscode geretourneerd.

Een Chrome-browserapparaat verplaatsen tussen organisatie-eenheden

Als je Chrome-browserapparaten die aan een account zijn toegewezen, van de ene organisatie-eenheid naar de andere wilt verplaatsen, gebruik je het volgende POST-verzoek en voeg je de toegangstoken toe die je krijgt door het gedeelte Autorisatie te volgen.

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

De customerId is de unieke ID van het Google-account van de klant.
Als je de identiteit van een accountbeheerder nabootst, kun je ook de tekenreeks my_customer gebruiken. Deze vertegenwoordigt de customerId van je account. Je kunt de waarde voor customerId ook ophalen met de bewerking Retrieve a user (Een gebruiker ophalen). Gebruik je beheerdersmailadres of de unieke waarde van de gebruikers-ID van de beheerder in de padparameter userKey van de bewerking.

Hier zie je een overzicht van alle payload-parameters die je kunt gebruiken in het verzoek:

Parameter	Type	Beschrijving
resource_ids	Lijst met tekenreeksen	Lijst met unieke apparaat-ID's van Chrome-browserapparaten die moeten worden verplaatst. Je kunt maximaal 600 browsers per verzoek verplaatsen.
org_unit_path	tekenreeks	Bestemmingsorganisatie-eenheid waarnaar je apparaten wilt verplaatsen. Het volledige pad van de organisatie-eenheid of de ID met het voorvoegsel 'id:'

Voorbeeld

Dit is een voorbeeldverzoek

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-reactie

Als een verzoek is geslaagd, wordt er een HTTP 200-statuscode geretourneerd.

Was dit nuttig?

Hoe kunnen we dit verbeteren?