Grouplicenses

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Les objets de licence de groupe vous permettent d'effectuer le suivi des licences (appelées droits d'accès) pour les applications sans frais et payantes. Pour une application sans frais, une licence de groupe est créée lorsqu'un administrateur de l'entreprise approuve le produit pour la première fois dans Google Play ou lorsque le premier droit d'accès au produit est créé pour un utilisateur via l'API. Pour une application payante, un objet de licence de groupe n'est créé que lorsqu'un administrateur d'entreprise achète le produit sur Google Play pour la première fois.

Utilisez l'API pour interroger les licences de groupe. Une ressource Grouplicenses inclut le nombre total de licences achetées (applications payantes uniquement) et le nombre total de licences actuellement utilisées. En d'autres termes, le nombre total d'Entitlements existant pour le produit.

Un seul objet de licence de groupe est créé par produit, et les objets de licence de groupe ne sont jamais supprimés. Si un produit n'est pas approuvé, sa licence de groupe est conservée. Les administrateurs de l'entreprise peuvent ainsi suivre tous les droits d'accès restants pour le produit.

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
Nom de propriété Valeur Description Remarques
acquisitionKind string Façon dont cette licence de groupe a été acquise. "bulkPurchase" signifie que cette ressource Grouplicenses a été créée parce que l'entreprise a acheté des licences pour ce produit. Sinon, la valeur est "free" (pour les produits sans frais).

Les valeurs possibles sont les suivantes :
  • "bulkPurchase"
  • "free"
approval string Indique si le produit auquel se rapporte cette licence de groupe est actuellement approuvé par l'entreprise. Les produits sont approuvés lorsqu'une licence de groupe est créée pour la première fois, mais cette approbation peut être révoquée par un administrateur de l'entreprise via Google Play. Les produits non approuvés ne seront pas visibles par les utilisateurs finaux dans les collections, et aucun droit ne devrait normalement être créé pour ces produits.

Les valeurs possibles sont les suivantes :
  • "approved"
  • "unapproved"
kind string
numProvisioned integer Nombre total de licences provisionnées pour ce produit. Renvoyé par les opérations de lecture, mais ignoré dans les opérations d'écriture.
numPurchased integer Nombre de licences achetées (éventuellement en plusieurs achats). Si ce champ est omis, le nombre de licences pouvant être provisionnées n'est pas limité (par exemple, si le type d'acquisition est "free").
permissions string État d'approbation des autorisations du produit. Ce champ n'est défini que si le produit est approuvé. Les états possibles sont les suivants:
  • "currentApproved", l'ensemble d'autorisations actuel est approuvé, mais les autorisations supplémentaires nécessitent que l'administrateur approuve de nouveau le produit (si le produit a été approuvé sans spécifier le paramètre d'autorisation approuvé, il s'agit du comportement par défaut).
  • "needsReapproval" correspond à des autorisations non approuvées. Aucune licence de produit supplémentaire ne peut être attribuée tant que le produit n'a pas été réapprouvé.
  • "allCurrentAndFutureApproved", les autorisations actuelles sont approuvées et toutes les futures mises à jour seront automatiquement approuvées sans examen par l'administrateur.


Les valeurs acceptées sont les suivantes :
  • "allCurrentAndFutureApproved"
  • "currentApproved"
  • "needsReapproval"
productId string Identifiant du produit associé à la licence. Par exemple, "app:com.google.android.gm".

Méthodes

get
Récupère les détails de la licence de groupe d'une entreprise pour un produit.
liste
Récupère les ID de tous les produits pour lesquels l'entreprise dispose d'une licence de groupe.