Important : Nous n'acceptons plus de nouvelles inscriptions à l'API EMM Play. En savoir plus

Cette page a été traduite par l'API Cloud Translation.

Devices

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Une ressource "Appareils" représente un appareil mobile géré par l'EMM et appartenant à un utilisateur professionnel spécifique.

{
  "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,
    "policyId": 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
}

Nom de propriété	Valeur	Description
`androidId`	`string`	ID Android des services Google Play pour l'appareil encodé sous forme de chaîne hexadécimale minuscule. Par exemple, `"123456789abcdef0"`.
`device`	`string`	Nom de code matériel interne de l'appareil. Cela vient de `android.os.Build.DEVICE`. (champ nommé "device" dans logs/wireless/android/android_checkin.proto)
`kind`	`string`
`latestBuildFingerprint`	`string`	L'empreinte de build de l'appareil, si elle est connue
`maker`	`string`	Fabricant de l'appareil. Cela vient de `android.os.Build.MANUFACTURER`.
`managementType`	`string`	Indique dans quelle mesure l'appareil est contrôlé par un fournisseur EMM Google Play d'entreprise dans différentes configurations de déploiement. Les valeurs possibles sont les suivantes: "`managedDevice`", un appareil dont l'outil de contrôle des règles relatives aux appareils (DPC) de l'EMM est le propriétaire. "`managedProfile`", un appareil dont le profil est géré par le DPC (le DPC est le propriétaire du profil) en plus d'un profil personnel distinct qui n'est pas disponible pour le DPC. "`containerApp`", n'est plus utilisé (obsolète). "`unmanagedProfile`", un appareil qui a été autorisé (par l'administrateur du domaine, à l'aide de la console d'administration pour activer le droit) à utiliser Google Play d'entreprise, mais le profil n'appartient pas à un DPC. Les valeurs possibles sont les suivantes: "`containerApp`" "`managedDevice`" "`managedProfile`" "`unmanagedProfile`"
`model`	`string`	Nom du modèle de l'appareil. Cette valeur provient de `android.os.Build.MODEL`.
`policy`	`nested object`	Règle appliquée à l'appareil.
`policy.autoUpdatePolicy`	`string`	Contrôle le moment où les mises à jour automatiques des applications sur l'appareil peuvent être appliquées. Alternative recommandée : `autoUpdateMode`, qui est défini par application, offre une plus grande flexibilité concernant la fréquence de mise à jour. Lorsque `autoUpdateMode` est défini sur `AUTO_UPDATE_POSTPONED` ou `AUTO_UPDATE_HIGH_PRIORITY`, `autoUpdatePolicy` n'a aucun effet. "choiceToTheUser" permet à l'utilisateur de l'appareil de configurer les règles de mise à jour des applications. "always" active les mises à jour automatiques. "never" désactive les mises à jour automatiques "wifiOnly" active les mises à jour automatiques uniquement lorsque l'appareil est connecté au Wi-Fi. Les valeurs possibles sont les suivantes: "`always`" "`choiceToTheUser`" "`never`" "`wifiOnly`"
`policy.deviceReportPolicy`	`string`	Indique si l'appareil signale les états des applications à l'EMM. La valeur par défaut est "deviceReportDisabled". Les valeurs possibles sont les suivantes: "`deviceReportDisabled`" "`deviceReportEnabled`"
`policy.maintenanceWindow`	`nested object`	Intervalle de maintenance définissant quand les applications exécutées au premier plan doivent être mises à jour.
`policy.maintenanceWindow.durationMs`	`long`	Durée de la période de maintenance, en millisecondes. La durée doit être comprise entre 30 minutes et 24 heures (incluses).
`policy.maintenanceWindow.startTimeAfterMidnightMs`	`long`	Heure de début de l'intervalle de maintenance, en millisecondes après minuit sur l'appareil. Les périodes peuvent s'étendre jusqu'à minuit.
`policy.policyId`	`string`	Identifiant de la règle qui sera transmis avec les commentaires sur l'installation de l'application envoyés depuis le Play Store.
`policy.productAvailabilityPolicy`	`string`	Disponibilité accordée à l'appareil pour les produits spécifiés. "tous" permet à l'appareil d'accéder à tous les produits, quel que soit leur état d'approbation. "tous" n'active pas la visibilité automatique de "alpha" ou "bêta" canaux. La "liste blanche" accorde à l'appareil l'accès aux produits spécifiés dans productPolicy[]. Seuls les produits approuvés ou précédemment approuvés (produits dont l'approbation a été révoquée) par l'entreprise peuvent être ajoutés à la liste blanche. Si aucune valeur n'est spécifiée, la disponibilité définie au niveau de l'utilisateur est appliquée par défaut. Les valeurs acceptées sont les suivantes : "`all`" "`whitelist`"
`policy.productPolicy[]`	`list`	Liste des règles relatives aux produits. La valeur `productAvailabilityPolicy` doit être définie sur `WHITELIST` ou `ALL` pour que les règles relatives aux produits soient appliquées.
`policy.productPolicy[].autoInstallPolicy`	`nested object`	Règle d'installation automatique du produit.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]`	`list`	Contraintes pour l'installation automatique de l'application. Vous pouvez spécifier une seule contrainte au maximum.
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint`	`string`	Contrainte d'état de recharge. Les valeurs possibles sont les suivantes: "`chargingNotRequired`" "`chargingRequired`"
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint`	`string`	Contrainte d'état inactif de l'appareil. Les valeurs possibles sont les suivantes: "`deviceIdleNotRequired`" "`deviceIdleRequired`"
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint`	`string`	Contrainte de type de réseau. Les valeurs possibles sont les suivantes: "`anyNetwork`" "`unmeteredNetwork`"
`policy.productPolicy[].autoInstallPolicy.autoInstallMode`	`string`	Mode d'installation automatique Si cette valeur n'est pas définie, la valeur par défaut est "doNotAutoInstall". Une application est installée automatiquement, quel que soit l'intervalle de maintenance défini. Les valeurs acceptées sont les suivantes : "`autoInstallOnce`" "`doNotAutoInstall`" "`forceAutoInstall`"
`policy.productPolicy[].autoInstallPolicy.autoInstallPriority`	`integer`	Priorité de l'installation, sous la forme d'un entier non signé. Plus le chiffre est faible, plus la priorité est élevée.
`policy.productPolicy[].autoInstallPolicy.minimumVersionCode`	`integer`	Version minimale de l'application. Si une version inférieure est installée, l'application est mise à jour automatiquement conformément aux contraintes d'installation automatique, au lieu d'attendre la mise à jour automatique régulière. Vous pouvez définir un code de version minimal pour un maximum de 20 applications par appareil.
`policy.productPolicy[].autoUpdateMode`	`string`	Mode de mise à jour automatique du produit. Lorsque `autoUpdateMode` est utilisé, il prévaut toujours sur le choix de l'utilisateur. Ainsi, lorsqu'un utilisateur modifie manuellement les paramètres de l'appareil, ces modifications sont ignorées. Les valeurs possibles sont les suivantes: "`autoUpdateDefault`" "`autoUpdateHighPriority`" "`autoUpdatePostponed`"
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]`	`list`	Configuration de l'URL d'authentification pour l'application d'authentification d'un fournisseur d'identité. Cela permet de lancer l'application d'authentification du fournisseur d'identité lors de l'authentification dans une application privée à l'aide d'Android WebView. L'application Google Authenticator doit déjà être le gestionnaire par défaut de l'URL d'authentification sur l'appareil.
`policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri`	`string`	URL d'authentification.
`policy.productPolicy[].managedConfiguration`	`nested object`	Configuration gérée du produit.
`policy.productPolicy[].managedConfiguration.configurationVariables`	`nested object`	Contient l'ID du profil de configuration géré et l'ensemble des variables de configuration (le cas échéant) définies pour l'utilisateur.
`policy.productPolicy[].managedConfiguration.configurationVariables.kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.mcmId`	`string`	ID des paramètres des configurations gérées.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[]`	`list`	Ensemble de variables attribué à l'utilisateur.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind`	`string`
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder`	`string`	Chaîne d'espace réservé, définie par l'EMM.
`policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue`	`string`	Valeur de l'espace réservé, spécifique à l'utilisateur.
`policy.productPolicy[].managedConfiguration.kind`	`string`	Obsolète.
`policy.productPolicy[].managedConfiguration.managedProperty[]`	`list`	Ensemble des propriétés gérées pour cette configuration.
`policy.productPolicy[].managedConfiguration.managedProperty[].key`	`string`	Clé unique qui identifie l'établissement.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBool`	`boolean`	Valeur booléenne : elle ne sera présente que si le type de propriété est "bool".
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle`	`nested object`	Le lot de propriétés gérées (uniquement si le type de la propriété est "lot")
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]`	`list`	Liste des propriétés gérées.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]`	`list`	Liste des groupes de propriétés. Cette valeur ne s'affiche que si le type de la propriété est "bundle_array".
`policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[]`	`list`	Liste des propriétés gérées.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger`	`integer`	Valeur entière : elle ne sera présente que si le type de la propriété est un entier.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueString`	`string`	Valeur de chaîne : elle ne sera présente que si le type de propriété est "string", "choice" ou "hidden".
`policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]`	`list`	Liste des valeurs de chaîne (cette liste ne s'affiche que si la propriété est de type multi-sélection).
`policy.productPolicy[].managedConfiguration.productId`	`string`	ID du produit concerné par la configuration gérée, par exemple "app:com.google.android.gm".
`policy.productPolicy[].productId`	`string`	Identifiant du produit. Par exemple, `"app:com.google.android.gm"`.
`policy.productPolicy[].trackIds[]`	`list`	Accorde la visibilité sur l'appareil au canal de publication de produit spécifié, identifiés par `trackIds`. Vous pouvez obtenir la liste des canaux de diffusion d'un produit en appelant Products.Get.
`policy.productPolicy[].tracks[]`	`list`	Obsolète. Utilisez `trackIds` à la place.
`product`	`string`	Nom de produit de l'appareil. Cette valeur provient de `android.os.Build.PRODUCT`.
`report`	`nested object`	Le rapport sur l'appareil a été mis à jour avec les derniers états des applications.
`report.appState[]`	`list`	Liste des états d'application définis par les applications gérées sur l'appareil. Les états d'une application sont définis par ses développeurs. Ce champ sera toujours présent.
`report.appState[].keyedAppState[]`	`list`	Liste des états d'application associés. Ce champ sera toujours présent.
`report.appState[].keyedAppState[].data`	`string`	Champ supplémentaire destiné aux données lisibles par machine. (par exemple, un nombre ou un objet JSON). Pour éviter les attaques XSS, nous vous recommandons de supprimer tout code HTML des données avant de les afficher.
`report.appState[].keyedAppState[].key`	`string`	Clé indiquant pour quoi l'application fournit un état. Le contenu de la clé est défini par le développeur de l'application. Pour éviter les attaques XSS, nous vous recommandons de supprimer tout code HTML de la clé avant de l'afficher. Ce champ sera toujours présent.
`report.appState[].keyedAppState[].message`	`string`	Message de forme libre, lisible par l'humain, décrivant l'état de l'application. Par exemple, un message d'erreur. Pour éviter les attaques XSS, nous vous recommandons de supprimer tout code HTML du message avant de l'afficher.
`report.appState[].keyedAppState[].severity`	`string`	Gravité de l'état de l'application. Ce champ est toujours présent. Les valeurs acceptées sont les suivantes : "`severityError`" "`severityInfo`"
`report.appState[].keyedAppState[].stateTimestampMillis`	`long`	Code temporel (en millisecondes) du moment où l'application a défini l'état depuis l'epoch. Ce champ sera toujours présent.
`report.appState[].packageName`	`string`	Nom de package de l'application. Ce champ sera toujours présent.
`report.lastUpdatedTimestampMillis`	`long`	Code temporel de la dernière mise à jour du rapport, en millisecondes depuis l'epoch. Ce champ sera toujours présent.
`retailBrand`	`string`	Marque de l'appareil, si définie. Consultez `android.os.Build.BRAND`
`sdkVersion`	`integer`	Version de compatibilité de l'API.

Méthodes

forceReportUpload: Importe un rapport contenant les modifications apportées aux états des applications sur l'appareil depuis le dernier rapport généré. Vous pouvez appeler cette méthode jusqu'à trois fois toutes les 24 heures pour un appareil donné.
get: Récupère les détails d'un appareil.
getState: Indique si l'accès d'un appareil aux services Google est activé ou est désactivé. L'état de l'appareil ne prend effet que si l'application des règles EMM sur les appareils Android est activée dans la console d'administration Google. Sinon, l'état de l'appareil est ignoré, et l'accès est autorisé pour tous les appareils. aux services Google. Cette fonctionnalité n'est disponible que pour les utilisateurs gérés par Google.
liste: Récupère les ID de tous les appareils d'un utilisateur.
setState: Détermine si l'accès d'un appareil aux services Google est activé ou désactivé. L'état de l'appareil ne prend effet que si vous appliquez des règles EMM sur Android est activée dans la console d'administration Google. Sinon, l'état de l'appareil est ignoré, et l'accès est autorisé pour tous les appareils. aux services Google. Cette fonctionnalité n'est disponible que pour les utilisateurs gérés par Google.
update: Met à jour la stratégie de l'appareil.

Pour vous assurer que la règle est correctement appliquée, vous devez empêcher d'accéder à Google Play en paramétrant le allowed_accounts dans la configuration gérée du service Play. Voir la restriction comptes Google Play sur Google Play.