Method: mobiledevices.list

Pobiera ponumerowane listy wszystkich urządzeń mobilnych należących do użytkownika na danym koncie. Aby pobrać listę zawierającą urządzenia należące do firmy, użyj interfejsu Devices API Cloud Identity. Ta metoda kończy się 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żyć aliasu my_customer, aby reprezentować customerId na Twoim koncie. Wartość customerId jest też zwracana w ramach zasobu Users.

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 określający następną stronę na liście
projection

enum (Projection)

Ograniczenie zwracania informacji do zbioru wybranych pól.
query

string

Ciąg wyszukiwania w formacie podanym na stronie https://developers.google.com/workspace/admin/directory/v1/search-operators
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.

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

Rodzaj zasobu.
etag

string

ETag zasobu.
mobiledevices[]

object (MobileDevice)

Lista obiektów MobileDevice.
nextPageToken

string

Token używany do uzyskiwania dostępu do następnej strony z tymi wynikami.

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 dotyczącym autoryzacji.

OrderBy

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 wygenerowany 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 Uwzględnia tylko podstawowe pola metadanych (np.deviceId, model, status, type i status).
FULL Obejmuje wszystkie pola metadanych.

SortOrder

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