Method: chromeosdevices.list

Pobiera ponumerowane listy urządzeń z Chrome OS na koncie.

Żądanie HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Unikalny identyfikator konta Google Workspace klienta. Jako administrator konta możesz też użyć aliasu my_customer, aby reprezentować customerId na Twoim koncie. Wartość customerId jest też zwracana w ramach zasobu Users.

Parametry zapytania

Parametry
maxResults

integer

Maksymalna liczba wyników do zwrócenia. Wartość nie powinna przekraczać 300.
orderBy

enum (OrderBy)

Właściwość urządzenia używana do sortowania wyników.
orgUnitPath

string

Pełna ścieżka jednostki organizacyjnej (bez wiodącego znaku /) lub jej unikalny identyfikator.
pageToken

string

Parametr zapytania pageToken służy do wywołania następnej strony z wynikami zapytania. Parametr zapytania pageToken następnego żądania to parametr nextPageToken z poprzedniej odpowiedzi.
projection

enum (Projection)

Określa, czy odpowiedź zawiera pełną listę właściwości czy tylko ich podzbiór.
query

string

Ciąg wyszukiwania w formacie podanym na stronie https://developers.google.com/workspace/admin/directory/v1/list-query-operators
sortOrder

enum (SortOrder)

Określa, czy wyniki mają zostać zwrócone w kolejności rosnącej czy malejącej. Musi być używany z parametrem orderBy.
includeChildOrgunits

boolean

Zwraca urządzenia ze wszystkich podrzędnych jednostek organizacyjnych oraz z wybranej jednostki organizacyjnej. Jeśli ma wartość Prawda, musisz podać wartość „orgUnitPath”.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
Pola
kind

string

Rodzaj zasobu.
etag

string

ETag zasobu.
chromeosdevices[]

object (ChromeOsDevice)

Lista obiektów urządzenia z Chrome OS.
nextPageToken

string

Token używany do uzyskiwania dostępu do następnej strony z tymi wynikami. Aby uzyskać dostęp do następnej strony, użyj wartości tego tokena w składniku pageToken tego żądania.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.

OrderBy

Wartości w polu enum
ANNOTATED_LOCATION Lokalizacja urządzenia z Chrome oznaczona adnotacją przez administratora.
ANNOTATED_USER Użytkownik Chromebooka oznaczony adnotacją przez administratora.
LAST_SYNC Data i godzina ostatniej synchronizacji urządzenia z Chrome z ustawieniami zasad w konsoli administracyjnej.
NOTES Notatki na urządzeniu z Chrome oznaczone adnotacjami przez administratora.
SERIAL_NUMBER Numer seryjny urządzenia z Chrome podany podczas włączania urządzenia.
STATUS Stan urządzenia z Chrome. Więcej informacji znajdziesz w chromeosdevices.

Odwzorowanie

Typ projekcji wyświetlanej na urządzeniach.

Wartości w polu enum
BASIC Uwzględnia tylko podstawowe pola metadanych (np.deviceId, serialNumber, status i user).
FULL Obejmuje wszystkie pola metadanych.

SortOrder

Kolejność sortowania, która powinna być zastosowana do listy urządzeń.

Wartości w polu enum
ASCENDING rosnąco;
DESCENDING w kolejności malejącej.