Pobieranie wszystkich urządzeń z Chrome powiązanych z kontem
Aby zwrócić listę wszystkich urządzeń z Chrome przypisanych do konta, użyj poniższego żądania GET
i uwzględnij autoryzację opisaną w artykule Autoryzowanie żądań. Aby zwiększyć czytelność, ten przykładowy kod zawiera wiersze:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos?projection={BASIC|FULL}&query=query &orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING} &pageToken=token for next results page, if applicable &maxResults=max number of results per page
customerId
to unikalny identyfikator konta Google klienta.- Jako administrator konta możesz też użyć ciągu znaków
my_customer
, który reprezentuje wartośćcustomerId
Twojego konta. Innym sposobem na uzyskanie wartościcustomerId
jest użycie operacji Pobierz użytkownika. Użyj adresu e-mail administratora lub wartościid
unikalnego użytkownika administratora w parametrze ścieżkiuserKey
operacji.
Właściwości ciągów zapytań, żądań i odpowiedzi znajdziesz w dokumentacji interfejsu API.
Przykład: filtrowanie urządzeń według użytkownika
W tym przykładzie wyszukujemy konkretnego użytkownika przy użyciu elementuquery=user:help desk
. Odpowiedź zawiera pojedynczy zasób chromeosdevice
, gdzie annotatedUser
to help desk
:
Żądanie JSON
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos?projection=FULL&query=user:help desk&orderBy=status &sortOrder=ASCENDING&maxResults=100
Odpowiedź JSON
{ "kind": "directory#chromeosdevices", "chromeosdevices": [ { "kind": "directory#chromeosdevice", "etag": "1234567890" "deviceId": "def456", "serialNumber": "234567", "status": "ACTIVE", "lastSync": "2013-03-05T17:30:04.325Z", "supportEndDate": "2014-04-05T17:30:04.325Z", "annotatedUser": "help desk", "annotatedLocation": "Mountain View help desk Chromebook", "annotatedAssetId": "1234567890", "notes": "Loaned from support", "orderNumber": "1234", "willAutoRenew": true, "osVersion": "Browser Version 18.0", "platformVersion": "Platform Version 1415.2.0", "firmwareVersion": "Firmware Version 1.2.3.4", "bootMode": "validated", "lastEnrollmentTime": "2012-04-05T17:30:04.325Z", "orgUnitPath": "corp/engineering", "recentUsers": [ { "type": "USER_TYPE_MANAGED", "email": "user@customer.com" } ], "activeTimeRanges": [ { "date": "2012-04-05", "activeTime": "3600000" } ], } ], "nextPageToken": "abcdefghijkl123" }
Przykład: filtrowanie urządzeń według numeru seryjnego
W tym przykładzie wyszukuje się konkretny numer seryjny za pomocą parametru query=id:123456
, gdzie 123456
to numer seryjny urządzenia. Odpowiedź widoczna poniżej zawiera 1 pasującą odpowiedź, w której właściwość serialNumber
odpowiada wartości wyszukiwania.
Żądanie JSON
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos?projection=FULL&query=id:123456&orderBy=status &sortOrder=ASCENDING&maxResults=100
Odpowiedź JSON
{ "kind": "directory#chromeosdevices", "chromeosdevices": [ { "kind": "directory#chromeosdevice", "deviceId": "abc123", "serialNumber": "123456", "status": "SHIPPED", "supportEndDate": "1404457200000", "model": "model_value", "meid": "meid_value", "macAddress": "mac_address_value", "orderNumber": "1234", "willAutoRenew": true } ], "nextPageToken": "abcdefghijkl123" }
Ten przykładowy kod odpowiedzi zawiera właściwości model
, meid
i macAddress
. Jeśli urządzenie nie ma tych właściwości, nie zostaną one uwzględnione w odpowiedzi. Szczegółowe informacje znajdziesz w opisie reprezentacji zasobów Chromeosdevices.
Eksportowanie listy identyfikatorów MEID
meid
to identyfikator MEID (Mobile Equipment Identifier) karty 3G w urządzeniu z Chrome. Identyfikator MEID jest zwykle używany podczas dodawania urządzenia do abonamentu operatora sieci bezprzewodowej. Aby wyeksportować listę identyfikatorów MEID, użyj poniższego żądania GET
oraz wartości nextPageToken
w celu pobrania pełnej listy identyfikatorów MEID. Aby zwiększyć czytelność, ten przykładowy kod zawiera wiersze:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos?fields=nextPageToken,chromeosdevices(meid)
Odzyskaj urządzenie z Chrome
Aby pobrać właściwości urządzenia z Chrome, użyj poniższego żądania GET
i dołącz autoryzację opisaną w sekcji Autoryzowanie żądań. Aby zwiększyć czytelność, ten przykładowy kod zawiera wiersze:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos/deviceId?projection={FULL|BASIC}
customerId
to unikalny identyfikator konta Google klienta.- Jako administrator konta możesz też użyć ciągu znaków
my_customer
, który reprezentuje wartośćcustomerId
Twojego konta. Innym sposobem na uzyskanie wartościcustomerId
jest użycie operacji Pobierz użytkownika. Użyj adresu e-mail administratora lub wartościid
unikalnego użytkownika administratora w parametrze ścieżkiuserKey
operacji. deviceId
to unikalny identyfikator urządzenia dostępny w odpowiedzi na operację Pobierz wszystkie urządzenia z Chrome.
Właściwości ciągów zapytań, żądań i odpowiedzi znajdziesz w dokumentacji interfejsu API.
Żądanie JSON
Przykładowe żądanie. Aby można było go czytać, ten przykładowy kod zawiera zwroty wierszy:GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ chromeos/deviceId?projection=full
Odpowiedź JSON
Pomyślne żądanie zwraca kod stanu HTTP 200. Wraz z kodem stanu odpowiedź zwraca właściwości urządzenia z Chrome:
{ "kind": "directory#chromeosdevice", "deviceId": "device_id_value", "serialNumber": "device_serial_number", "status": "ACTIVE", "lastSync": "2012-04-05T17:30:04.325Z", "supportEndDate": "2014-04-05T17:30:04.325Z", "annotatedUser": "help desk", "annotatedLocation": "Mountain View help desk Chromebook", "annotatedAssetId": "12345667890", "notes": "Loaned from support", "orderNumber": "123456", "willAutoRenew": true, "osVersion": "Browser Version 18.0", "platformVersion": "Platform Version 1415.2.0", "firmwareVersion": "Firmware Version 1.2.3.4", "bootMode": "validated" "lastEnrollmentTime": "2012-04-05T17:30:04.325Z", "orgUnitPath": "corp/engineering" }
Aktualizowanie urządzenia z Chrome
Aby zaktualizować urządzenie z Chrome, użyj poniższego żądania PUT
i dołącz autoryzację opisaną w artykule Autoryzowanie żądań. Aby zwiększyć czytelność, ten przykładowy kod zawiera wiersze:
PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/ devices/chromeos/deviceId?projection={FULL|BASIC}
customerId
to unikalny identyfikator konta Google klienta.- Jako administrator konta możesz też użyć ciągu znaków
my_customer
, który reprezentuje wartośćcustomerId
Twojego konta. Innym sposobem na uzyskanie wartościcustomerId
jest użycie operacji Pobierz użytkownika. Użyj adresu e-mail administratora lub wartościid
unikalnego użytkownika administratora w parametrze ścieżkiuserKey
operacji. deviceId
to unikalny identyfikator urządzenia dostępny w odpowiedzi na operację Pobierz wszystkie urządzenia z Chrome.
Właściwości ciągów zapytań, żądań i odpowiedzi znajdziesz w dokumentacji interfejsu API.
Żądanie JSON
Podane niżej przykładowe żądanie JSON aktualizuje właściwości annotatedUser
, annotatedLocation
, annotatedAssetId
, notes
i orgUnitPath
urządzenia z Chrome. Aby zwiększyć czytelność, ten przykładowy kod zawiera wiersze:
PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/deviceId?projection=fullPrzykład treści żądania:
{
"deviceId": "device_id_value",
"annotatedUser": "help desk",
"annotatedLocation": "Mountain View help desk Chromebook",
"annotatedAssetId": "1234567890",
"notes": "Loaned from support",
"orgUnitPath": "/corp/sales"
}
W żądaniu aktualizacji uwzględnij w nim tylko właściwości ze zaktualizowanymi wartościami.
Pomyślne żądanie zwraca kod stanu HTTP 200. Wraz z kodem stanu odpowiedź zwraca właściwości zaktualizowanego urządzenia z Chrome.
Wyrejestrowywanie i wyłączanie urządzeń z Chrome
Aby wyrejestrować lub wyłączyć urządzenia z Chrome, użyj poniższego żądania POST
i dołącz autoryzację opisaną w sekcji Autoryzowanie żądań. Aby zwiększyć czytelność, ten przykładowy kod zawiera wiersze:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/ devices/chromeos:batchChangeStatus
customerId
to unikalny identyfikator konta Google klienta.- Jako administrator konta możesz też użyć ciągu znaków
my_customer
, który reprezentuje wartośćcustomerId
Twojego konta. Innym sposobem na uzyskanie wartościcustomerId
jest użycie operacji Pobierz użytkownika. Użyj adresu e-mail administratora lub wartościid
unikalnego użytkownika administratora w parametrze ścieżkiuserKey
operacji.
Właściwości żądań i odpowiedzi znajdziesz w dokumentacji interfejsu API.
Żądanie JSON
To żądanie JSON zawiera przykładowe żądanie wyrejestrowania i wyłączenia urządzeń z Chrome:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos:batchChangeStatusTreść żądania przykładowego wyrejestrowania:
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"], "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION", "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE" }Treść żądania wyłączenia:
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"], "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE", }
Pomyślne żądanie zwraca kod stanu HTTP 200.
Przenoszenie urządzeń z Chrome do jednostki organizacyjnej
Aby przenieść maksymalnie 50 urządzeń z Chrome do jednostki organizacyjnej, użyj poniższego żądania POST
i dołącz autoryzację opisaną w artykule Autoryzowanie żądań. Aby zwiększyć czytelność, ten przykładowy kod zawiera wiersze:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
customerId
to unikalny identyfikator konta Google klienta.- Jako administrator konta możesz też użyć ciągu znaków
my_customer
, który reprezentuje wartośćcustomerId
Twojego konta. Innym sposobem na uzyskanie wartościcustomerId
jest użycie operacji Pobierz użytkownika. Użyj adresu e-mail administratora lub wartościid
unikalnego użytkownika administratora w parametrze ścieżkiuserKey
operacji.
Właściwości żądań i odpowiedzi znajdziesz w dokumentacji interfejsu API.
Żądanie JSON
To żądanie JSON zawiera przykładowe żądanie przeniesienia 3 urządzeń z Chrome do jednostki organizacyjnej o nazwie /Marketing
:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing
Treść żądania przeniesienia urządzenia to:
{ "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"] }
Pomyślne żądanie zwraca kod stanu HTTP 200.