Grouplicenses

如需本資源的方法清單,請見本頁結尾。

資源表示法

群組授權物件可讓您追蹤免費與付費應用程式的授權 (稱為「授權」)。如果是免費應用程式,當企業管理員先在 Google Play 核准產品,或透過 API 為使用者建立產品的第一筆授權時,就會建立群組授權。如果是付費應用程式,則只有在企業管理員首次在 Google Play 購買該產品時,才會建立群組授權物件。

使用 API 查詢群組授權。Grouplicenses 資源包含購買的授權總數 (僅限付費應用程式),以及目前使用的授權總數。換句話說,產品存在的 Entitlements 總數。

系統只會為每個產品和群組授權物件建立一個群組授權物件,而且不會遭到刪除。如果產品未獲核准,其群組授權仍會保留。讓企業管理員追蹤產品剩餘的授權。

{
  "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"

方法

取得
擷取產品的企業群組授權詳細資料。
list
擷取企業具有團體授權的所有產品 ID。