Method: chromeosdevices.list

Pobiera podzieloną na strony listę 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żywać aliasu my_customer do reprezentowania grupy customerId swojego konta. Wartość customerId jest też zwracana w ramach zasobu Użytkownicy.

Parametry zapytania

Parametry
maxResults

integer

Maksymalna liczba wyników do zwrócenia.

orderBy

enum (OrderBy)

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

orgUnitPath

string

Pełna ścieżka jednostki organizacyjnej (bez początkowego /) lub jej unikalny identyfikator.

pageToken

string

Parametr zapytania pageToken służy do wywołania następnej strony wyników zapytania. Parametr zapytania pageToken żądania następnego to wartość nextPageToken z poprzedniej odpowiedzi.

projection

enum (Projection)

Ogranicza informacje zwracane do zbioru wybranych pól.

query

string

Ciąg wyszukiwania 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 i określonych jednostek organizacyjnych. Jeśli ma wartość Prawda, należy podać parametr „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 pewnego rodzaju zasób.

etag

string

ETag zasobu.

chromeosdevices[]

object (ChromeOsDevice)

Lista obiektów urządzeń z Chrome OS.

nextPageToken

string

Token używany 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 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 po autoryzacji.

OrderBy

Wartości w polu enum
ANNOTATED_LOCATION Lokalizacja urządzenia z Chrome oznaczona przez administratora.
ANNOTATED_USER Użytkownik Chromebooka z adnotacją 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 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 tutaj: <a chromeosdevices.

Odwzorowanie

Typ projekcji wyświetlany dla urządzeń.

Wartości w polu enum
BASIC Obejmuje tylko podstawowe pola metadanych (np. identyfikator urządzenia, numer seryjny, stan i użytkownik)
FULL Zawiera wszystkie pola metadanych

SortOrder

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

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