Grouplicenses

Para obtener una lista de métodos para este recurso, consulta al final de esta página.

Representaciones de recursos

Los objetos de licencia de grupo te permiten hacer un seguimiento de las licencias (llamadas derechos) de las aplicaciones gratuitas y pagadas. En el caso de las apps gratuitas, se crea una licencia grupal cuando un administrador empresarial aprueba por primera vez el producto en Google Play o cuando se crea el primer derecho del producto para un usuario a través de la API. En el caso de las aplicaciones pagadas, un objeto de licencia grupal solo se crea cuando un administrador empresarial compra el producto en Google Play por primera vez.

Usa la API para consultar licencias de grupos. Un recurso Grouplicenses incluye la cantidad total de licencias compradas (solo aplicaciones pagadas) y la cantidad total de licencias actualmente en uso. En otras palabras, la cantidad total de Entitlements que existen para el producto.

Solo se crea un objeto de licencia de grupo por cada objeto de licencia de grupo y nunca se borra. Si un producto no se aprueba, se mantendrá su licencia grupal. Esto permite a los administradores empresariales hacer un seguimiento de los derechos restantes del producto.

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
Nombre de la propiedad Valor Descripción Notas
acquisitionKind string Cómo se adquirió esta licencia de grupo. "bulkPurchase" significa que este recurso Grouplicenses se creó porque la empresa compró licencias para este producto; de lo contrario, el valor es "free" (para productos gratuitos).

Los valores aceptables son los siguientes:
  • "bulkPurchase"
  • "free"
approval string Si el producto con el que se relaciona esta licencia de grupo está aprobado actualmente por la empresa. Los productos se aprueban cuando se crea una licencia de grupo por primera vez, pero un administrador empresarial puede revocar esta aprobación a través de Google Play. Los productos no aprobados no estarán visibles para los usuarios finales de las colecciones y, por lo general, no se deben crear autorizaciones nuevas para ellos.

Los valores aceptables son los siguientes:
  • "approved"
  • "unapproved"
kind string
numProvisioned integer La cantidad total de licencias aprovisionadas para este producto. Lo muestran las operaciones de lectura, pero se ignoran en las operaciones de escritura.
numPurchased integer Indica la cantidad de licencias compradas (posiblemente en varias compras). Si se omite este campo, no habrá límite para la cantidad de licencias que se pueden aprovisionar (por ejemplo, si el tipo de adquisición es "free").
permissions string Es el estado de aprobación del permiso del producto. Este campo solo se configura si el producto está aprobado. Los estados posibles son los siguientes:
  • "currentApproved", se aprobó el conjunto actual de permisos, pero los permisos adicionales requerirán que el administrador vuelva a aprobar el producto (si el producto se aprobó sin especificar la configuración de permisos aprobada, este es el comportamiento predeterminado).
  • "needsReapproval", el producto tiene permisos no aprobados. No se pueden asignar licencias de productos adicionales hasta que el producto se vuelva a aprobar.
  • "allCurrentAndFutureApproved", se aprobaron los permisos actuales y cualquier actualización futura de permisos se aprobará de forma automática sin que el administrador lo revise.


Los valores aceptables son los siguientes:
  • "allCurrentAndFutureApproved"
  • "currentApproved"
  • "needsReapproval"
productId string Es el ID del producto para el que es la licencia. Por ejemplo, "app:com.google.android.gm".

Métodos

get
Recupera los detalles de la licencia grupal de una empresa de un producto.
list
Recupera los IDs de todos los productos para los que la empresa tiene una licencia grupal.