Grouplicenses

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Mit Gruppenlizenzobjekten können Sie den Überblick über Lizenzen (sogenannte Berechtigungen) sowohl für kostenlose als auch für kostenpflichtige Apps behalten. Bei einer kostenlosen App wird eine Gruppenlizenz erstellt, wenn ein Unternehmensadministrator das Produkt zum ersten Mal bei Google Play genehmigt oder wenn die erste Berechtigung für das Produkt über die API für einen Nutzer erstellt wird. Bei einer kostenpflichtigen App wird nur dann ein Gruppenlizenzobjekt erstellt, wenn ein Unternehmensadministrator das Produkt zum ersten Mal bei Google Play erwirbt.

Fragen Sie Gruppenlizenzen über die API ab. Eine Grouplicenses-Ressource enthält die Gesamtzahl der erworbenen Lizenzen (nur kostenpflichtige Apps) und die Gesamtzahl der aktuell verwendeten Lizenzen. Mit anderen Worten, die Gesamtzahl der Entitlements, die für das Produkt vorhanden sind.

Pro Produkt wird nur ein Gruppenlizenzobjekt erstellt. Gruppenlizenzobjekte werden niemals gelöscht. Wenn ein Produkt nicht genehmigt wird, bleibt seine Gruppenlizenz erhalten. So können Unternehmensadministratoren alle verbleibenden Berechtigungen für das Produkt im Blick behalten.

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
Property-Name Wert Beschreibung Hinweise
acquisitionKind string Wie diese Gruppenlizenz erworben wurde. "bulkPurchase" bedeutet, dass diese GroupLicenses-Ressource erstellt wurde, weil das Unternehmen Lizenzen für dieses Produkt erworben hat. Andernfalls lautet der Wert "free" (für kostenlose Produkte).

Zulässige Werte sind:
  • "bulkPurchase"
  • "free"
approval string Gibt an, ob das Produkt, auf das sich diese Gruppenlizenz bezieht, derzeit vom Unternehmen genehmigt ist. Produkte werden genehmigt, wenn zum ersten Mal eine Gruppenlizenz erstellt wird. Diese Genehmigung kann jedoch von einem Unternehmensadministrator über Google Play widerrufen werden. Nicht genehmigte Produkte sind für Endnutzer in Sammlungen nicht sichtbar und es sollten normalerweise keine neuen Berechtigungen für sie erstellt werden.

Zulässige Werte sind:
  • "approved"
  • "unapproved"
kind string
numProvisioned integer Die Gesamtzahl der bereitgestellten Lizenzen für dieses Produkt. Wird von Lesevorgängen zurückgegeben, aber in Schreibvorgängen ignoriert.
numPurchased integer Die Anzahl der erworbenen Lizenzen (möglicherweise in mehreren Käufen). Wenn dieses Feld weggelassen wird, gibt es keine Begrenzung für die Anzahl der Lizenzen, die bereitgestellt werden können (z. B. wenn die Art der Akquisition "free" ist).
permissions string Der Genehmigungsstatus der Berechtigung des Produkts. Dieses Feld wird nur festgelegt, wenn das Produkt genehmigt ist. Mögliche Status sind:
  • "currentApproved" wurde der aktuelle Berechtigungssatz genehmigt. Zusätzliche Berechtigungen erfordern jedoch, dass der Administrator das Produkt noch einmal genehmigt. Wenn das Produkt ohne Angabe der genehmigten Berechtigungseinstellung genehmigt wurde, ist dies die Standardeinstellung.
  • „needsReapproval“, das Produkt hat nicht genehmigte Berechtigungen. Es können keine weiteren Produktlizenzen zugewiesen werden, bis das Produkt wieder genehmigt wurde.
  • „allCurrentAndFutureApproved“, die aktuellen Berechtigungen werden genehmigt. Alle zukünftigen Aktualisierungen von Berechtigungen werden automatisch und ohne Überprüfung durch den Administrator genehmigt.


Zulässige Werte sind:
  • "allCurrentAndFutureApproved"
  • "currentApproved"
  • "needsReapproval"
productId string Die ID des Produkts, für das die Lizenz gilt. Beispiel: "app:com.google.android.gm".

Methoden

get
Ruft Details der Gruppenlizenz eines Unternehmens für ein Produkt ab.
list
Ruft IDs aller Produkte ab, für die das Unternehmen eine Gruppenlizenz hat.