Importante:non accettiamo più nuove registrazioni per l'API Play EMM. Scopri di più.

Questa pagina è stata tradotta dall'API Cloud Translation.

Devices

Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.

Rappresentazioni delle risorse

Una risorsa Dispositivi rappresenta un dispositivo mobile gestito da EMM e appartenente a un utente aziendale specifico.

{
  "kind": "androidenterprise#device",
  "androidId": string,
  "managementType": string,
  "policy": {
    "autoUpdatePolicy": string,
    "productAvailabilityPolicy": string,
    "productPolicy": [
      {
        "productId": string,
        "tracks": [
          string
        ],
        "trackIds": [
          string
        ],
        "managedConfiguration": {
          "kind": string,
          "productId": string,
          "managedProperty": [
            {
              "key": string,
              "valueBool": boolean,
              "valueInteger": integer,
              "valueString": string,
              "valueStringArray": [
                string
              ],
              "valueBundle": {
                "managedProperty": [
                  (ManagedProperty)
                ]
              },
              "valueBundleArray": [
                {
                  "managedProperty": [
                    (ManagedProperty)
                  ]
                }
              ]
            }
          ],
          "configurationVariables": {
            "kind": "androidenterprise#configurationVariables",
            "mcmId": string,
            "variableSet": [
              {
                "kind": "androidenterprise#variableSet",
                "placeholder": string,
                "userValue": string
              }
            ]
          }
        },
        "autoInstallPolicy": {
          "autoInstallMode": string,
          "autoInstallPriority": integer,
          "autoInstallConstraint": [
            {
              "networkTypeConstraint": string,
              "chargingStateConstraint": string,
              "deviceIdleStateConstraint": string
            }
          ],
          "minimumVersionCode": integer
        },
        "autoUpdateMode": string,
        "enterpriseAuthenticationAppLinkConfigs": [
          {
            "uri": string
          }
        ]
      }
    ],
    "maintenanceWindow": {
      "startTimeAfterMidnightMs": long,
      "durationMs": long
    },
    "deviceReportPolicy": string
  },
  "report": {
    "lastUpdatedTimestampMillis": long,
    "appState": [
      {
        "packageName": string,
        "keyedAppState": [
          {
            "key": string,
            "stateTimestampMillis": long,
            "severity": string,
            "message": string,
            "data": string
          }
        ]
      }
    ]
  },
  "latestBuildFingerprint": string,
  "sdkVersion": integer,
  "maker": string,
  "model": string,
  "device": string,
  "product": string,
  "retailBrand": string
}

Nome proprietà	Valore	Descrizione
`androidId`	`string`	L'ID Android di Google Play Services per il dispositivo codificato come una stringa esadecimale minuscola. Ad esempio, `"123456789abcdef0"`.
`device`	`string`	Il nome in codice hardware interno del dispositivo. Proviene da `android.os.Build.DEVICE`. (campo denominato "device" per logs/wireless/android/android_checkin.proto)
`kind`	`string`
`latestBuildFingerprint`	`string`	L'impronta digitale della build del dispositivo, se nota.
`maker`	`string`	Il produttore del dispositivo. Proviene da `android.os.Build.MANUFACTURER`.
`managementType`	`string`	Identifica la misura in cui il dispositivo è controllato da un provider EMM della versione gestita di Google Play in varie configurazioni di deployment. I valori possibili sono: "`managedDevice`", un dispositivo che ha come proprietario il controller dei criteri dei dispositivi (DPC) dell'EMM. "`managedProfile`", un dispositivo che ha un profilo gestito dal DPC (il DPC è il proprietario del profilo), oltre a un profilo personale separato che non è disponibile per il DPC. "`containerApp`", non più utilizzata (deprecata). "`unmanagedProfile`", un dispositivo a cui è stato autorizzato (dall'amministratore del dominio utilizzando la Console di amministrazione per attivare il privilegio) a utilizzare la versione gestita di Google Play, ma il profilo in sé non è di proprietà di un DPC (controller criteri dispositivi). di Gemini Advanced. I valori accettati sono: "`containerApp`" "`managedDevice`" "`managedProfile`" "`unmanagedProfile`"
`model`	`string`	Il nome del modello del dispositivo. Proviene da `android.os.Build.MODEL`.
`policy`	`nested object`	Il criterio è stato applicato in modo forzato al dispositivo.
`policy.autoUpdatePolicy`	`string`	Consente di stabilire quando è possibile applicare gli aggiornamenti automatici delle app sul dispositivo. Alternativa consigliata: `autoUpdateMode`, impostata in base all'app, offre una maggiore flessibilità per quanto riguarda la frequenza di aggiornamento. Se `autoUpdateMode` è impostato su `AUTO_UPDATE_POSTPONED` o `AUTO_UPDATE_HIGH_PRIORITY`, `autoUpdatePolicy` non ha alcun effetto. "choiceToTheUser" consente all'utente del dispositivo di configurare il criterio di aggiornamento dell'app. "sempre" attiva gli aggiornamenti automatici. "mai" disabilita gli aggiornamenti automatici. "solo wifi" attiva gli aggiornamenti automatici solo quando il dispositivo è connesso al Wi-Fi. I valori accettati sono: "`always`" "`choiceToTheUser`" "`never`" "`wifiOnly`"
`policy.deviceReportPolicy`	`string`	Se il dispositivo segnala gli stati dell'app all'EMM. Il valore predefinito è "deviceReportDisabled". I valori accettati sono: "`deviceReportDisabled`" "`deviceReportEnabled`"
`policy.maintenanceWindow`	`nested object`	Il periodo di manutenzione che definisce il momento in cui le app in esecuzione in primo piano devono essere aggiornate.
`policy.maintenanceWindow.durationMs`	`long`	Durata del periodo di manutenzione, in millisecondi. La durata deve essere compresa tra 30 minuti e 24 ore (incluse).
`policy.maintenanceWindow.startTimeAfterMidnightMs`	`long`	Ora di inizio del periodo di manutenzione, in millisecondi dopo la mezzanotte sul dispositivo. Le finestre possono durare fino a mezzanotte.
`policy.productAvailabilityPolicy`	`string`	La disponibilità concessa al dispositivo per i prodotti specificati. "tutti" consente al dispositivo di accedere a tutti i prodotti, indipendentemente dallo stato di approvazione. "tutti" non attiva la visibilità automatica di "alpha" o "beta" le tracce audio. "autorizza" concede al dispositivo l'accesso ai prodotti specificati in productPolicy[]. Solo i prodotti approvati o quelli precedentemente approvati (prodotti con approvazione revocata) dall'azienda possono essere autorizzati. Se non viene fornito alcun valore, per impostazione predefinita viene applicata la disponibilità impostata a livello di utente. I valori accettati sono: "`all`" "`whitelist`"
`policy.productPolicy[]`	`list`	L'elenco delle norme del prodotto. Per applicare le norme del prodotto, `productAvailabilityPolicy` deve essere impostato su `WHITELIST` o `ALL`.
`policy.productPolicy[].autoInstallPolicy`	`nested object`	Il criterio di installazione automatica per il prodotto.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]`	`list`	I vincoli per l'installazione automatica dell'app. Puoi specificare un massimo di un vincolo.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint`	`string`	Vincolo dello stato di ricarica. I valori accettati sono: "`chargingNotRequired`" "`chargingRequired`"
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint`	`string`	Vincolo di stato di inattività del dispositivo. I valori accettati sono: "`deviceIdleNotRequired`" "`deviceIdleRequired`"
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint`	`string`	Vincolo del tipo di rete. I valori accettati sono: "`anyNetwork`" "`unmeteredNetwork`"
`policy.productPolicy[].autoInstallPolicy.autoInstallMode`	`string`	La modalità di installazione automatica. Se non viene configurato, il valore predefinito è "doNotAutoInstall". Un'app viene installata automaticamente indipendentemente dal periodo di manutenzione impostato. I valori accettati sono: "`autoInstallOnce`" "`doNotAutoInstall`" "`forceAutoInstall`"
`policy.productPolicy[].autoInstallPolicy.autoInstallPriority`	`integer`	La priorità dell'installazione, sotto forma di numero intero senza segno. Un numero più basso indica una priorità più alta.
`policy.productPolicy[].autoInstallPolicy.minimumVersionCode`	`integer`	La versione minima dell'app. Se è installata una versione precedente dell'app, questa verrà aggiornata automaticamente in base ai vincoli di installazione automatica, senza dover attendere il normale aggiornamento automatico. Puoi impostare un codice di versione minima per un massimo di 20 app per dispositivo.
`policy.productPolicy[].autoUpdateMode`	`string`	La modalità di aggiornamento automatico del prodotto. Quando viene utilizzato, `autoUpdateMode` ha sempre la precedenza su quella scelta dall'utente. Di conseguenza, quando un utente modifica manualmente le impostazioni del dispositivo, queste modifiche vengono ignorate. I valori accettati sono: "`autoUpdateDefault`" "`autoUpdateHighPriority`" "`autoUpdatePostponed`"
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]`	`list`	Una configurazione dell'URL di autenticazione per l'app di autenticazione di un provider di identità. In questo modo è possibile avviare l'app di autenticazione del provider di identità durante l'autenticazione che viene eseguita in un'app privata utilizzando Android WebView. L'app Authenticator dovrebbe già essere il gestore predefinito dell'URL di autenticazione sul dispositivo.
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri`	`string`	Un URL di autenticazione.
`policy.productPolicy[].managedConfiguration`	`nested object`	La configurazione gestita per il prodotto.
`policy.productPolicy[].managedConfiguration.configurationVariables`	`nested object`	Contiene l'ID del profilo di configurazione gestita e l'insieme di variabili di configurazione (se presenti) definite per l'utente.
`policy.productPolicy[].managedConfiguration.configurationVariables.kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.mcmId`	`string`	L'ID delle impostazioni di configurazione gestite.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[]`	`list`	L'insieme di variabili attribuito all'utente.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder`	`string`	La stringa segnaposto; definita dall'EMM.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue`	`string`	Il valore del segnaposto, specifico per l'utente.
`policy.productPolicy[].managedConfiguration.kind`	`string`	Obsoleta.
`policy.productPolicy[].managedConfiguration.managedProperty[]`	`list`	L'insieme di proprietà gestite per questa configurazione.
`policy.productPolicy[].managedConfiguration.managedProperty[].key`	`string`	La chiave univoca che identifica la proprietà.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBool`	`boolean`	Il valore booleano, presente solo se il tipo di proprietà è bool.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle`	`nested object`	Il gruppo di proprietà gestite: sarà presente solo se il tipo di proprietà è un gruppo.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]`	`list`	L'elenco delle proprietà gestite.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]`	`list`	L'elenco dei bundle di proprietà. Sarà presente solo se il tipo di proprietà è bundle_array.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[]`	`list`	L'elenco delle proprietà gestite.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger`	`integer`	Il valore intero, presente solo se il tipo della proprietà è un numero intero.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueString`	`string`	Il valore della stringa. Sarà presente solo se il tipo di proprietà è di tipo stringa, scelta o nascosto.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]`	`list`	L'elenco di valori di stringa: sarà presente solo se il tipo di proprietà è a selezione multipla.
`policy.productPolicy[].managedConfiguration.productId`	`string`	L'ID del prodotto a cui è destinata la configurazione gestita, ad esempio "app:com.google.android.gm".
`policy.productPolicy[].productId`	`string`	L'ID del prodotto. Ad esempio, `"app:com.google.android.gm"`.
`policy.productPolicy[].trackIds[]`	`list`	Concede la visibilità del dispositivo ai canali di rilascio del prodotto specificati, identificati da `trackIds`. L'elenco dei canali di rilascio di un prodotto può essere ottenuto chiamando Products.Get.
`policy.productPolicy[].tracks[]`	`list`	Deprecato. Usa invece il criterio `trackIds`.
`product`	`string`	Il nome del prodotto del dispositivo. Proviene da `android.os.Build.PRODUCT`.
`report`	`nested object`	Il report sui dispositivi è stato aggiornato con gli ultimi stati dell'app.
`report.appState[]`	`list`	Elenco di stati delle app impostati dalle app gestite sul dispositivo. Gli stati delle app vengono definiti dagli sviluppatori delle app. Questo campo sarà sempre presente.
`report.appState[].keyedAppState[]`	`list`	Elenco di stati dell'app con chiave. Questo campo sarà sempre presente.
`report.appState[].keyedAppState[].data`	`string`	Campo aggiuntivo destinato a dati leggibili dalle macchine. Ad esempio, un numero o un oggetto JSON. Per evitare l'XSS, consigliamo di rimuovere l'eventuale codice HTML dai dati prima di visualizzarli.
`report.appState[].keyedAppState[].key`	`string`	Chiave che indica lo stato dell'app. I contenuti della chiave vengono impostati dallo sviluppatore dell'app. Per evitare l'XSS, consigliamo di rimuovere l'eventuale codice HTML dalla chiave prima di visualizzarla. Questo campo sarà sempre presente.
`report.appState[].keyedAppState[].message`	`string`	Messaggio in formato libero leggibile da una persona che descrive lo stato dell'app. Ad esempio, un messaggio di errore. Per evitare l'XSS, consigliamo di rimuovere l'eventuale codice HTML dal messaggio prima di visualizzarlo.
`report.appState[].keyedAppState[].severity`	`string`	Gravità dello stato dell'app. Questo campo sarà sempre presente. I valori accettati sono: "`severityError`" "`severityInfo`"
`report.appState[].keyedAppState[].stateTimestampMillis`	`long`	Timestamp del momento in cui l'app ha impostato lo stato in millisecondi dall'epoca. Questo campo sarà sempre presente.
`report.appState[].packageName`	`string`	Il nome del pacchetto dell'app. Questo campo sarà sempre presente.
`report.lastUpdatedTimestampMillis`	`long`	Timestamp dell'ultimo aggiornamento del report in millisecondi dall'epoca. Questo campo sarà sempre presente.
`retailBrand`	`string`	Brand di vendita al dettaglio del dispositivo, se impostato. Vedi `android.os.Build.BRAND`
`sdkVersion`	`integer`	Versione di compatibilità dell'API.

Metodi

forceReportUpload: Carica un report contenente eventuali modifiche agli stati dell'app sul dispositivo da quando è stato generato l'ultimo report. Puoi chiamare questo metodo fino a 3 volte ogni 24 ore per un determinato dispositivo.
trova: Recupera i dettagli di un dispositivo.
getState: Recupera se l'accesso di un dispositivo ai servizi Google è attivo o disattivata. Lo stato del dispositivo ha effetto solo se vengono applicati i criteri EMM su Android nella Console di amministrazione Google. In caso contrario, lo stato del dispositivo viene ignorato e l'accesso è consentito a tutti i dispositivi ai servizi Google. Questo attributo è supportato solo per gli utenti gestiti da Google.
list: Recupera gli ID di tutti i dispositivi di un utente.
setState: Consente di attivare o disattivare l'accesso di un dispositivo ai servizi Google. Lo stato del dispositivo ha effetto solo se vengono applicati i criteri EMM su Android nella Console di amministrazione Google. In caso contrario, lo stato del dispositivo viene ignorato e l'accesso è consentito a tutti i dispositivi ai servizi Google. Questo attributo è supportato solo per gli utenti gestiti da Google.
aggiorna: Aggiorna i criteri relativi ai dispositivi.

Per assicurarti che il criterio venga applicato correttamente, devi evitare di accedere a Google Play impostando il allowed_accounts nella configurazione gestita per Google pacchetto Google Play. Vedi le limitazioni in Google Play.