Grouplicenses

Consulta l'elenco dei metodi per questa risorsa alla fine di questa pagina.

Rappresentazioni delle risorse

Gli oggetti per licenze di gruppo consentono di tenere traccia delle licenze (chiamate diritti) per le app senza costi e a pagamento. Per un'app senza costi, viene creata una licenza di gruppo quando un amministratore aziendale approva per la prima volta il prodotto in Google Play o quando viene creato il primo diritto per il prodotto per un utente tramite l'API. Per un'app a pagamento, un oggetto licenza di gruppo viene creato solo quando un amministratore aziendale acquista il prodotto in Google Play per la prima volta.

Utilizza l'API per eseguire query sulle licenze del gruppo. Una risorsa Grouplicenses include il numero totale di licenze acquistate (solo app a pagamento) e il numero totale di licenze attualmente in uso. In altre parole, il numero totale di Entitlements che esistono per il prodotto.

Viene creato un solo oggetto di licenza di gruppo per prodotto e gli oggetti di licenza di gruppo non vengono mai eliminati. Se un prodotto viene disapprovato, la licenza di gruppo resta valida. In questo modo gli amministratori aziendali possono tenere traccia degli eventuali diritti rimanenti per il prodotto.

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
Nome proprietà Valore Descrizione Note
acquisitionKind string Modalità di acquisizione della licenza di gruppo. "bulkPurchase" significa che questa risorsa Grouplicenses è stata creata perché l'azienda ha acquistato licenze per questo prodotto; altrimenti, il valore è "free" (per i prodotti senza costi).

I valori accettati sono:
  • "bulkPurchase"
  • "free"
approval string Indica se il prodotto a cui si riferisce la licenza di gruppo è attualmente approvato dall'azienda. I prodotti vengono approvati quando viene creata la licenza di gruppo per la prima volta, ma l'approvazione potrebbe essere revocata da un amministratore aziendale tramite Google Play. I prodotti non approvati non sono visibili agli utenti finali nelle raccolte e i nuovi diritti a questi non devono essere creati normalmente.

I valori accettati sono:
  • "approved"
  • "unapproved"
kind string
numProvisioned integer Il numero totale di licenze di cui è stato eseguito il provisioning per questo prodotto. Restituito da operazioni di lettura, ma ignorato nelle operazioni di scrittura.
numPurchased integer Il numero di licenze acquistate (possibilmente in più acquisti). Se questo campo viene omesso, non esiste alcun limite al numero di licenze di cui è possibile eseguire il provisioning (ad esempio, se il tipo di acquisizione è "free").
permissions string Lo stato di approvazione del prodotto. Questo campo viene impostato solo se il prodotto è approvato. Gli stati possibili sono:
  • "currentApproved", l'insieme di autorizzazioni corrente è approvato, ma per ulteriori autorizzazioni l'amministratore dovrà riapprovare il prodotto (se il prodotto è stato approvato senza specificare l'impostazione delle autorizzazioni approvate, questo è il comportamento predefinito).
  • "needsReapproval", il prodotto dispone di autorizzazioni non approvate. Non puoi assegnare licenze di prodotto aggiuntive fino a quando il prodotto non viene riapprovato.
  • "allCurrentAndFutureApproved", le autorizzazioni attuali vengono approvate e gli aggiornamenti futuri delle autorizzazioni verranno approvati automaticamente senza revisione da parte dell'amministratore.


I valori accettati sono:
  • "allCurrentAndFutureApproved"
  • "currentApproved"
  • "needsReapproval"
productId string L'ID del prodotto per cui è stata concessa la licenza. Ad esempio, "app:com.google.android.gm".

Metodi

ricevi
Recupera i dettagli della licenza di gruppo di un'azienda per un prodotto. Nota: questo elemento è deprecato. Le nuove integrazioni non possono utilizzare questo metodo e possono fare riferimento ai nostri nuovi consigli.
list
Recupera gli ID di tutti i prodotti per i quali l'azienda ha una licenza di gruppo. Nota: questo elemento è deprecato. Le nuove integrazioni non possono utilizzare questo metodo e possono fare riferimento ai nostri nuovi consigli.