Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La liste des méthodes associées à cette ressource est présentée au bas de la page.
Représentations de la ressource
La présence d'une ressource Entitlements indique qu'un utilisateur a le droit d'utiliser une application spécifique. Les droits d'accès sont spécifiques à un utilisateur et non à un appareil. Ainsi, un utilisateur autorisé à accéder à une application peut l'installer sur tous ses appareils. Un utilisateur peut également détenir un droit d'accès à une application sans l'installer sur un appareil.
L'API peut être utilisée pour créer un droit d'accès. Si vous le souhaitez, vous pouvez également utiliser l'API pour déclencher l'installation d'une application sur tous les appareils gérés d'un utilisateur en même temps que le droit d'accès est créé.
Si l'application est sans frais, la création du droit d'accès crée également une licence de groupe pour cette application. Pour les applications payantes, la création du droit d'accès nécessite une licence, qui reste utilisée jusqu'à ce que le droit d'accès soit supprimé. Si l'entreprise n'a pas acheté suffisamment de licences, aucun droit d'accès n'est créé et l'installation échoue. De plus, aucun droit d'accès n'est créé pour une application si celle-ci nécessite des autorisations que l'entreprise n'a pas acceptées.
Si un droit d'accès est supprimé, l'application peut être désinstallée de l'appareil d'un utilisateur. Nous vous recommandons de désinstaller l'application en appelant Installs.delete() avant de supprimer le droit d'accès.
Les droits d'accès associés aux applications qu'un utilisateur paie sur un profil non géré sont associés au motif de droit d'accès "userPurchase". Ces droits d'accès ne peuvent pas être supprimés via l'API.
ID du produit concerné par le droit d'accès. Par exemple, "app:com.google.android.gm".
reason
string
Motif du droit d'accès. Par exemple, "free" pour les applications sans frais. Cette propriété est temporaire: elle sera remplacée par le champ acquisition kind des licences de groupe.
Ajoute ou met à jour un droit d'accès à une application pour un utilisateur.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eEntitlements allow users to install and use specific apps on their managed devices, and they are user-specific, not device-specific.\u003c/p\u003e\n"],["\u003cp\u003eCreating an entitlement for a free app also generates a group license, while creating one for a paid app consumes one license from the enterprise's purchased licenses.\u003c/p\u003e\n"],["\u003cp\u003eThe API can be used to manage entitlements, including creating, retrieving details, listing, updating, and deleting them, but this method is deprecated and will be inaccessible after September 30, 2025.\u003c/p\u003e\n"],["\u003cp\u003eEntitlements for apps purchased by users on unmanaged profiles are designated as "userPurchase" and cannot be removed through the API.\u003c/p\u003e\n"],["\u003cp\u003eBefore deleting an entitlement, it is recommended to uninstall the corresponding app using Installs.delete() to ensure a clean removal.\u003c/p\u003e\n"]]],[],null,["# Entitlements\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n| **Deprecated:** New integrations cannot use this method and can refer to our [new recommendations](/android/work/deprecations#recommended_alternative_2). \n| **This method will no longer be accessible by anyone after September 30, 2025.**\nThe presence of an Entitlements resource indicates that a user has the right to use a particular app. Entitlements are user specific, not device specific. This allows a user with an entitlement to an app to install the app on all their devices. It's also possible for a user to hold an entitlement to an app without installing the app on any device. \n\nThe API can be used to create an entitlement. As an option, you can also use the API to trigger the installation of an app on all a user's managed devices at the same time the entitlement is created. \n\nIf the app is free, creating the entitlement also creates a group license for that app. For paid apps, creating the entitlement consumes one license, and that license remains consumed until the entitlement is removed. If the enterprise hasn't purchased enough licenses, then no entitlement is created and the installation fails. An entitlement is also not created for an app if the app requires permissions that the enterprise hasn't accepted. \n\nIf an entitlement is deleted, the app may be uninstalled from a user's device. As a best practice, uninstall the app by calling [Installs.delete()](/android/work/play/emm-api/v1/installs/delete) before deleting the entitlement. \n\nEntitlements for apps that a user pays for on an unmanaged profile have `\"userPurchase\"` as the entitlement reason. These entitlements cannot be removed via the API.\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"androidenterprise#entitlement\",\n \"productId\": string,\n \"reason\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `kind` | `string` | | |\n| `productId` | `string` | The ID of the product that the entitlement is for. For example, `\"app:com.google.android.gm\"`. | |\n| `reason` | `string` | The reason for the entitlement. For example, `\"free\"` for free apps. This property is temporary: it will be replaced by the `acquisition kind` field of group licenses. \u003cbr /\u003e Acceptable values are: - \"`free`\" - \"`groupLicense`\" - \"`userPurchase`\" | |\n\nMethods\n-------\n\n[delete](/android/work/play/emm-api/v1/entitlements/delete)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Removes an entitlement to an app for a user.\n\n[get](/android/work/play/emm-api/v1/entitlements/get)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Retrieves details of an entitlement.\n\n[list](/android/work/play/emm-api/v1/entitlements/list)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Lists all entitlements for the specified user. Only the ID is set.\n\n[update](/android/work/play/emm-api/v1/entitlements/update)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Adds or updates an entitlement to an app for a user."]]
