Tworzenie przyszłych planów stawek

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Wprowadzenie

Po opublikowaniu istniejącego planu taryfowego jedyną właściwością, którą możesz zmienić, jest jego data zakończenia. Możesz jednak utworzyć nową wersję planu, która będzie zawierać zmienione właściwości, np. zmienione stawki planu taryfowego. Możesz skonfigurować wejście w życie wersji w przyszłości. Oryginalny plan taryfowy kończy się, gdy wersja wejdzie w życie.

Załóżmy, że masz standardowy plan taryfowy, który wygasa 31 grudnia 2019 r., i chcesz go zastąpić innym planem, który zacznie obowiązywać 1 stycznia 2020 r. Aby to zrobić, utwórz przyszły plan taryfowy i skonfiguruj go tak, aby zaczął obowiązywać 1 stycznia 2020 r.

Jeśli dla bieżącego planu taryfowego nie ustawiono daty zakończenia, możesz zastąpić go przyszłym planem taryfowym, który zacznie obowiązywać najwcześniej dzisiaj. Musisz wygasić bieżący plan taryfowy zgodnie z opisem w sekcji Wygaszanie opublikowanego planu taryfowego.

Deweloperzy są powiadamiani o zmienionym planie taryfowym. Deweloperzy, którzy zaakceptują pierwotny plan taryfowy, zostaną automatycznie zarejestrowani w wersji (ale będą mogli ją odrzucić ).

Przyszły plan taryfowy możesz utworzyć za pomocą interfejsu zarządzania lub interfejsu Monetization API, jak opisano w kolejnych sekcjach.

Tworzenie przyszłego planu taryfowego za pomocą interfejsu

Utwórz przyszły plan taryfowy zgodnie z opisem poniżej.

Edge

Aby utworzyć przyszłą wersję planu taryfowego, która zacznie obowiązywać w przyszłości użyj interfejsu Edge.

  1. Na stronie Plany taryfowe, umieść kursor w wierszu powiązanym z planem taryfowym, dla którego chcesz utworzyć przyszły plan taryfowy.
    Plan taryfowy musi mieć datę zakończenia.
  2. Kliknij +Przyszły.
  3. W sekcji Przyszły plan taryfowy wybierz jedną z tych opcji:
    • Restart full contract period on new effective date (Ponowne rozpoczęcie pełnego okresu obowiązywania umowy w nowej dacie wejścia w życie): przyszły plan taryfowy zacznie obowiązywać w dacie wejścia w życie. Okres odnowienia przyszłego planu taryfowego jest taki sam jak w przypadku bieżącego planu taryfowego.
    • Deduct the time spent on previous contract from new period, on effective date (Odjęcie czasu spędzonego na poprzedniej umowie od nowego okresu w dacie wejścia w życie): The przyszły plan taryfowy zacznie obowiązywać w dacie wejścia w życie. Czas spędzony na korzystaniu z bieżącego planu taryfowego jest odejmowany od okresu odnowienia przyszłego planu taryfowego. Oznacza to, że jeśli deweloper korzysta z bieżącego planu przez 3 miesiące, okres odnowienia zostanie skrócony o 3 miesiące.
  4. W górnym panelu skonfiguruj te pola:
    Uwaga: inne pola są tylko do odczytu.
    Pole Opis Domyślny Wymagane
    Nazwa planu taryfowego

    Nazwa planu taryfowego.

    Uwaga: nazwa nie musi być taka sama jak nazwa pierwotnego planu taryfowego.

    		 Nazwa istniejącego planu Tak
    Data rozpoczęcia Data wejścia w życie planu taryfowego. Wpisz datę rozpoczęcia lub wybierz ją w kalendarzu. Dzisiaj Nie
    Data zakończenia Data zakończenia planu taryfowego. Aby określić datę zakończenia, włącz przełącznik Ma datę zakończenia i wpisz datę zakończenia lub wybierz ją w kalendarzu.

    Uwaga: plan taryfowy będzie obowiązywać do końca dnia w podanej dacie. Jeśli np. chcesz, aby plan taryfowy wygasł 1 grudnia 2018 r., ustaw wartość endDate na 2018-11-30. W takim przypadku plan taryfowy wygaśnie o końcu dnia 30 listopada 2018 r., a wszystkie żądania z 1 grudnia 2018 r. zostaną zablokowane.

    		Brak Nie
    Widoczne dla portali Ustaw, czy plan taryfowy ma być publiczny czy prywatny. Zobacz Różnice między publicznymi a prywatnymi planami taryfowymi. Włączono Nie
  5. Skonfiguruj opłaty za plan taryfowy. Zobacz Konfigurowanie opłat.
    Uwaga: nie dotyczy planów powiadomień z możliwością dostosowania.
  6. Jeśli wybierzesz pakiet produktów, który zawiera więcej niż 1 produkt API, ustaw te preferencje w sekcji Konkretny lub ogólny plan taryfowy:
    Uwaga: ten krok nie dotyczy planów powiadomień z możliwością dostosowania.
    Pole Opis Domyślny
    Skonfiguruj każdy produkt osobno Flaga określająca, czy dla każdego produktu API należy skonfigurować osobny plan taryfowy. Wyłączono
    Skonfiguruj osobno ofertę Freemium dla każdego produktu Flaga określająca, czy dla każdego produktu API należy skonfigurować plan Freemium. Wyłączono
    Wybierz produkt Jeśli włączysz jedną lub obie flagi, musisz wybrać każdy produkt osobno z listy i skonfigurować szczegóły planu taryfowego.

    Uwaga: skonfiguruj wszystkie produkty w pakiecie produktów.

    		Nie dotyczy
  7. Skonfiguruj szczegóły planu taryfowego na podstawie wybranego typu planu taryfowego:
  8. Kliknij jedną z tych opcji:
    Przycisk Opis
    Zaktualizuj wersję roboczą Zapisz plan taryfowy jako wersję roboczą.

    Plan taryfowy nie będzie widoczny dla deweloperów aplikacji, dopóki go nie opublikujesz. Możesz edytować dowolne pole w wersji roboczej planu taryfowego.

    Opublikuj wersję roboczą Opublikuj plan.

    Uwaga: po opublikowaniu planu taryfowego możesz zmienić tylko datę zakończenia, jeśli nie została jeszcze ustawiona. Po opublikowaniu planu taryfowego nie można go usunąć, ale możesz go wygasić i zastąpić przyszłym planem taryfowym zgodnie z opisem w sekcji Wygaszanie opublikowanego planu taryfowego.

Classic Edge (Private Cloud)

Aby utworzyć przyszłą wersję planu taryfowego, która zacznie obowiązywać w przyszłości użyj interfejsu Classic Edge.

  1. W katalogu pakietów w kolumnie Wersja robocza/Przyszły kliknij +Przyszły w przypadku planu taryfowego, który chcesz zastąpić.

    Otworzy się okno Przyszły plan taryfowy.

    Podstawowa różnica między oknem przyszłego planu taryfowego a oknem bieżącego planu taryfowego polega na dodaniu sekcji Obecni subskrybenci.

  2. Tak jak w przypadku każdego planu taryfowego:
    • Wpisz nazwę planu w polu Nazwa planu taryfowego. Nazwa nie musi być taka sama jak nazwa pierwotnego planu taryfowego.
    • Konfigurowanie opłat za plan taryfowy (opcjonalnie).
    • Skonfiguruj szczegóły planu taryfowego na podstawie wybranego typu planu taryfowego:
    • Określ datę wejścia w życie przyszłego planu (patrz Publikowanie planów taryfowych), i datę zakończenia (możesz też wybrać „Brak daty zakończenia”, jeśli nie chcesz, aby przyszły plan taryfowy zakończył się w określonym dniu). Jeśli dla bieżącego planu ustawiono datę zakończenia, data wejścia w życie przyszłego planu powinna przypadać po dacie zakończenia bieżącego planu.
  3. W sekcji Obecni subskrybenci wybierz jedną z tych opcji:
    • Restart full contract period on new effective date. Przyszły plan taryfowy zacznie obowiązywać w dacie wejścia w życie. Okres odnowienia przyszłego planu taryfowego jest taki sam jak w przypadku bieżącego planu taryfowego.
    • Deduct the time spent on previous contract from new period, on effective date. Przyszły plan taryfowy zacznie obowiązywać w dacie wejścia w życie. Czas spędzony na korzystaniu z bieżącego planu taryfowego jest odejmowany od okresu odnowienia przyszłego planu taryfowego. Oznacza to, że jeśli deweloper korzysta z bieżącego planu przez 3 miesiące, okres odnowienia zostanie skrócony o 3 miesiące.
  4. W polu Data wejścia w życie wpisz datę rozpoczęcia, która przypada po dacie zakończenia istniejącego planu taryfowego.

Tworzenie przyszłego planu taryfowego za pomocą interfejsu API

Przyszły plan taryfowy możesz utworzyć za pomocą interfejsu API, wysyłając żądanie POST do /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision.

Gdzie:

  • {org_id} to nazwa organizacji.
  • {package_id} to identyfikator pakietu API.
  • {plan_Id} to identyfikator planu taryfowego.
Podczas tworzenia wersji w treści żądania musisz określić te właściwości:
  • parentRatePlan określa identyfikator pierwotnego planu taryfowego.
  • startDate określa datę wejścia w życie nowego planu.

Nazwa przyszłego planu taryfowego nie może być taka sama jak nazwa pierwotnego planu. Musi też być unikalna wśród wszystkich Twoich planów taryfowych. Jeśli chcesz zachować pierwotną datę rozpoczęcia zarejestrowaną dla deweloperów, ustaw flagę keepOriginalStartDate na true. Domyślnie ta flaga ma wartość false.

Więcej informacji o ustawieniach konfiguracji znajdziesz w artykule Ustawienia konfiguracji planów taryfowych.

Na przykład to żądanie tworzy przyszły plan taryfowy:

$ 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