Method: mobiledevices.list

Pobiera podzieloną na strony listę wszystkich urządzeń mobilnych należących do użytkownika na koncie. Aby pobrać listę zawierającą urządzenia należące do firmy, użyj interfejsu Devices API w Cloud Identity. Ta metoda powoduje przekroczenie limitu czasu po 60 minutach. Więcej informacji znajdziesz w artykule Rozwiązywanie problemów z kodami błędów.

Żądanie HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

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. Maksymalna dozwolona wartość to 100.
orderBy

enum (OrderBy)

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

string

Token do określenia następnej strony na liście
projection

enum (Projection)

Ogranicz informacje zwracane do zbioru wybranych pól.
query

string

Wyszukaj ciąg w formacie podanym na stronie https://developers.google.com/admin-sdk/directory/v1/search-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.

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,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
Pola
kind

string

To jest rodzaj tego zasobu.
etag

string

Tag ETag zasobu.
mobiledevices[]

object (MobileDevice)

Lista obiektów urządzeń mobilnych.
nextPageToken

string

Token użyty do uzyskania dostępu do następnej strony tego wyniku.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://www.googleapis.com/auth/admin.directory.device.mobile
  • https://www.googleapis.com/auth/admin.directory.device.mobile.action
  • https://www.googleapis.com/auth/admin.directory.device.mobile.readonly

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

PorządekDo

Wartości w polu enum
DEVICE_ID Numer seryjny urządzenia mobilnego z Google Sync. W przypadku urządzeń z Androidem jest to unikalny identyfikator generowany przez oprogramowanie.
EMAIL Adres e-mail właściciela urządzenia.
LAST_SYNC Data i godzina ostatniej synchronizacji ustawień zasad na urządzeniu.
MODEL Model urządzenia mobilnego.
NAME Nazwa użytkownika właściciela urządzenia.
OS System operacyjny urządzenia.
STATUS Stan urządzenia.
TYPE Typ urządzenia.

Odwzorowanie

Wartości w polu enum
BASIC Obejmuje tylko podstawowe pola metadanych (np. identyfikator urządzenia, model, stan, typ i stan)
FULL Obejmuje wszystkie pola metadanych

SortOrder

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