Grouplicenses

このリソースのメソッドの一覧は、このページの最後に掲載されています。

リソース表記

グループ ライセンス オブジェクトを使用すると、無料アプリと有料アプリの両方のライセンス(「利用資格」と呼ばれます)を追跡できます。無料アプリの場合は、企業の管理者が最初に Google Play でプロダクトを承認したとき、または API を介してプロダクトの最初の利用資格が付与されたときに、グループ ライセンスが作成されます。有料アプリの場合、グループ ライセンス オブジェクトは、企業の管理者が Google Play で初めてサービスを購入した場合にのみ作成されます。

API を使用して、グループ ライセンスをクエリします。Grouplicenses リソースには、購入したライセンスの合計数(有料アプリのみ)と現在使用されているライセンスの合計数が含まれます。つまり、商品に存在する Entitlements の合計数です。

サービス ライセンスごとに作成されるグループ ライセンス オブジェクトは 1 つのみで、グループ ライセンス オブジェクトは削除されません。商品が承認されない場合、グループのライセンスは残ります。これにより、企業の管理者はプロダクトの残りの利用資格を管理できます。

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
プロパティ名 説明 備考
acquisitionKind string このグループのライセンスの取得方法。"bulkPurchase" は、企業がこのライセンスのライセンスを購入したときに、このグループのライセンス リソースが作成されたことを意味します。それ以外の場合、値は "free"(無料サービスの場合)です。

有効な値は次のとおりです。
  • bulkPurchase
  • free
approval string このグループ ライセンスに関連する商品が現在企業によって承認されているかどうか。グループ ライセンスが最初に作成された時点でプロダクトが承認されますが、この承認は企業の管理者が Google Play から取り消すことがあります。未承認のプロダクトは、エンドユーザーがコレクションで確認することはできません。通常、それらのプロダクトに対する新しい利用資格を作成しないでください。

有効な値は次のとおりです。
  • approved
  • unapproved
kind string
numProvisioned integer このプロダクトでプロビジョニングされるライセンスの合計数。読み取りオペレーションで返されますが、書き込みオペレーションでは無視されます。
numPurchased integer 購入したライセンスの数(複数回の購入に含まれる可能性があります)。このフィールドを省略すると、プロビジョニングできるライセンス数に上限はありません(たとえば、取得の種類が "free" の場合)。
permissions string 商品の権限の承認ステータス。このフィールドは、商品が承認された場合にのみ設定されます。次のようなステータスが表示されます。
  • currentApproved」の現在の権限セットは承認されていますが、追加の権限を適用するには、管理者がプロダクトを再承認する必要があります(承認済み権限の設定を指定せずにプロダクトが承認された場合は、デフォルトの動作になります)。
  • needsReapproval」に、このサービスには未承認の権限が付与されています。プロダクトが再承認されるまで、追加のプロダクト ライセンスを割り当てることはできません。
  • allCurrentAndFutureApproved」の現在の権限は今後承認され、今後の権限の更新は管理者の確認なしで自動的に承認されます。


有効な値は次のとおりです。
  • "allCurrentAndFutureApproved"
  • currentApproved
  • needsReapproval
productId string ライセンスの対象となるサービスの ID。たとえば、"app:com.google.android.gm" です。

Methods

get
企業の企業グループ ライセンスの詳細情報を取得します。注: この項目は非推奨になりました。新しい統合では、この方法を使用できません。新しい推奨事項をご覧ください。
list
企業がグループ ライセンスを持っているすべての商品の ID を取得します。注: この項目は非推奨になりました。新しい統合では、この方法を使用できません。新しい推奨事項をご覧ください。