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"은 기업에서 이 제품의 라이선스를 구매하여 이 Grouplicenses 리소스가 생성되었음을 의미합니다. 그렇지 않으면 값은 "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"입니다.

메서드

get
제품의 엔터프라이즈 그룹 라이선스 세부정보를 검색합니다.
list
기업이 그룹 라이선스를 보유한 모든 제품의 ID를 검색합니다.