사용 권한 리소스가 있으면 사용자에게 특정 앱을 사용할 권리가 있음을 나타냅니다. 사용 권한은 기기별로 다르게 적용되지 않으며 사용자별로 다릅니다. 이렇게 하면 앱 사용 권한이 있는 사용자가 모든 기기에 앱을 설치할 수 있습니다. 사용자가 기기에 앱을 설치하지 않고도 앱에 대한 사용 권한을 보유할 수도 있습니다.
이 API는 사용 권한을 만드는 데 사용할 수 있습니다. API를 사용하여 사용 권한이 생성되는 동시에 모든 사용자의 관리 기기에 앱 설치를 트리거할 수도 있습니다.
앱이 무료인 경우 사용 권한을 만들면 앱의 그룹 라이선스도 생성됩니다. 유료 앱의 경우 사용 권한을 만들면 라이선스 1개가 소비되며, 해당 라이선스는 사용 권한이 삭제될 때까지 소비됩니다. 기업에서 라이선스를 충분히 구매하지 않은 경우 사용 권한이 생성되지 않고 설치가 실패합니다. 기업에서 수락하지 않은 권한이 앱에 필요한 경우에도 앱에 대한 사용 권한이 생성되지 않습니다.
사용 권한이 삭제되면 앱이 사용자 기기에서 제거될 수 있습니다. 자격을 삭제하기 전에 Installs.delete()를 호출하여 앱을 제거하는 것이 좋습니다.
사용자가 비관리 프로필로 비용을 지불하는 앱의 사용 권한에는 "userPurchase"이(가) 사용 권한 사유가 됩니다. 이러한 사용 권한은 API를 통해 삭제할 수 없습니다.
[null,null,["최종 업데이트: 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."]]
