의견 보내기
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_MONTHLY_PAY
는 모든 API 응답에서 ANNUAL
로 반환됩니다. ANNUAL_YEARLY_PAY
- 연간 결제가 포함된 연간 약정 요금제 FLEXIBLE
- 탄력 요금제 TRIAL
- 30일 무료 체험판 요금제
seats
object (Seats
)
필수 속성입니다. 사용 가능 라이선스 수 속성은 사용자 라이선스 수 라이선스 수입니다.
purchaseOrderId
string
이는 선택적 속성입니다. 이 구매주문서 (PO) 정보는 리셀러가 회사의 사용량을 추적하는 데 사용할 수 있습니다. purchaseOrderId
값이 제공되면 API 응답에 표시되고 인보이스에 표시됩니다. 속성에는 최대 80자(영문 기준)의 일반 텍스트를 입력할 수 있습니다.
dealCode
string
정기 결제 요금제의 할인 가격으로 Google에서 발급한 코드 (영문 기준 최대 100자)입니다. 할인율을 적용받으려면 거래 코드를 changePlan
요청에 포함해야 합니다. 이 속성은 선택사항입니다. 할인 코드가 이미 구독에 추가된 경우 이 속성이 비어 있을 수 있으며 기존 할인율이 계속 적용됩니다 (비어 있지 않으면 구독에 이미 있는 특가 코드만 제공). 할인 코드가 구독에 추가된 적이 없고 이 속성이 비어 있는 경우 일반 가격이 적용됩니다.
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-09-09(UTC)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"필요한 정보가 없음"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"너무 복잡함/단계 수가 너무 많음"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"오래됨"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"번역 문제"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"샘플/코드 문제"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"기타"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"이해하기 쉬움"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"문제가 해결됨"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"기타"
}]
의견을 전달하고 싶나요?
{"lastModified": "\ucd5c\uc885 \uc5c5\ub370\uc774\ud2b8: 2024-09-09(UTC)"}
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-09-09(UTC)"]]