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。