Method: customers.getSubscriptionInfo

지정된 고객의 집계된 구독 및 라이선스 정보를 단일 리소스로 가져옵니다. 참고: ChromeOS 기기의 데이터는 스냅샷이므로 정확한 숫자가 최대 10초까지 지연될 수 있습니다.

HTTP 요청

GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. 가져올 고객 구독 정보의 리소스 이름입니다. 형식: customers/{customer}/subscriptionInfo

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

지정된 고객의 구독 및 라이선스 정보를 나타내는 단일 리소스입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
필드
name

string

식별자. 고객 구독 정보의 리소스 이름입니다. 형식: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

출력 전용입니다. Chrome Enterprise Upgrade 연간 SKU의 세부정보입니다.

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

출력 전용입니다. Kiosk &Signage Upgrade 연간 SKU의 세부정보입니다.

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

출력 전용입니다. Chrome Ent/Edu Upgrade 영구 SKU의 세부정보입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/chrome.management.subscriptions.readonly

AnnualSubscriptionInfo

매년 반복되는 구독/라이선스에 대한 정보입니다.

JSON 표현
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
필드
counts

object (LicenseCounts)

출력 전용입니다. 이 구독의 라이선스 수입니다.

subscriptionEndTime

string (Timestamp format)

출력 전용입니다. 현재 구독 기간이 종료되는 날짜입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

LicenseCounts

특정 라이선스 유형의 리소스 수입니다.

JSON 표현
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
필드
totalPurchasedCount

string (int64 format)

출력 전용입니다. 구매한 총 라이선스 수입니다.

assignedCount

string (int64 format)

출력 전용입니다. 현재 사용자 또는 기기에 할당된 총 라이선스 수입니다.

unassignedCount

string (int64 format)

출력 전용입니다. 할당 가능한 총 라이선스 수입니다.

PerpetualLicenseInfo

영구 라이선스에 대한 정보입니다.

JSON 표현
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
필드
counts

object (LicenseCounts)

출력 전용입니다. 영구 SKU의 라이선스 수입니다.

retiredCount

string (int64 format)

출력 전용입니다. 구매했지만 더 이상 등록할 수 없는 영구 업그레이드 수입니다. 이러한 영구 업그레이드는 이후에 지원 중단된 기기에 등록되었으며 업그레이드를 다른 기기로 이전하거나 재사용할 수 없습니다. 지원 중단된 라이선스는 할당된 총 라이선스의 하위 집합입니다.

conditionallyAvailableCount

string (int64 format)

출력 전용입니다. 이전에 등록되었다가 RMA, 보증 또는 수리 문제로 인해 나중에 등록이 해제된 독립형, 영구 적용형 업그레이드이며, 동일한 모델의 기기에서만 재사용할 수 있습니다. 조건부로 사용 가능한 라이선스는 할당된 총 라이선스의 하위 집합입니다.