Entitlements

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 particulière. Les droits d'accès sont spécifiques à l'utilisateur et non à l'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 entraîne également la création d'une licence de groupe pour cette application. Pour les applications payantes, la création du droit d'accès nécessite une seule 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.

{
  "kind": "androidenterprise#entitlement",
  "productId": string,
  "reason": string
}
Nom de propriété Valeur Description Remarques
kind string
productId string 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.

Les valeurs possibles sont les suivantes :
  • "free"
  • "groupLicense"
  • "userPurchase"

Méthodes

supprimer
Supprime le droit d'accès d'une application à une application.
get
Récupère les détails d'un droit d'accès.
liste
Répertorie tous les droits d'accès de l'utilisateur spécifié. Seul l'ID est défini.
mise à jour
Ajoute ou met à jour un droit d'accès à une application pour un utilisateur.