Method: mobiledevices.list

Pobiera podzieloną na strony listę wszystkich urządzeń mobilnych należących do użytkownika dla konta. Aby pobrać listę zawierającą urządzenia należące do firmy, użyj interfejsu Devices API w Cloud Identity. Ta metoda wygasa po 60 minutach. Więcej informacji znajdziesz w sekcji 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 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. 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)

Ogranicza informacje zwracane do zbioru wybranych pól.
query

string

Ciąg wyszukiwania w formacie podanym na 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 pewnego rodzaju zasób.
etag

string

ETag zasobu.
mobiledevices[]

object (MobileDevice)

Lista obiektów urządzeń mobilnych.
nextPageToken

string

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

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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 po autoryzacji.

OrderBy

Wartości w polu enum
DEVICE_ID Numer seryjny urządzenia mobilnego z usługą Google Sync. W przypadku urządzeń z Androidem jest to unikalny identyfikator wygenerowany przez oprogramowanie.
EMAIL Adres e-mail właściciela urządzenia.
LAST_SYNC Ostatnie ustawienia zasad synchronizują datę i godzinę 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 Zawiera tylko podstawowe pola metadanych (np. identyfikator urządzenia, model, stan, typ i stan)
FULL Zawiera wszystkie pola metadanych

SortOrder

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