향후 요금제 만들기

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

소개

기존 요금제를 게시한 후에는 종료일만 변경할 수 있습니다. 하지만 변경된 요금제 요율과 같은 변경된 속성을 포함하는 새 버전의 계획을 만들 수 있습니다. 향후 날짜에 적용되도록 버전을 설정할 수 있습니다. 새 요금제가 적용되면 기존 요금제는 종료됩니다.

예를 들어 2019년 12월 31일에 만료되는 표준 요금제를 만들었는데 2020년 1월 1일부터 적용되는 다른 요금제로 대체하려는 경우 이를 위해 향후 요금제를 만들고 2020년 1월 1일부터 적용되도록 설정합니다.

현재 요금제에 종료일이 설정되지 않은 경우 기존 요금제를 오늘과 같이 시작되는 향후 요금제로 대체할 수 있습니다. 게시된 요금제 만료에 설명된 대로 현재 요금제를 만료해야 합니다.

개발자에게 수정된 요금제에 관한 알림이 전송됩니다. 기존 요금제를 수락하는 개발자는 자동으로 수정본에 등록되지만, 수정사항을 거부할 수 있습니다.

다음 섹션에 설명된 대로 관리 UI 또는 수익 창출 API를 사용하여 향후 요금제를 만들 수 있습니다.

UI를 사용하여 향후 요금제 만들기

아래에 설명된 대로 향후 요금제를 만듭니다.

에지

Edge UI를 사용하여 오늘이 지난 후 시작되는 요금제의 향후 버전을 만들려면 다음 단계를 수행합니다.

  1. 요금제 페이지에서 향후 요금제를 만들려는 요금제와 연결된 행으로 커서를 이동합니다.
    요금제에는 종료일이 있어야 합니다.
  2. +향후를 클릭합니다.
  3. 향후 요금제 섹션에서 다음 중 하나를 선택합니다.
    • 새로운 시행일에 전체 계약 기간 다시 시작: 향후 요금제가 시행일에 적용됩니다. 향후 요금제의 갱신 기간은 현재 요금제의 갱신 기간과 동일합니다.
    • 새 기간에서 이전 계약에 사용된 시간 공제: 향후 요금제가 시행일에 적용됩니다. 현재 요금제를 사용하는 데 소요된 시간은 향후 요금제의 갱신 기간에서 차감됩니다. 즉, 개발자가 현재 요금제를 3개월 동안 사용하고 갱신 기간이 3개월 단축된 경우입니다.
  4. 상단 패널에서 다음 필드를 구성합니다.
    참고: 다른 필드는 읽기 전용입니다.
    필드 설명 기본 계정 필수
    요금제 이름

    요금제 이름입니다.

    참고: 이름이 원래 요금제 이름과 일치하지 않아도 됩니다.

    기존 요금제 이름 지원됨
    시작일 요금제가 적용되는 날짜입니다. 시작일을 입력하거나 캘린더를 사용하여 날짜를 선택합니다. 오늘 No
    종료일 요금제가 종료되는 날짜입니다. 종료일을 지정하려면 종료일 있음 전환 스위치를 사용 설정하고 종료일을 입력하거나 캘린더를 사용하여 날짜를 선택합니다.

    참고: 요금제는 지정된 날짜의 하루가 끝날 때까지 적용됩니다. 예를 들어 요금제를 2018년 12월 1일에 만료하려면 endDate 값을 2018-11-30으로 설정해야 합니다. 이 경우 요금제가 2018년 11월 30일에 만료되며 2018년 12월 1일에 발생한 모든 요청은 차단됩니다.

    없음 No
    포털에 표시 요금제를 공개 또는 비공개할지 설정합니다. 공개 요금제와 특별 요금제 비교를 참고하세요. 사용 설정됨 No
  5. 요금제의 수수료를 구성합니다. 수수료 구성을 참조하세요.
    참고: 조정 가능한 알림 요금제에는 적용되지 않습니다.
  6. API 제품이 2개 이상 포함된 제품 번들을 선택하는 경우 특정 요금제 또는 일반 요금제 섹션에서 다음 환경설정을 지정합니다.
    참고: 이 단계는 조정 가능한 알림 요금제에는 적용되지 않습니다.
    필드 설명 기본 계정
    각 제품을 개별적으로 구성 각 API 제품에 대해 개별 요금제를 구성할지 지정하는 플래그입니다. 사용 중지됨
    각 제품의 부분 유료 모델 혜택을 개별적으로 구성 각 API 제품에 대해 부분 유료 모델 요금제를 구성할지 여부를 지정하는 플래그입니다. 사용 중지됨
    제품 선택 플래그 중 하나 또는 둘 다를 사용 설정하는 경우 드롭다운 목록에서 각 제품을 개별적으로 선택하고 요금제 세부정보를 구성해야 합니다.

    참고: 제품 번들의 모든 제품을 구성해야 합니다.

    N/A
  7. 선택한 요금제 유형에 따라 요금제 세부정보를 구성합니다.
  8. 다음 중 하나를 클릭합니다.
    버튼 설명
    초안 업데이트 요금제를 초안으로 저장합니다.

    요금제가 게시될 때까지 앱 개발자에게 표시되지 않습니다. 임시 요금제의 모든 필드를 수정할 수 있습니다.

    초안 게시 계획을 게시합니다.

    참고: 요금제를 게시한 후에는 종료일이 아직 설정되지 않은 경우에만 종료일을 수정할 수 있습니다. 요금제가 게시된 후에는 삭제할 수 없지만 게시된 요금제 만료에 설명된 대로 요금제를 만료하고 향후 요금제로 대체할 수 있습니다.

Classic Edge (Private Cloud)

기본 Edge UI를 사용하여 오늘이 지난 후 시작되는 요금제의 향후 버전을 만들려면 다음 단계를 수행합니다.

  1. 패키지 카탈로그에서 교체하려는 요금제의 초안/미래 열에 있는 +향후를 클릭합니다.

    그러면 향후 요금제 창이 열립니다.

    향후 요금제 기간과 현재 요금제 기간의 주요 차이점은 기존 구독자 섹션이 추가된다는 점입니다.

  2. 다른 요금제와 동일한 경우:
    • 요금제 이름 입력란에 요금제 이름을 입력합니다. 이름은 기존 요금제의 이름과 일치하지 않아도 됩니다.
    • 요금제 수수료 구성 (선택사항)
    • 선택한 요금제 유형에 따라 요금제 세부정보를 구성합니다.
    • 향후 요금제가 적용되는 날짜 (요금제 게시 참고)와 종료일 (향후 요금제가 특정 날짜에 종료되지 않도록 하려면 '종료일 없음'을 선택)을 지정합니다. 현재 요금제에 종료일이 설정된 경우 향후 계획의 시행일은 현재 요금제의 종료일 이후여야 합니다.
  3. 기존 구독자 섹션에서 다음 중 하나를 선택합니다.
    • 새로운 시행일에 전체 계약 기간을 다시 시작합니다. 향후 요금제는 시행일부터 적용됩니다. 향후 요금제의 갱신 기간은 현재 요금제의 갱신 기간과 동일합니다.
    • 시행일부터 새 기간에서 이전 계약에 사용된 시간을 차감합니다. 향후 요금제는 해당 시행일부터 적용됩니다. 현재 요금제를 사용하는 데 소요된 시간은 향후 요금제의 갱신 기간에서 차감됩니다. 즉, 개발자가 현재 요금제를 3개월 동안 사용하고 갱신 기간이 3개월 단축된 경우입니다.
  4. 시행일 필드에 기존 요금제의 종료일 이후의 시작일을 입력합니다.

API를 사용하여 향후 요금제 만들기

/organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revisionPOST 요청을 실행하여 API를 사용하여 향후 요금제를 만들 수 있습니다.

각 항목의 의미는 다음과 같습니다.

  • {org_id}은 조직의 이름입니다.
  • {package_id}는 API 패키지의 ID입니다.
  • {plan_Id}는 요금제의 식별입니다.
버전을 만들 때 요청 본문에 다음 속성을 지정해야 합니다.
  • parentRatePlan는 원래 요금제의 ID를 지정합니다.
  • startDate은 새 계획이 적용되는 날짜를 지정합니다.

향후 요금제 이름이 원래 요금제의 이름과 일치하지 않아도 됩니다. 개발자를 위해 기록된 원래 시작일을 유지하려면 keepOriginalStartDate 플래그를 true로 설정합니다. 이 플래그는 기본적으로 false로 설정됩니다.

구성 설정에 대한 자세한 내용은 요금제 구성 설정을 참고하세요.

예를 들어 다음 요청은 향후 요금제를 생성합니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{ 
     "parentRatePlan": {
       "id": "monetization_package_flat_rate_card_plan_1379513833409"
     },
     "name": "Flat rate card plan",
     "developer":null,
     "developerCategory":null,
     "advance": "false",
     "currency": {
      "id" : "usd"
     },     
     "description": "Flat rate card plan",
     "displayName" : "Flat rate card plan",
     "frequencyDuration": "30",
     "frequencyDurationType": "DAY",
     "earlyTerminationFee": "10",     
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "paymentDueDays": "30",
     "prorate": "false",
     "published": "true",
     "ratePlanDetails": [
     {
      "currency": {
       "id" : "usd"
      },
      "paymentDueDays": "30",      
      "meteringType": "UNIT",
      "organization": {
       "id": "myorg"
      },
      "ratePlanRates": [
       {
        "type": "RATECARD",
        "rate": "0.05",
        "startUnit": "0"       
       }      
      ],     
     "ratingParameter": "VOLUME",
     "type": "RATECARD"
     }],
     "recurringStartUnit": 1,
     "recurringType": "CALENDAR",
     "recurringFee": "10",
     "setUpFee": "10",
     "startDate": "2014-01-01 00:00:00",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \
-u email:password