REST Resource: mobiledevices

Risorsa: MobileDevice

La Gestione dispositivi mobili di Google Workspace include i dispositivi Android, Google Sync e iOS. Per ulteriori informazioni sulle attività API comuni 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 da software.

name[]

string

L'elenco dei nomi utente del proprietario. Se la tua applicazione richiede l'elenco aggiornato dei nomi dei proprietari del dispositivo, utilizza il metodo get. Per saperne di più sul recupero delle informazioni relative agli utenti dei dispositivi mobili, consulta la Guida per gli sviluppatori.

email[]

string

L'elenco degli indirizzi email del proprietario. Se la tua applicazione richiede l'elenco aggiornato degli indirizzi email degli utenti, utilizza il metodo get. Per ulteriori informazioni, consulta il metodo per recuperare 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 aggiungi un dispositivo mobile Android, questa è una proprietà facoltativa. Quando aggiorni uno di questi dispositivi, questa è una proprietà di sola lettura.

firstSync

string

La data e l'ora in cui il dispositivo è stato inizialmente sincronizzato con le impostazioni dei criteri nella Console di amministrazione. Il valore è nel formato di 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.

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 è 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 cellulare 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 è associato al proprietario/profilo principale o meno.

deviceCompromisedStatus

string

Lo stato del dispositivo compromesso.

buildNumber

string

Numero di build del sistema operativo del dispositivo.

kernelVersion

string

La versione del kernel del dispositivo.

basebandVersion

string

Versione 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

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

releaseVersion

string

Versione di rilascio dispositivo mobile (sola lettura)

securityPatchLevel

string (int64 format)

Livello patch di sicurezza del dispositivo mobile (sola lettura)

brand

string

Brand dispositivo mobile (sola lettura)

bootloaderVersion

string

Versione bootloader del 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 app installate su un dispositivo mobile Android. Non è applicabile a Google Sync e ai dispositivi iOS. L'elenco include tutte le app per Android che accedono ai dati di Google Workspace.

Quando aggiorni un elenco di applicazioni, è importante notare che gli aggiornamenti sostituiscono l'elenco esistente. Se il dispositivo Android ha già due applicazioni e l'API aggiorna l'elenco con cinque applicazioni, viene visualizzato 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ò trattarsi di un'autorizzazione Android standard o di un'autorizzazione definita dall'applicazione e si trovano nel relativo file manifest Android. 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 impaginato di tutti i dispositivi mobili di proprietà dell'utente per un account.