REST Resource: mobiledevices

Zasób: MobileDevice

Zarządzanie urządzeniami mobilnymi w Google Workspace obejmuje urządzenia z Androidem, Google Sync i iOS. Więcej informacji o popularnych zadaniach związanych z interfejsem API grup urządzeń mobilnych znajdziesz w przewodniku dla deweloperów.

Zapis JSON
{
  "kind": string,
  "etag": string,
  "resourceId": string,
  "deviceId": string,
  "name": [
    string
  ],
  "email": [
    string
  ],
  "model": string,
  "os": string,
  "type": string,
  "status": string,
  "hardwareId": string,
  "firstSync": string,
  "lastSync": string,
  "userAgent": string,
  "serialNumber": string,
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperator": string,
  "defaultLanguage": string,
  "managedAccountIsOnOwnerProfile": boolean,
  "deviceCompromisedStatus": string,
  "buildNumber": string,
  "kernelVersion": string,
  "basebandVersion": string,
  "unknownSourcesStatus": boolean,
  "developerOptionsStatus": boolean,
  "otherAccountsInfo": [
    string
  ],
  "adbStatus": boolean,
  "supportsWorkProfile": boolean,
  "manufacturer": string,
  "releaseVersion": string,
  "securityPatchLevel": string,
  "brand": string,
  "bootloaderVersion": string,
  "hardware": string,
  "encryptionStatus": string,
  "devicePasswordStatus": string,
  "privilege": string,
  "applications": [
    {
      "packageName": string,
      "displayName": string,
      "versionName": string,
      "versionCode": integer,
      "permission": [
        string
      ]
    }
  ]
}
Pola
kind

string

Typ zasobu interfejsu API. W przypadku zasobów Mobiledevices wartość wynosi admin#directory#mobiledevice.

etag

string

Tag ETag zasobu.

resourceId

string

Unikalny identyfikator, którego usługa interfejsu API używa do identyfikowania urządzenia mobilnego.

deviceId

string

Numer seryjny urządzenia mobilnego z Google Sync. W przypadku urządzeń z Androidem i iOS jest to unikalny identyfikator wygenerowany przez oprogramowanie.

name[]

string

Lista nazw użytkowników właściciela. Jeśli Twoja aplikacja potrzebuje aktualnej listy nazw właścicieli urządzeń, użyj metody get. Więcej informacji o pobieraniu informacji o użytkowniku urządzenia mobilnego znajdziesz w przewodniku dla programistów.

email[]

string

Lista adresów e-mail właściciela. Jeśli Twoja aplikacja potrzebuje bieżącej listy adresów e-mail użytkowników, użyj metody get. Więcej informacji znajdziesz w metodzie pobierania danych użytkownika.

model

string

Nazwa modelu urządzenia mobilnego, np. Nexus S. Tę usługę można zaktualizować. Więcej informacji znajdziesz w przewodniku dla programistów.

os

string

System operacyjny urządzenia mobilnego, np. iOS 4.3 lub Android 2.3.5. Tę usługę można zaktualizować. Więcej informacji znajdziesz w przewodniku dla programistów.

type

string

Typ urządzenia mobilnego.

status

string

Stan urządzenia.

hardwareId

string

Unikalny identyfikator IMEI/MEID sprzętu z Androidem. Nie dotyczy to urządzeń z Google Sync. Podczas dodawania urządzenia mobilnego z Androidem ta właściwość jest opcjonalna. Podczas aktualizowania jednego z tych urządzeń ta właściwość jest tylko do odczytu.

firstSync

string

Data i godzina początkowej synchronizacji urządzenia z ustawieniami zasad w konsoli administracyjnej. Wartość jest podana w formacie daty i godziny ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Na przykład: 2010-04-05T17:30:04+01:00.

lastSync

string

Data i godzina ostatniej synchronizacji urządzenia z ustawieniami zasad w konsoli administracyjnej. Wartość jest podana w formacie daty i godziny ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formacie <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Na przykład: 2010-04-05T17:30:04+01:00.

userAgent

string

Informacje o urządzeniu, np. wersja aplikacji os. Tę usługę można zaktualizować. Więcej informacji znajdziesz w przewodniku dla programistów.

serialNumber

string

Numer seryjny urządzenia.

imei

string

Numer IMEI urządzenia.

meid

string

Numer MEID urządzenia.

wifiMacAddress

string

Adres MAC urządzenia w sieciach Wi-Fi.

networkOperator

string

Operator sieci lub operator komórkowy urządzenia mobilnego (jeśli jest dostępny) (tylko do odczytu)

defaultLanguage

string

Domyślny język używany na urządzeniu.

managedAccountIsOnOwnerProfile

boolean

Wartość logiczna wskazująca, czy konto należy do profilu właściciela czy profilu głównego.

deviceCompromisedStatus

string

Stan zhakowanego urządzenia.

buildNumber

string

Numer kompilacji systemu operacyjnego urządzenia.

kernelVersion

string

Wersja jądra urządzenia.

basebandVersion

string

Wersja pasma podstawowego urządzenia.

unknownSourcesStatus

boolean

Nieznane źródła są włączone lub wyłączone na urządzeniu (tylko do odczytu)

developerOptionsStatus

boolean

Włączone lub wyłączone opcje programisty na urządzeniu (tylko do odczytu)

otherAccountsInfo[]

string

Lista kont dodanych na urządzeniu (tylko do odczytu)

adbStatus

boolean

Adb (debugowanie przez USB) jest włączone lub wyłączone na urządzeniu (tylko do odczytu).

supportsWorkProfile

boolean

Profil służbowy obsługiwany na urządzeniu (tylko do odczytu)

manufacturer

string

Producent urządzenia mobilnego (tylko do odczytu)

releaseVersion

string

Wersja wersji na urządzenia mobilne (tylko do odczytu)

securityPatchLevel

string (int64 format)

Stan aktualizacji zabezpieczeń urządzenia mobilnego (tylko do odczytu)

brand

string

Marka urządzenia mobilnego (tylko do odczytu)

bootloaderVersion

string

Wersja programu rozruchowego urządzenia mobilnego (tylko do odczytu)

hardware

string

Sprzęt mobilny (tylko do odczytu)

encryptionStatus

string

Stan szyfrowania urządzeń mobilnych (tylko do odczytu)

devicePasswordStatus

string

DevicePasswordStatus (tylko do odczytu)

privilege

string

DMAgentPermission (tylko do odczytu)

applications[]

object

Lista aplikacji zainstalowanych na urządzeniu mobilnym z Androidem. Nie dotyczy Google Sync ani urządzeń z iOS. Lista zawiera wszystkie aplikacje na Androida, które mają dostęp do danych Google Workspace.

Pamiętaj, że podczas aktualizowania listy aplikacji zmiany zastępują dotychczasową listę. Jeśli urządzenie z Androidem ma 2 dotychczasowe aplikacje, a interfejs API zaktualizuje listę o 5 aplikacji, będzie to zaktualizowana lista 5 aplikacji.

applications[].packageName

string

Nazwa pakietu aplikacji. Przykład: com.android.browser.

applications[].displayName

string

Wyświetlana nazwa aplikacji. Przykładem jest Browser.

applications[].versionName

string

Nazwa wersji aplikacji. Przykładem jest 3.2-140714.

applications[].versionCode

integer

Kod wersji aplikacji. Przykładem jest 13.

applications[].permission[]

string

Lista uprawnień tej aplikacji. Mogą to być standardowe uprawnienia Androida lub te zdefiniowane przez aplikację. Znajdziesz je w pliku manifestu na Androida aplikacji. Przykładowe uprawnienia aplikacji Kalendarz to READ_CALENDAR lub MANAGE_ACCOUNTS.

Metody

action

Wykonuje działanie, które wpływa na urządzenie mobilne.

delete

Usuwanie urządzenia mobilnego.

get

Pobiera właściwości urządzenia mobilnego.

list

Pobiera podzieloną na strony listę wszystkich urządzeń mobilnych należących do użytkownika na koncie.