Method: chromeosdevices.list

Pobiera podzieloną na strony listę urządzeń z ChromeOS w obrębie konta.

Żą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żywać aliasu my_customer do reprezentowania domeny customerId na Twoim koncie. Zasób customerId jest też zwracany w ramach zasobu Użytkownicy.

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 początkowej /) lub jej unikalny identyfikator.
pageToken

string

Parametr zapytania pageToken służy do żądania wyświetlenia następnej strony wyników 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 podzbiór.
query

string

Wyszukaj ciąg w formacie podanym na stronie https://developers.google.com/admin-sdk/directory/v1/list-query-operators
sortOrder

enum (SortOrder)

Określa, czy wyniki mają być zwracane w kolejności rosnącej czy malejącej. Musi być używana z parametrem orderBy.
includeChildOrgunits

boolean

Zwróć urządzenia ze wszystkich podrzędnych jednostek organizacyjnych, a także z określonej jednostki organizacyjnej. Jeśli ma wartość Prawda, musisz podać „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

To jest rodzaj tego zasobu.
etag

string

Tag ETag zasobu.
chromeosdevices[]

object (ChromeOsDevice)

Lista obiektów na urządzeniu z Chrome OS.
nextPageToken

string

Token użyty do uzyskania dostępu do następnej strony tego wyniku. Aby uzyskać dostęp do następnej strony, użyj wartości tego tokena w ciągu zapytania pageToken tego żądania.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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 na temat autoryzacji.

OrderBy

Wartości w polu enum
ANNOTATED_LOCATION Lokalizacja urządzenia z Chrome zgodnie z adnotacją administratora.
ANNOTATED_USER Użytkownik Chromebooka z adnotacją od administratora.
LAST_SYNC Data i godzina ostatniej synchronizacji urządzenia z Chrome z ustawieniami zasad w konsoli administracyjnej.
NOTES Notatki dotyczące urządzenia z Chrome opisane przez administratora.
SERIAL_NUMBER Numer seryjny urządzenia z Chrome wpisany podczas włączania urządzenia.
STATUS Stan urządzenia z Chrome. Więcej informacji znajdziesz na <a urządzenia ChromeOS.

Odwzorowanie

Typ projekcji wyświetlanych na urządzeniach.

Wartości w polu enum
BASIC Obejmuje tylko podstawowe pola metadanych (np. deviceId, serialNumber, status i użytkownik)
FULL Obejmuje wszystkie pola metadanych

SortOrder

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

Wartości w polu enum
ASCENDING Porządek rosnący.
DESCENDING Porządek malejący.