Grouplicenses

Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.

Rappresentazioni delle risorse

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

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

Viene creato un solo oggetto licenza di gruppo per prodotto e gli oggetti licenza di gruppo non vengono mai eliminati. Se un prodotto non viene approvato, la relativa licenza di gruppo rimane. In questo modo, gli amministratori aziendali possono tenere traccia di 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 Come è stata acquisita questa licenza di gruppo. "bulkPurchase" significa che questa risorsa Grouplicenses è stata creata perché l'azienda ha acquistato licenze per questo prodotto; in caso contrario, il valore è "free" (per i prodotti senza costi).

I valori accettati sono:
  • "bulkPurchase"
  • "free"
approval string Indica se il prodotto a cui si riferisce questa licenza di gruppo è attualmente approvato dall'azienda. I prodotti vengono approvati al momento della creazione di una licenza di gruppo, ma questa approvazione potrebbe essere revocata da un amministratore aziendale tramite Google Play. I prodotti non approvati non sono visibili agli utenti finali nelle raccolte e in genere non dovrebbero essere creati nuovi diritti per loro.

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 dalle 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 delle autorizzazioni del prodotto. Questo campo viene impostato solo se il prodotto è approvato. Gli stati possibili sono:
  • "currentApproved", l'insieme di autorizzazioni corrente è stato approvato, ma per autorizzazioni aggiuntive sarà necessario che l'amministratore riapprovasse il prodotto. Se il prodotto è stato approvato senza specificare l'impostazione delle autorizzazioni approvate, si tratta del comportamento predefinito.
  • "needsReapproval", il prodotto ha autorizzazioni non approvate. Non è possibile assegnare licenze di prodotto aggiuntive finché il prodotto non viene riapprovato.
  • "allCurrentAndFutureApproved", le autorizzazioni attuali sono state approvate ed eventuali aggiornamenti futuri delle autorizzazioni verranno approvati automaticamente senza revisione dell'amministratore.


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

Metodi

trova
Recupera i dettagli di una licenza di gruppo aziendale per un prodotto.
list
Recupera gli ID di tutti i prodotti per i quali l'azienda ha una licenza di gruppo.