요금제 관리

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서.
정보

다음 섹션에 설명된 대로 UIAPI를 사용하여 요금제를 관리하세요.

요금제 페이지 살펴보기

아래 설명에 따라 요금제 페이지에 액세스합니다.

에지

Edge UI에서 요금제를 보려면 요금제 페이지에 액세스합니다.

  1. apigee.com/edge에 로그인합니다.
  2. 게시 > 수익 창출 > 요금제를 클릭합니다.

요금제 페이지가 표시됩니다.

그림에 강조 표시된 것처럼 요금제 페이지에서 수행할 수 있는 작업은 다음과 같습니다.

Classic Edge (Private Cloud)

기본 Edge UI를 사용하여 요금제를 보려면 API 패키지 페이지에 액세스하세요.

  1. http://ms-ip:9000에 로그인합니다. 여기서 ms-ip는 관리 서버 노드의 IP 주소 또는 DNS 이름입니다.
  2. 게시 > 패키지를 클릭합니다.

API 패키지 페이지에는 각 패키지에 정의된 요금제가 표시됩니다.

요금제 페이지에서는 다음 작업이 가능합니다.

요금제 만들기

요금제를 만들려면 다음 단계를 따르세요.

  1. 요금제 페이지에 액세스합니다.
  2. +요금제를 클릭합니다.
  3. 상단 패널에서 다음 필드를 구성합니다.
    필드 설명 기본값 필수
    요금제 이름 요금제의 이름입니다.

    참고: 이름은 API 제품 번들 내에서 고유해야 합니다. 동일한 제품 번들에 있는 두 요금제의 이름이 같을 수 없습니다.

    해당 사항 없음
    요금제 유형 요금제 유형입니다. 드롭다운 목록에서 값을 선택합니다. 유효한 요금제 유형 목록은 지원되는 요금제 유형을 참고하세요. 해당 사항 없음
    제품 번들 API 제품 번들입니다. 드롭다운 목록에서 값을 선택합니다. API 제품 번들에 대한 자세한 내용은 API 제품 번들 관리를 참조하세요.

    API 제품이 2개 이상 포함된 제품 번들을 선택하는 경우 각 API 제품에 개별 요금제를 구성할지 아니면 모든 API 제품에 적용되는 일반 요금제를 구성할지 선택해야 합니다.

    해당 사항 없음
    잠재고객 요금제에 액세스할 수 있는 잠재고객입니다. 드롭다운 목록에서 다음 값 중 하나를 선택합니다.
    • 모든 사용자 - 모든 개발자
    • 개발자 - 개발자 또는 회사입니다. 개발자 이름 또는 회사를 입력합니다. 입력할 때 문자열이 포함된 개발자/회사 목록이 드롭다운으로 표시됩니다. 드롭다운 목록에서 개발자 또는 회사의 이름을 클릭합니다.
    • 개발자 카테고리 - 개발자 카테고리입니다. 드롭다운 목록에서 개발자 카테고리를 선택합니다.

      개발자 카테고리 관리에 설명된 대로 필요에 따라 개발자 카테고리를 구성합니다.

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

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

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

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

    해당 사항 없음
  6. 선택한 요금제 유형에 따라 요금제 세부정보를 구성합니다.
    <ph type="x-smartling-placeholder">
  7. 다음 중 하나를 클릭합니다.
    버튼 설명
    초안으로 저장 요금제를 초안으로 저장합니다.

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

    새 요금제 게시 계획을 게시합니다.

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

  8. 요금제에 포함된 API 제품과 연결된 API 프록시에 수익 창출 한도 확인 정책을 연결합니다. 수익 창출 한도 확인 정책은 API 프록시에 수익 창출 한도를 적용하고 모든 결함이 정확하게 캡처되도록 합니다. 분석 및 수익 창출 보고서 자세한 내용은 API 프록시에 수익 창출 제한 적용

요금제 수정

제품 번들, 유형, 잠재고객을 제외한 임시 요금제의 모든 필드를 수정할 수 있습니다. 요금제를 게시한 후에는 종료일이 지정되지 않은 경우에만 종료일만 수정할 수 있습니다.

요금제를 수정하려면 다음 단계를 따르세요.

  1. 요금제 페이지에 액세스합니다.
  2. 수정하려는 요금제의 행 안을 클릭합니다.
    요금제 패널이 표시됩니다.
  3. 필요에 따라 요금제 입력란을 수정합니다.
    참고: 요금제를 게시한 후에는 종료일이 아직 설정되지 않은 경우에만 수정할 수 있습니다.
  4. 다음 중 하나를 클릭합니다.
    버튼 설명
    초안 업데이트 (요금제 초안) 요금제를 초안으로 저장합니다.

    요금제를 게시하기 전에는 앱 개발자에게 요금제가 표시되지 않습니다. 임시 요금제의 모든 필드를 수정할 수 있습니다.
    초안 게시 (요금제 초안) 요금제를 게시합니다.

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

    참고: 게시된 요금제에 종료일이 설정된 후에는 더 이상 수정할 수 없습니다.

임시 요금제 삭제

더 이상 필요하지 않은 임시 요금제 요금제를 삭제합니다.

참고: 게시된 요금제는 삭제할 수 없습니다.

임시 요금제를 삭제하려면 다음 단계를 따르세요.

  1. 요금제 페이지에 액세스합니다.
  2. 커서를 올려놓으세요. 삭제할 요금제를 선택하여 작업 메뉴를 표시합니다.
  3. 아이콘을 클릭합니다.
  4. 삭제를 클릭하여 작업을 확인합니다.

API를 사용하여 요금제 관리

다음 섹션에서는 API를 사용하여 요금제를 관리하는 방법을 설명합니다.

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

요금제를 만들려면 POST 요청을 발행하세요. /organizations/{org_name}/monetization-packages/{monetizationpackage_id}/rate-plans, 여기서 {monetizationpackage_id}는 생성할 API 제품 번들의 ID입니다. API 제품 번들을 만들 때 응답에 ID가 반환됩니다.

요금제를 만들 때 요청 본문에 다음을 지정해야 합니다.

  • 조직 ID
  • API 제품 번들 ID
  • 요금제 이름
  • 요금제 설명
  • 요금제의 범위 (모든 개발자에게 적용되는지 아니면 특정 사용자에게만 적용되는지 여부) 개발자, 회사 또는 개발자 카테고리)
  • 요금제가 적용되는 날짜
  • 요금제의 통화
  • 요금제 게시 여부
  • 요금제의 공개 또는 비공개 여부

결제 기간 등 선택적으로 지정할 수 있는 기타 설정도 있습니다. 30일). 요금제의 구성 속성을 참조하세요.

요금제 (요금 전용 요금제 제외)를 만드는 경우 제품 번들의 특정 제품에 요금제를 적용할 수 있습니다. 다음을 수행합니다. 요청에서 제품을 식별합니다. 제품을 식별하지 않으면 요금제가 API 제품 번들의 모든 제품에 적용됩니다.

다음 섹션에서는 요금제를 만드는 방법을 설명합니다.

API를 사용하여 표준 요금제 만들기

표준 요금제를 만들려면 type 속성을 STANDARD(으)로 설정하세요. 다음 예와 같이 됩니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Simple rate plan",
     "currency": {
      "id" : "usd"
     },
     "description": "Simple rate plan",
     "displayName" : "Simple rate plan",
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "published": true,
     "isPrivate" : false,
     "ratePlanDetails": [
     {
      …
     }
     ],
     "startDate": "2013-09-15",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location_package/rate-plans" \
-u email:password

API를 사용하여 개발자 또는 회사 요금제 만들기

특정 개발자 또는 회사에 요금제를 적용하려면 type 값을 다음으로 설정하세요. Developer입니다. 또한 요청에서 개발자나 회사를 명시해야 합니다. ID, 법적 이름, 회사 개발자의 이름

예를 들어 다음 발췌 부분은 Dev Five의 요금제를 만듭니다. 개발자:

...
     "type": "DEVELOPER",
       "developer" : {
        "id" : "0mkKu1PALUGfjUph",
        "legalName" : "DEV FIVE",
        "name" : "Dev Five"
      }
...

API를 사용하여 개발자 카테고리 요금제 만들기

개발자 카테고리에 요금제를 적용하려면 type 값을 다음으로 설정하세요. Developer_Category입니다. 요청에서 개발자 카테고리도 지정해야 합니다. 예를 들면 다음과 같습니다.

...
     "type": "DEVELOPER_CATEGORY",
       "developerCategory" : {
        "id" : "5e172299-8232-45f9-ac46-40076139f373",
        "name" : "Silver",
        "description" : "Silver category"
      }
...

API를 사용하여 API 제품별 요금제 만들기

여러 API 제품이 포함된 API 제품 번들의 요금제를 만들 때 API 제품의 요금제 세부정보를 개별적으로 지정할 수 있습니다.

예를 들어 다음 예에서는 두 개의 API 제품이 포함된 수익 공유 계획을 만듭니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Multi-product rate plan",
     "currency": {
      "id" : "usd"
     },
     "description": "Multi-product rate plan",
     "displayName" : "Multi-product rate plan",
     "monetizationPackage": {
      "id": "mypackage",
      ...
     },
     "organization": {
      "id": "{org_name}",
      ...
     },
     "published": true,
     "isPrivate" : false,
     "ratePlanDetails": [
     {
        "ratePlanRates":[{
            "revshare":0,
            "startUnit":0,
            "type":"REVSHARE",
            "endUnit":null
        }],
       "revenueType":"NET",
       "type":"REVSHARE"
       "currency":{...},
       "product":{"id":"product1","displayName":"Product1"},
       "customPaymentTerm":false
     },
     {
        "ratePlanRates":[{
            "revshare":10,
            "startUnit":0,
            "type":"REVSHARE",
            "endUnit":null
        }],
       "revenueType":"NET",
       "type":"REVSHARE"
       "currency":{...},
       "product":{"id":"product2","displayName":"Product2"},
       "customPaymentTerm":false
     }
     ],
     "startDate": "2019-09-15",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/my-package/rate-plans" \
-u email:password

API 제품을 my-package API 제품 번들에 추가하려면 다음을 추가해야 합니다. API 제품별 요금제를 사용하여 API 제품 번들에 API 제품 추가에 설명된 대로 요청 본문에 API 제품의 요금제 세부정보.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "ratePlan": [
    {
        "id": "my-package_multi-product-rate-plan",
        "ratePlanDetails": [
        {
            "ratePlanRates":[{
                "revshare":20,
                "startUnit":0,
                "type":"REVSHARE",
                "endUnit":null
             }],
             "revenueType":"NET",
             "type":"REVSHARE"
             "currency":{...},
             "customPaymentTerm":false
         }]
    }]
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/my-package/products/product3" \
-u email:password

API를 사용하여 요금제를 공개 또는 비공개로 설정

요금제를 만들 때 isPrivate 속성을 포함해야 합니다. true로 설정하면 요금제가 비공개로 설정됩니다. 자세한 내용은 공개를 참조하세요. 개인 요금제 대비

예를 들어 다음은 특별 요금제를 만듭니다.

$ curl -H "Content-Type:application/json" -X POST -d \
'{
     "name": "Simple rate plan",
     "currency": {
      "id" : "usd"
     },
     "description": "Simple rate plan",
     "displayName" : "Simple rate plan",
     "monetizationPackage": {
      "id": "location"
     },
     "organization": {
      "id": "{org_name}"
     },
     "published": true,
     "isPrivate" : true,
     "ratePlanDetails": [
     {
      …
     }
     ],
     "startDate": "2013-09-15",
     "type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location_package/rate-plans" \
-u email:password
드림