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 związanych z interfejsem API na urządzenia mobilne 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ść to admin#directory#mobiledevice.

etag

string

ETag zasobu.

resourceId

string

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

deviceId

string

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

name[]

string

Lista nazw użytkowników należących do 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żytkowniku urządzenia mobilnego znajdziesz w przewodniku dla programistów.

email[]

string

Lista adresów e-mail właściciela. Jeśli aplikacja wymaga bieżącej listy adresów e-mail użytkowników, użyj metody get. Więcej informacji znajdziesz w artykule o metodzie odzyskiwania 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 ma zastosowania na urządzeniach z Google Sync. Ta właściwość jest opcjonalna przy dodawaniu urządzenia mobilnego z Androidem. Podczas aktualizowania jednego z tych urządzeń ta usługa jest tylko do odczytu.

firstSync

string

Data i godzina pierwszej synchronizacji urządzenia z ustawieniami zasad w konsoli administracyjnej. Data i godzina są podane w formacie 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. Data i godzina są podane w formacie 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

Podaje informacje o urządzeniu, np. wersję 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 komórkowej lub operatora urządzenia mobilnego (jeśli jest dostępny) (tylko do odczytu)

defaultLanguage

string

Domyślne ustawienia regionalne używane na urządzeniu.

managedAccountIsOnOwnerProfile

boolean

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

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 zostały włączone lub wyłączone na urządzeniu (tylko do odczytu)

developerOptionsStatus

boolean

Opcje programisty włączone lub wyłączone na urządzeniu (tylko do odczytu)

otherAccountsInfo[]

string

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

adbStatus

boolean

Adb (debugowanie USB) włączony lub wyłączony 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 Androida na urządzeniu mobilnym (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 urządzenia mobilnego (tylko do odczytu)

encryptionStatus

string

Stan szyfrowania urządzenia mobilnego (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 ma zastosowania na urządzeniach z Google Sync ani iOS. Lista zawiera wszystkie aplikacje na Androida, które mają dostęp do danych Google Workspace.

Aktualizując listę aplikacji, pamiętaj, że aktualizacje zastępują istniejącą listę. Jeśli na urządzeniu z Androidem są dwie aplikacje, a interfejs API zaktualizuje listę o pięć aplikacji, pojawi 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 Androida lub uprawnienia zdefiniowane przez aplikację. Można je znaleźć w pliku manifestu Androida aplikacji. Przykładowe uprawnienia aplikacji Kalendarz to READ_CALENDAR lub MANAGE_ACCOUNTS.

Metody

action

Wykonuje czynność, która wpływa 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 dla konta.