Tworzenie przyszłych planów stawek

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
Informacje

Wstęp

Po opublikowaniu istniejącego planu stawek możesz zmienić tylko jego datę zakończenia. Możesz jednak utworzyć nową wersję planu ze zmienionymi właściwościami, takimi jak zmienione stawki. Możesz tak skonfigurować wersję, aby wchodziła w życie w przyszłości. Pierwotny abonament kończy się po wejściu w życie nowych zmian.

Załóżmy na przykład, że masz utworzony abonament standardowy, który wygasa 31 grudnia 2019 r. i chcesz go zastąpić innym abonamentem, który zacznie obowiązywać 1 stycznia 2020 r. Aby to zrobić, musisz utworzyć plan dotyczący przyszłych cen i skonfigurować go tak, by zaczął obowiązywać 1 stycznia 2020 r.

Jeśli w bieżącym planie taryfowym nie ustawiono daty zakończenia, możesz zastąpić obecny abonament przyszłym, który zacznie obowiązywać już dzisiaj. Musisz wygasnąć bieżący abonament, zgodnie z opisem w sekcji Wygaśnięcie opublikowanego abonamentu.

Deweloperzy zostaną powiadomieni o zmianie abonamentu. Deweloperzy, którzy zaakceptowali pierwotny plan stawek, są automatycznie rejestrowani w zmianie (ale mają możliwość jej odrzucenia).

Przyszły abonament możesz utworzyć za pomocą interfejsu zarządzania lub interfejsu API monetyzacji w sposób opisany w sekcjach poniżej.

Tworzenie przyszłego abonamentu za pomocą interfejsu

Utwórz plan stawek zgodnie z opisem poniżej.

Edge

Aby w interfejsie Edge utworzyć przyszłą wersję abonamentu, która zacznie obowiązywać po upływie dzisiaj, wykonaj te czynności.

  1. Na stronie Abonamenty umieść kursor w wierszu powiązanym z planem stawek, dla którego chcesz utworzyć przyszły plan stawek.
    Abonament musi mieć datę zakończenia.
  2. Kliknij +Przyszłość.
  3. W sekcji Plan przyszłych stawek wybierz jedną z tych opcji:
    • Wznów pełny okres obowiązywania umowy z nowym datą wejścia w życie: przyszły plan stawek wchodzi w życie z dniem wejścia w życie. Okres odnowienia przyszłego abonamentu jest taki sam jak w bieżącym.
    • Odejmij czas trwania poprzedniej umowy od nowego okresu od daty wejścia w życie: przyszły plan stawek wchodzi w życie z dniem wejścia w życie. Czas korzystania z bieżącego planu stawek jest odejmowany od okresu odnowienia przyszłego planu stawek. Oznacza to, że jeśli deweloper używa bieżącego abonamentu przez 3 miesiące, a okres odnowienia zostanie skrócony o 3 miesiące.
  4. W górnym panelu skonfiguruj te pola:
    Uwaga: pozostałe pola są tylko do odczytu.
    Pole Opis Domyślne Wymagane
    Nazwa planu taryf

    Nazwa planu taryfowego.

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

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

    Uwaga: abonament będzie obowiązywać do końca dnia w określonym dniu. Jeśli chcesz wygasnąć plan ceny np. 1 grudnia 2018 roku, ustaw wartość endDate na 30.11.2018. W takim przypadku abonament wygaśnie pod koniec dnia 30 listopada 2018 roku. Wszystkie żądania wysłane z dnia 1 grudnia 2018 roku zostaną zablokowane.

    Brak Nie
    Widoczne dla portali Określ, czy abonament ma być publiczny czy prywatny. Zobacz Abonamenty publiczne a prywatne. Włączono Nie
  5. Skonfiguruj opłaty na potrzeby planu stawek. Zobacz Konfigurowanie opłat.
    Uwaga: nie dotyczy to dostosowywanych planów powiadomień.
  6. Jeśli wybierzesz pakiet produktów, który zawiera więcej niż 1 usługę API, w sekcji Szczegółowy lub ogólny plan stawek określ te ustawienia:
    Uwaga: tego kroku nie można wykonać w przypadku planowanych powiadomień o dostosowywaniu.
    Pole Opis Domyślne
    Skonfiguruj każdą usługę osobno Flaga określająca, czy należy skonfigurować indywidualny plan stawek dla każdej usługi interfejsu API. Wyłączono
    Konfigurowanie oferty freemium każdej usługi oddzielnie Flaga określająca, czy należy skonfigurować abonament freemium dla każdej usługi API. Wyłączono
    Wybierz produkt Jeśli włączysz jedną lub obie flagi, musisz wybrać każdą usługę z listy i skonfigurować szczegóły jej abonamentu.

    Uwaga: pamiętaj, aby skonfigurować wszystkie produkty w pakiecie.

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

    Abonament nie będzie widoczny dla deweloperów aplikacji, dopóki go nie opublikujesz. W roboczym planie taryf możesz edytować dowolne pole.

    Publikowanie wersji roboczej Opublikuj plan.

    Uwaga: po opublikowaniu planu stawek możesz zmienić datę zakończenia tylko wtedy, gdy nie została jeszcze ustawiona. Nie możesz usunąć abonamentu po jego opublikowaniu, ale możesz go utracić i zastąpić go przyszłym abonamentem zgodnie z opisem w sekcji Wygaśnięcie opublikowanego planu stawek.

Klasyczna wersja Edge (Private Cloud)

Aby w klasycznym interfejsie użytkownika Edge utworzyć przyszłą wersję abonamentu, która zacznie obowiązywać później niż dzisiaj, wykonaj te czynności.

  1. W katalogu pakietów kliknij +Przyszłość w kolumnie „Wersja robocza/przyszła” obok planu stawek, który chcesz zastąpić.

    Otworzy się okno przyszłego abonamentu.

    Główna różnica między oknem przyszłego abonamentu a bieżącym abonamentem polega na dodaniu sekcji obecnych subskrybentów.

  2. Tak jak w przypadku każdego abonamentu:
    • Wpisz nazwę planu w polu Nazwa planu taryf. Nazwa nie musi być taka sama jak nazwa pierwotnego planu stawek.
    • Konfigurowanie opłat w ramach abonamentu (opcjonalnie).
    • Skonfiguruj szczegóły abonamentu na podstawie wybranego typu abonamentu:
    • Określ datę wejścia w życie przyszłego planu (zobacz Publikowanie planów stawek) oraz datę zakończenia (możesz też wybrać „Brak daty zakończenia”, jeśli nie chcesz, aby plan kończył się w określonym dniu). Jeśli w bieżącym abonamencie została ustawiona data zakończenia, data wejścia w życie przyszłego planu powinna być późniejsza niż data zakończenia bieżącego abonamentu.
  3. W sekcji Obecni subskrybenci wybierz jedną z tych opcji:
    • Rozpocznij ponownie pełny okres obowiązywania umowy z nowym dniem wejścia w życie. Przyszły plan stawek wchodzi w życie z datą wejścia w życie. Okres odnowienia przyszłego abonamentu jest taki sam jak w bieżącym.
    • Odlicz czas obowiązywania poprzedniej umowy od nowego okresu z dniem wejścia w życie. Przyszły plan stawek wchodzi w życie z dniem jego wejścia w życie. Czas korzystania z bieżącego planu stawek jest odejmowany od okresu odnowienia przyszłego planu stawek. Oznacza to, że jeśli deweloper używa bieżącego abonamentu przez 3 miesiące, a 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 abonamentu.

Tworzenie przyszłego planu stawek za pomocą interfejsu API

Możesz utworzyć przyszły abonament 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 interfejsu API.
  • {plan_Id} to identyfikator planu stawek.
Podczas tworzenia wersji musisz określić w treści żądania te właściwości:
  • parentRatePlan określa identyfikator pierwotnego planu stawek.
  • startDate określa datę wejścia w życie nowego abonamentu.

Nazwa przyszłego planu stawek nie musi być taka sama jak nazwa pierwotnego planu. Jeśli chcesz zachować pierwotną datę rozpoczęcia zarejestrowaną dla deweloperów, ustaw flagę keepOriginalStartDate na true. Domyślna flaga to false.

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

Na przykład to żądanie powoduje utworzenie przyszłego planu taryfowego:

$ 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