Method: chromeosdevices.list

Pobiera stronicowaną listę urządzeń z ChromeOS 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 Twojego konta. 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 początkowego 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 w sekcji Operatory zapytań chromeosdevices.list.
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 określonej jednostki organizacyjnej. Jeśli ta zasada ma wartość Prawda, należy 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 ChromeOS.
nextPageToken

string

Token używany do uzyskiwania dostępu do następnej strony tego wyniku. Aby przejść 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 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 wpisany podczas włączania urządzenia.
STATUS stan urządzenia z Chrome, Więcej informacji znajdziesz na stronie <a chromeosdevices.

Odwzorowanie

Typ projekcji, który ma być wyświetlany w przypadku urządzeń.

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

SortOrder

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

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