Grouplicenses

Si quieres obtener una lista de métodos para este recurso, consulta el final de esta página.

Representaciones de recursos

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

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

Solo se crea un objeto de licencia de grupo por producto y los objetos de licencia de grupo nunca se borran. Si un producto no está aprobado, su licencia de grupo permanece. Esto permite que los administradores empresariales hagan un seguimiento de los derechos restantes sobre el 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 de licencias de grupo 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 Indica si la empresa aprobó actualmente el producto al que se refiere esta licencia de grupo. Los productos se aprueban cuando se crea una licencia grupal por primera vez, pero un administrador empresarial puede revocar esta aprobación a través de Google Play. Los productos no aprobados no serán visibles para los usuarios finales de las colecciones, y normalmente no se deben crear nuevos derechos 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 hay límite en la cantidad de licencias que se pueden aprovisionar (por ejemplo, si el tipo de adquisición es "free").
permissions string El estado de aprobación del permiso del producto. Este campo solo se establece si el producto está aprobado. Los estados posibles son los siguientes:
  • "currentApproved", el conjunto actual de permisos está aprobado, 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 aprobados, este es el comportamiento predeterminado).
  • "needsReapproval", el producto tiene permisos no aprobados. No se pueden asignar licencias de productos adicionales hasta que se vuelva a aprobar el producto.
  • "allCurrentAndFutureApproved", se aprobarán los permisos actuales y las actualizaciones de permisos futuras se aprobarán automáticamente sin la revisión del administrador.


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

Métodos

obtener
Recupera los detalles de la licencia de grupo de una empresa para un producto. Nota: Este elemento ya no está disponible. Las integraciones nuevas no pueden usar este método y pueden consultar nuestras recomendaciones nuevas.
list
Recupera los ID de todos los productos para los que la empresa tiene una licencia de grupo. Nota: Este elemento ya no está disponible. Las integraciones nuevas no pueden usar este método y pueden consultar nuestras recomendaciones nuevas.