REST Resource: mobiledevices

Risorsa: MobileDevice

La Gestione dispositivi mobili di Google Workspace include dispositivi Android, Google Sync e iOS. Per ulteriori informazioni sulle attività comuni delle API Group Mobile Device, 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 che il servizio API utilizza 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 richiede l'elenco corrente dei nomi dei proprietari di dispositivi, utilizza il metodo get. Per ulteriori informazioni sul recupero delle informazioni sugli utenti di dispositivi mobili, consulta la Guida per gli sviluppatori.

email[]

string

L'elenco degli indirizzi email del proprietario. Se la tua applicazione richiede l'elenco corrente degli indirizzi email degli utenti, utilizza il metodo get. Per ulteriori informazioni, consulta l'articolo sul metodo di recupero di un utente.

model

string

Il nome del modello del dispositivo mobile, ad esempio Nexus S. Questa proprietà può essere aggiornata. Per ulteriori informazioni, 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 ulteriori informazioni, 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 si aggiunge un dispositivo mobile Android, si tratta di una proprietà facoltativa. Quando si aggiorna 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 di data e ora ISO 8601. L'ora corrisponde alla 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 di data e ora ISO 8601. L'ora corrisponde alla 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.

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 codice 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 mobile del dispositivo mobile (se disponibile) (sola lettura)

defaultLanguage

string

Le impostazioni internazionali predefinite utilizzate sul dispositivo.

managedAccountIsOnOwnerProfile

boolean

Valore booleano che indica se l'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 della banda di base del dispositivo.

unknownSourcesStatus

boolean

Origini sconosciute attivate o disattivate sul dispositivo (sola lettura)

developerOptionsStatus

boolean

Opzioni sviluppatore attivate o disattivate sul dispositivo (sola lettura)

otherAccountsInfo[]

string

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 di dispositivi mobili (sola lettura)

releaseVersion

string

Versione release dispositivo mobile (sola lettura)

securityPatchLevel

string (int64 format)

Livello patch di sicurezza dispositivo mobile (sola lettura)

brand

string

Brand dispositivo mobile (sola lettura)

bootloaderVersion

string

Versione bootloader dispositivo mobile (sola lettura)

hardware

string

Hardware per dispositivi mobili (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 applicazioni installate su un dispositivo mobile Android. Non è applicabile a Google Sync e ai dispositivi iOS. L'elenco include tutte le app 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, ora sarà 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. Può essere un'autorizzazione Android standard o una definita dall'applicazione e si trova nel file manifest Android dell'applicazione. Esempi di autorizzazioni di un'applicazione Calendar sono READ_CALENDAR o MANAGE_ACCOUNTS.

Metodi

action

Esegue un'azione che ha effetto su un dispositivo mobile.

delete

Rimuove un dispositivo mobile.

get

Recupera le proprietà di un dispositivo mobile.

list

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