REST Resource: mobiledevices

Risorsa: MobileDevice

Gestione dispositivi mobili Google Workspace include i dispositivi Android, Google Sync e iOS. Per ulteriori informazioni sulle attività comuni dell'API per i dispositivi mobili di gruppo, consulta la Guida per gli sviluppatori.

Rappresentazione 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
      ]
    }
  ]
}
Campi
kind

string

Il tipo di risorsa API. Per le risorse Mobiledevices, il valore è admin#directory#mobiledevice.

etag

string

ETag della risorsa.

resourceId

string

L'ID univoco utilizzato dal servizio API per identificare il dispositivo mobile.

deviceId

string

Il numero di serie di un dispositivo mobile Google Sync. Per i dispositivi Android e iOS, si tratta di un identificatore univoco generato dal software.

name[]

string

L'elenco dei nomi utente del proprietario. Se la tua applicazione ha bisogno dell'elenco corrente dei nomi dei proprietari dei dispositivi, utilizza il metodo get. Per ulteriori informazioni sul recupero delle informazioni utente del dispositivo mobile, consulta la Guida per gli sviluppatori.

email[]

string

L'elenco degli indirizzi email del proprietario. Se la tua applicazione ha bisogno dell'elenco corrente delle email degli utenti, utilizza il metodo get. Per ulteriori informazioni, consulta il metodo Recupero di un utente.

model

string

Il nome del modello del dispositivo mobile, ad esempio Nexus S. Questa proprietà può essere aggiornata. Per scoprire di più, consulta la Guida per gli sviluppatori.

os

string

Il sistema operativo del dispositivo mobile, ad esempio iOS 4.3 o Android 2.3.5. Questa proprietà può essere aggiornata. Per scoprire di più, consulta la Guida per gli sviluppatori.

type

string

Il tipo di dispositivo mobile.

status

string

Lo stato del dispositivo.

hardwareId

string

L'identificatore univoco IMEI/MEID per l'hardware Android. Non è applicabile ai dispositivi Google Sync. Quando aggiungi un dispositivo mobile Android, questa è una proprietà facoltativa. Quando aggiorni uno di questi dispositivi, si tratta di una proprietà di sola lettura.

firstSync

string

La data e l'ora in cui il dispositivo è stato sincronizzato inizialmente con le impostazioni dei criteri nella Console di amministrazione. Il valore è nel formato data e ora ISO 8601. L'ora è la data completa più ore, minuti e secondi nel formato <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Ad esempio: 2010-04-05T17:30:04+01:00.

lastSync

string

La data e l'ora dell'ultima sincronizzazione del dispositivo con le impostazioni dei criteri nella Console di amministrazione. Il valore è nel formato data e ora ISO 8601. L'ora è la data completa più ore, minuti e secondi nel modulo <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Ad esempio: 2010-04-05T17:30:04+01:00.

userAgent

string

Fornisce informazioni sul dispositivo, ad esempio la versione di os. Questa proprietà può essere aggiornata. Per ulteriori informazioni, consulta la Guida per gli sviluppatori.

serialNumber

string

Il numero di serie del dispositivo.

imei

string

Il numero IMEI del dispositivo.

meid

string

Il numero MEID del dispositivo.

wifiMacAddress

string

L'indirizzo MAC del dispositivo sulle reti Wi-Fi.

networkOperator

string

Operatore di rete o del dispositivo mobile (se disponibile) (sola lettura)

defaultLanguage

string

Le impostazioni internazionali predefinite utilizzate sul dispositivo.

managedAccountIsOnOwnerProfile

boolean

Valore booleano che indica se questo account è nel profilo proprietario/principale o meno.

deviceCompromisedStatus

string

Lo stato del dispositivo compromesso.

buildNumber

string

Il numero di build del sistema operativo del dispositivo.

kernelVersion

string

La versione del kernel del dispositivo.

basebandVersion

string

La versione banda di base del dispositivo.

unknownSourcesStatus

boolean

Origini sconosciute attivate o disattivate sul dispositivo (sola lettura)

developerOptionsStatus

boolean

Opzioni sviluppatori attivate o disattivate sul dispositivo (sola lettura)

otherAccountsInfo[]

string

L'elenco di account aggiunti sul dispositivo (sola lettura)

adbStatus

boolean

Adb (debug USB) attivato o disattivato sul dispositivo (sola lettura)

supportsWorkProfile

boolean

Profilo di lavoro supportato sul dispositivo (sola lettura)

manufacturer

string

Produttore del dispositivo mobile (sola lettura)

releaseVersion

string

Versione release del dispositivo mobile (sola lettura)

securityPatchLevel

string (int64 format)

Livello patch di sicurezza del dispositivo mobile (sola lettura)

brand

string

Brand del dispositivo mobile (sola lettura)

bootloaderVersion

string

Versione bootloader del dispositivo mobile (sola lettura)

hardware

string

Hardware dispositivo mobile (sola lettura)

encryptionStatus

string

Stato crittografia dispositivo mobile (sola lettura)

devicePasswordStatus

string

DevicePasswordStatus (sola lettura)

privilege

string

DMAgentPermission (sola lettura)

applications[]

object

L'elenco delle app installate su un dispositivo mobile Android. Non è applicabile a Google Sync e ai dispositivi iOS. L'elenco include tutte le applicazioni per Android che accedono ai dati di Google Workspace.

Quando aggiorni un elenco di applicazioni, è importante tenere presente che gli aggiornamenti sostituiscono l'elenco esistente. Se il dispositivo Android ha due applicazioni esistenti e l'API aggiorna l'elenco con cinque applicazioni, questo è ora l'elenco aggiornato di cinque applicazioni.

applications[].packageName

string

Il nome del pacchetto dell'applicazione. Un esempio è com.android.browser.

applications[].displayName

string

Il nome visualizzato dell'applicazione. Un esempio è Browser.

applications[].versionName

string

Il nome della versione dell'applicazione. Un esempio è 3.2-140714.

applications[].versionCode

integer

Il codice di versione dell'applicazione. Un esempio è 13.

applications[].permission[]

string

L'elenco delle autorizzazioni di questa applicazione. Possono essere autorizzazioni Android standard o definite dall'applicazione e si trovano nel file manifest Android di un'applicazione. Alcuni esempi di autorizzazioni di un'applicazione Calendar sono READ_CALENDAR o MANAGE_ACCOUNTS.

Metodi

action

Esegue un'azione che interessa un dispositivo mobile.

delete

Rimuove un dispositivo mobile.

get

Recupera le proprietà di un dispositivo mobile.

list

Recupera un elenco paginato di tutti i dispositivi mobili di proprietà dell'utente per un account.