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

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żywany z parametrem orderBy.
includeChildOrgunits

boolean

Zwraca urządzenia ze wszystkich jednostek podrzędnych, a także z określonej 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

Tag 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 na temat autoryzacji.

OrderBy

Wartości w polu enum
ANNOTATED_LOCATION Lokalizacja urządzenia z Chrome oznaczona adnotacją przez 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 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 na liście urządzeń.

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