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 zasada ma wartość Prawda, „orgUnitPath” należy podać wartość.

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.

PorządekDo

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 chromeosdevices.

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.