Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.
Ressourcendarstellungen
Das Vorhandensein einer Berechtigungsressource weist darauf hin, dass ein Nutzer das Recht hat, eine bestimmte App zu verwenden. Berechtigungen sind nutzerspezifisch, nicht gerätespezifisch. Dadurch kann ein Nutzer mit einer Berechtigung für eine App die App auf allen seinen Geräten installieren. Es ist auch möglich, dass ein Nutzer eine Berechtigung für eine App behält, ohne die App auf einem Gerät installieren zu müssen.
Mit der API kann eine Berechtigung erstellt werden. Sie haben auch die Möglichkeit, die API zu verwenden, um die Installation einer App auf allen verwalteten Geräten eines Nutzers gleichzeitig mit der Berechtigungserstellung auszulösen.
Wenn die App kostenlos ist, wird durch das Erstellen der Berechtigung auch eine Gruppenlizenz für diese App erstellt. Bei kostenpflichtigen Apps wird durch das Erstellen der Berechtigung eine Lizenz benötigt, die so lange genutzt wird, bis die Berechtigung entfernt wird. Wenn das Unternehmen nicht genügend Lizenzen erworben hat, wird keine Berechtigung erstellt und die Installation schlägt fehl. Es wird auch keine Berechtigung für eine App erstellt, wenn die App Berechtigungen erfordert, die das Unternehmen nicht akzeptiert hat.
Wenn eine Berechtigung gelöscht wird, kann die App auf dem Gerät eines Nutzers deinstalliert werden. Als Best Practice empfehlen wir, die App zu deinstallieren, indem du Installs.delete() aufrufst, bevor du die Berechtigung löschst.
Berechtigungen für Apps, für die ein Nutzer in einem nicht verwalteten Profil bezahlt, haben "userPurchase" als Berechtigungsgrund. Diese Berechtigungen können nicht über die API entfernt werden.
Die ID des Produkts, für das die Berechtigung gilt. Beispiel: "app:com.google.android.gm".
reason
string
Der Grund für die Berechtigung. Beispiel: "free" für kostenlose Apps. Dieses Attribut ist temporär: Es wird durch das Feld acquisition kind der Gruppenlizenzen ersetzt.
[null,null,["Zuletzt aktualisiert: 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."]]
