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 요청에 포함해야 합니다. 이 속성은 선택사항입니다. 할인 코드가 이미 구독에 추가된 경우 이 속성이 비어 있을 수 있으며 기존 할인율이 계속 적용됩니다 (비어 있지 않으면 구독에 이미 있는 특가 코드만 제공). 할인 코드가 구독에 추가된 적이 없고 이 속성이 비어 있는 경우 일반 가격이 적용됩니다.