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

subscriptions.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)

필수 속성입니다. seats 속성은 사용자 좌석 라이선스 수입니다.
purchaseOrderId

string

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

string

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