Grouplicenses

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

資源表示法

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

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

每項產品只會建立一個群組授權物件,系統也不會刪除群組授權物件。即使產品未獲核准,其群組授權仍然有效。這樣企業管理員就能追蹤產品的所有剩餘授權。

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
資源名稱 說明 Notes
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。注意:此項目已不適用。新的整合作業無法使用這個方法,並請參閱新建議