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 typowych zadaniach grupowych związanych z interfejsem API urządzeń mobilnych znajdziesz w Przewodniku dla programistó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 urządzeń mobilnych wartość wynosi admin#directory#mobiledevice.

etag

string

Tag ETag zasobu.

resourceId

string

Unikalny identyfikator używany przez usługę interfejsu API do identyfikowania urządzenia mobilnego.

deviceId

string

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

name[]

string

Lista nazw użytkowników właściciela. Jeśli aplikacja wymaga bieżącej listy nazw właścicieli urządzeń, użyj metody get. Więcej informacji o pobieraniu informacji o użytkownikach urządzeń mobilnych znajdziesz w Przewodniku dla programistów.

email[]

string

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

model

string

nazwa modelu urządzenia mobilnego, na przykład Nexus S; Tę usługę można zaktualizować. Więcej informacji znajdziesz w Przewodniku dla programistów.

os

string

System operacyjny urządzenia mobilnego, na przykład 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 urządzeń z Google Sync. Przy dodawaniu 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 pierwszej synchronizacji urządzenia z ustawieniami zasad w konsoli administracyjnej. Wartość jest w formacie daty i godziny w standardzie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formularzu <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 w formacie daty i godziny w standardzie ISO 8601. Czas to pełna data oraz godziny, minuty i sekundy w formularzu <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 telefonu komórkowego lub operatora sieci (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 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

Włączone lub wyłączone Adb (debugowanie USB) na urządzeniu (tylko do odczytu)

supportsWorkProfile

boolean

Profil służbowy obsługiwany przez urządzenie (tylko do odczytu)

manufacturer

string

Producent urządzenia mobilnego (tylko do odczytu)

releaseVersion

string

Wersja na urządzenia mobilne – wersja do odczytu (tylko do odczytu)

securityPatchLevel

string (int64 format)

Poziom aktualizacji zabezpieczeń urządzeń mobilnych (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

Mobile Device Hardware (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.

Przy aktualizowaniu listy aplikacji należy pamiętać, że aktualizacje zastępują istniejącą listę. Jeśli na urządzeniu z Androidem są już zainstalowane 2 aplikacje, a interfejs API aktualizuje listę o 5 aplikacji, pojawia się zaktualizowana lista pięciu aplikacji.

applications[].packageName

string

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

applications[].displayName

string

Wyświetlana nazwa aplikacji. Przykład: Browser.

applications[].versionName

string

Nazwa wersji aplikacji. Przykład: 3.2-140714.

applications[].versionCode

integer

Kod wersji aplikacji. Przykład: 13.

applications[].permission[]

string

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

Metody

action

Podejmuje działanie, które ma wpływ na urządzenie mobilne.

delete

Usuwa urządzenie mobilne.

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.