Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.
Rappresentazioni delle risorse
La presenza di una risorsa Diritti indica che un utente ha il diritto di utilizzare una determinata app. I diritti sono specifici dell'utente, non del dispositivo. In questo modo un utente autorizzato a utilizzare un'app può installarla su tutti i propri dispositivi. È anche possibile che un utente detenga il diritto di un'app senza installarla su alcun dispositivo.
L'API può essere utilizzata per creare un diritto. In alternativa, puoi anche utilizzare l'API per attivare l'installazione di un'app su tutti i dispositivi gestiti di un utente nello stesso momento in cui viene creato il diritto.
Se l'app è senza costi, la creazione del diritto comporta anche una licenza di gruppo per quell'app. Per le app a pagamento, la creazione di un diritto utilizza una sola licenza, che rimane utilizzabile fino alla rimozione del diritto. Se l'azienda non ha acquistato un numero sufficiente di licenze, non viene creato alcun diritto e l'installazione non va a buon fine. Inoltre, non viene creato alcun diritto per un'app se quest'ultima richiede autorizzazioni non accettate dall'azienda.
Se un diritto viene eliminato, l'app potrebbe essere disinstallata dal dispositivo dell'utente. Come best practice, disinstalla l'app chiamando Installs.delete() prima di eliminare il diritto.
I diritti relativi alle app per cui un utente paga su un profilo non gestito hanno "userPurchase" come motivo. Questi diritti non possono essere rimossi tramite l'API.
L'ID del prodotto a cui si riferisce il diritto. Ad esempio, "app:com.google.android.gm".
reason
string
Il motivo del diritto. Ad esempio, "free" per le app senza costi. Questa proprietà è temporanea: verrà sostituita dal campo acquisition kind delle licenze di gruppo.
[null,null,["Ultimo aggiornamento 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."]]