Method: subscriptions.changePlan

구독 요금제를 업데이트합니다. 이 방법을 사용하여 30일 무료 체험 요금제나 탄력 요금제 구독을 월간 또는 연간 결제가 포함된 연간 약정 요금제로 업데이트할 수 있습니다.

요금제 업데이트 방법은 요금제와 제품에 따라 다릅니다. 자세한 내용은 정기 결제 관리의 설명을 참고하세요.

HTTP 요청

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan

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

경로 매개변수

매개변수
customerId

string

고객의 기본 도메인 이름 또는 고객의 고유 식별자 중 하나입니다. 고객의 도메인 이름이 변경되는 경우 이전 도메인 이름을 사용하여 고객에 액세스할 수 없지만, API에서 반환하는 고객의 고유 식별자는 항상 사용할 수 있습니다. 해당하는 경우 시스템에 고유 식별자를 저장하는 것이 좋습니다.
subscriptionId

string

필수 속성입니다. subscriptionId는 정기 결제 식별자이며 고객마다 고유합니다. 정기 결제가 업데이트되면 subscriptionId가 변경되므로 이 ID를 영구 데이터의 키로 사용하지 않는 것이 좋습니다. subscriptionId는 모든 리셀러 구독 검색 메서드를 사용하여 찾을 수 있습니다.

요청 본문

요청 본문에는 ChangePlanRequest의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 Subscription의 인스턴스가 포함됩니다.

승인 범위

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

  • https://www.googleapis.com/auth/apps.order

자세한 내용은 승인 가이드를 참고하세요.

ChangePlanRequest

Subscription.changePlan RPC 요청의 JSON 템플릿입니다.

JSON 표현 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
필드
kind

string

리소스를 구독 요금제 변경 요청으로 식별합니다. 값: subscriptions#changePlanRequest
planName

string

planName 속성은 필수입니다. 구독 요금제의 이름입니다. Google 요금제에 대한 자세한 내용은 API 개념을 참고하세요.

가능한 값은 다음과 같습니다.

  • ANNUAL_MONTHLY_PAY - 월별 결제가 포함된 연간 약정 요금제
  • ANNUAL_YEARLY_PAY - 연간 결제가 포함된 연간 약정 요금제
  • FLEXIBLE - 탄력 요금제
  • TRIAL - 30일 무료 체험 요금제

seats

object (Seats)

필수 속성입니다. 사용 가능 라이선스 수 속성은 사용자 사용 가능 라이선스의 수입니다.
purchaseOrderId

string

이는 선택적 속성입니다. 이 구매주문서 (PO) 정보는 리셀러가 회사의 사용량을 추적하는 데 사용합니다. purchaseOrderId 값이 지정되면 이 값은 API 응답에 표시되고 인보이스에 표시됩니다. 숙박 시설에는 최대 80자(영문 기준)의 일반 텍스트를 입력할 수 있습니다.
dealCode

string

구독 요금제 할인이 적용되는 Google에서 발급한 코드 (최대 100자)입니다. 할인을 받으려면 changePlan 요청에 특가 코드를 포함해야 합니다. 이 속성은 선택사항입니다. 할인 코드가 이미 정기 결제에 추가된 경우 이 속성을 비워 둘 수 있으며 기존 할인율은 계속 적용됩니다 (비어 있지 않은 경우 정기 결제에 이미 있는 할인 코드만 제공). 정기 결제에 거래 코드를 추가한 적이 없고 이 속성이 비어 있는 경우 정상 가격이 적용됩니다.