Grouplicenses

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

Ressourcendarstellungen

Mit Gruppenlizenzobjekten können Sie sowohl für kostenlose als auch für kostenpflichtige Apps Lizenzen (Berechtigungen) verfolgen. 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 für einen Nutzer über die API erstellt wird. Bei einer kostenpflichtigen App wird ein Gruppenlizenzobjekt nur erstellt, wenn ein Unternehmensadministrator das Produkt zum ersten Mal bei Google Play kauft.

Verwenden Sie die API, um Gruppenlizenzen abzufragen. Eine Grouplicenses-Ressource enthält die Gesamtzahl der gekauften Lizenzen (nur kostenpflichtige Apps) und die Gesamtzahl der aktuell verwendeten Lizenzen. Mit anderen Worten: Die Gesamtzahl der Entitlements für das Produkt.

Pro Produkt wird nur ein Gruppenlizenzobjekt erstellt. Gruppenlizenzobjekte werden nie gelöscht. Wenn ein Produkt nicht genehmigt ist, 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
}
Attributname 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 ist der Wert "free" (für kostenlose Produkte).

Folgende Werte sind zulässig:
  • bulkPurchase
  • free
approval string Gibt an, ob das Produkt, auf das sich diese Gruppenlizenz bezieht, derzeit vom Unternehmen genehmigt ist. Produkte werden genehmigt, wenn eine Gruppenlizenz zum ersten Mal 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 diese Produkte erstellt werden.

Folgende Werte sind zulässig:
  • approved
  • unapproved
kind string
numProvisioned integer Die Gesamtzahl der bereitgestellten Lizenzen für dieses Produkt. Wird von Lesevorgängen zurückgegeben, aber von Schreibvorgängen ignoriert.
numPurchased integer Die Anzahl der gekauften Lizenzen (möglicherweise bei mehreren Käufen). Wenn dieses Feld weggelassen wird, gibt es keine Beschränkung für die Anzahl der Lizenzen, die bereitgestellt werden können (z. B. wenn die Akquisitionsart "free" ist).
permissions string Der Genehmigungsstatus des Produkts. Dieses Feld wird nur festgelegt, wenn das Produkt genehmigt ist. Mögliche Status:
  • currentApproved“, der aktuelle Satz von Berechtigungen ist genehmigt, aber zusätzliche Berechtigungen erfordern, dass der Administrator das Produkt noch einmal genehmigt. Wenn das Produkt ohne die Einstellung für genehmigte Berechtigungen genehmigt wurde, ist dies das Standardverhalten.
  • needsReapproval“ hat das Produkt nicht genehmigte Berechtigungen. Es können keine zusätzlichen Produktlizenzen zugewiesen werden, bis das Produkt wieder genehmigt wurde.
  • allCurrentAndFutureApproved“, die aktuellen Berechtigungen werden genehmigt und alle zukünftigen Berechtigungsupdates werden automatisch und ohne Administratorüberprüfung genehmigt.


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

Methoden

erhalten
Ruft Details zur Gruppenlizenz eines Unternehmens für ein Produkt ab. Hinweis: Dieses Element wurde eingestellt. Neue Integrationen können diese Methode nicht verwenden und können sich auf unsere neuen Empfehlungen beziehen.
list
Ruft IDs aller Produkte ab, für die das Unternehmen eine Gruppenlizenz hat. Hinweis: Dieses Element wurde eingestellt. Neue Integrationen können diese Methode nicht verwenden und können sich auf unsere neuen Empfehlungen beziehen.