Buat paket tarif mendatang

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Pengantar

Setelah paket tarif yang ada dipublikasikan, satu-satunya properti yang dapat Anda ubah adalah tanggal berakhirnya. Namun, Anda dapat membuat versi baru paket yang mencakup properti yang diubah, seperti tarif paket yang diubah. Anda dapat menyiapkan revisi agar berlaku pada tanggal mendatang. Paket tarif asli berakhir saat revisi berlaku.

Misalnya, Anda membuat paket tarif standar yang berakhir pada 31 Desember 2019 dan ingin menggantinya dengan paket lain yang berlaku pada 1 Januari 2020. Untuk melakukannya, Anda membuat paket tarif mendatang dan menyiapkannya agar berlaku mulai 1 Januari 2020.

Jika tidak ada tanggal akhir yang ditetapkan untuk paket tarif saat ini, Anda dapat mengganti paket tarif yang ada dengan paket tarif mendatang yang dimulai paling cepat hari ini. Anda harus mengakhiri paket tarif saat ini, seperti yang dijelaskan dalam Mengakhiri paket tarif yang dipublikasikan.

Developer akan diberi tahu tentang paket tarif yang direvisi. Developer yang menyetujui paket tarif asli akan otomatis terdaftar untuk revisi (tetapi memiliki opsi untuk menolak revisi).

Anda dapat membuat paket tarif mendatang menggunakan UI pengelolaan atau Monetization API, seperti yang dijelaskan di bagian berikut.

Membuat paket tarif mendatang menggunakan UI

Buat paket tarif mendatang, seperti yang dijelaskan di bawah.

Edge

Untuk membuat versi mendatang paket tarif yang dimulai beberapa waktu setelah hari ini menggunakan UI Edge, lakukan langkah-langkah berikut.

  1. Di halaman Paket Tarif, posisikan kursor Anda dalam baris yang terkait dengan paket tarif yang ingin Anda buat paket tarif mendatangnya.
    Paket tarif harus memiliki tanggal berakhir.
  2. Klik +Future.
  3. Di bagian Paket tarif mendatang, pilih salah satu opsi berikut:
    • Mulai ulang periode kontrak penuh pada tanggal mulai berlaku baru: Paket tarif mendatang akan berlaku pada tanggal mulai berlaku. Masa perpanjangan paket tarif mendatang sama dengan paket tarif saat ini.
    • Kurangi waktu yang dihabiskan untuk kontrak sebelumnya dari periode baru, pada tanggal mulai berlaku: Paket tarif masa depan akan berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk menggunakan paket tarif saat ini dikurangi dari jangka waktu perpanjangan paket tarif mendatang. Artinya, jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangan dikurangi 3 bulan.
  4. Konfigurasi kolom berikut di panel atas:
    Catatan: Kolom lainnya bersifat hanya baca.
    Kolom Deskripsi Default Wajib
    Nama paket tarif

    Nama paket tarif Anda.

    Catatan: Nama tidak harus sama dengan nama paket tarif asli.

    		 Nama paket yang ada Ya
    Tanggal mulai Tanggal mulai berlakunya paket tarif. Masukkan tanggal mulai atau pilih tanggal menggunakan kalender. Hari ini Tidak
    Tanggal akhir Tanggal berakhirnya paket tarif. Untuk menentukan tanggal akhir, aktifkan tombol Memiliki Tanggal Akhir,lalu masukkan tanggal akhir atau pilih tanggal menggunakan kalender.

    Catatan: Paket tarif akan berlaku hingga akhir hari pada tanggal yang ditentukan. Misalnya, jika Anda ingin mengakhiri paket tarif pada 1 Desember 2018, Anda harus menetapkan nilai endDate ke 2018-11-30. Dalam hal ini, paket tarif akan berakhir pada akhir hari 30 November 2018; semua permintaan pada 1 Desember 2018 akan diblokir.

    		Tidak ada Tidak
    Dapat dilihat oleh portal Tetapkan apakah paket tarif bersifat Publik atau Pribadi. Lihat Paket tarif publik vs. tarif khusus. Aktif Tidak
  5. Konfigurasi biaya untuk paket tarif. Lihat Mengonfigurasi biaya.
    Catatan: Tidak berlaku untuk paket notifikasi yang dapat disesuaikan.
  6. Jika Anda memilih paket produk yang berisi lebih dari satu produk API, tetapkan preferensi berikut di bagian Paket tarif spesifik atau generik:
    Catatan: Langkah ini tidak berlaku untuk paket notifikasi yang dapat disesuaikan.
    Kolom Deskripsi Default
    Konfigurasi setiap produk satu per satu Flag yang menentukan apakah akan mengonfigurasi paket tarif individual untuk setiap produk API. Nonaktif
    Konfigurasi penawaran freemium setiap produk secara terpisah Flag yang menentukan apakah akan mengonfigurasi paket freemium untuk setiap produk API. Nonaktif
    Pilih produk Jika Anda mengaktifkan salah satu atau kedua tanda tersebut, Anda harus memilih setiap produk satu per satu dari daftar drop-down dan mengonfigurasi detail paket tarifnya.

    Catatan: Pastikan Anda mengonfigurasi semua produk dalam paket produk.

    		T/A
  7. Konfigurasi detail paket tarif, berdasarkan jenis paket tarif yang dipilih:
  8. Klik salah satu opsi berikut:
    Tombol Deskripsi
    Memperbarui Draf Simpan paket tarif sebagai draf.

    Paket tarif tidak akan terlihat oleh developer aplikasi hingga Anda memublikasikannya. Anda dapat mengedit kolom apa pun dalam draf paket tarif.

    Publikasikan Draf Publikasikan rencana.

    Catatan: Setelah memublikasikan paket tarif, Anda hanya dapat mengubah tanggal akhir jika belum ditetapkan. Anda tidak dapat menghapus paket tarif setelah dipublikasikan, tetapi Anda dapat mengakhiri masa berlaku paket tarif dan menggantinya dengan paket tarif mendatang, seperti yang dijelaskan dalam Mengakhiri masa berlaku paket tarif yang dipublikasikan.

Classic Edge (Private Cloud)

Untuk membuat versi mendatang paket tarif yang dimulai beberapa waktu setelah hari ini menggunakan UI Edge Klasik, lakukan langkah-langkah berikut.

  1. Di katalog paket, klik +Masa depan di kolom Draf/Masa depan untuk paket tarif yang ingin Anda ganti.

    Tindakan ini akan membuka jendela Paket Tarif mendatang.

    Perbedaan utama antara periode paket tarif mendatang dan periode paket tarif saat ini adalah penambahan bagian Pelanggan Lama.

  2. Seperti yang Anda lakukan untuk paket tarif lainnya:
  3. Di bagian Subscriber Lama, pilih salah satu opsi berikut:
    • Mulai ulang periode kontrak penuh pada tanggal mulai berlaku yang baru. Paket tarif mendatang akan berlaku pada tanggal mulai berlaku. Masa perpanjangan paket tarif mendatang sama dengan paket tarif saat ini.
    • Kurangi waktu yang dihabiskan untuk kontrak sebelumnya dari periode baru, pada tanggal mulai berlaku. Paket tarif masa depan akan berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk menggunakan paket tarif saat ini dikurangi dari jangka waktu perpanjangan paket tarif mendatang. Artinya, jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangan dikurangi 3 bulan.
  4. Di kolom Tanggal Mulai Berlaku, masukkan tanggal mulai yang jatuh setelah tanggal akhir paket tarif yang ada.

Membuat paket tarif mendatang menggunakan API

Anda dapat membuat paket tarif mendatang menggunakan API dengan mengirimkan permintaan POST ke /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision.

Dengan:

  • {org_id} adalah nama organisasi.
  • {package_id} adalah identifikasi paket API.
  • {plan_Id} adalah identifikasi paket tarif.
Saat membuat revisi, Anda harus menentukan properti berikut dalam isi permintaan:
  • parentRatePlan menentukan ID paket tarif asli.
  • startDate menentukan tanggal berlakunya paket baru.

Nama paket tarif mendatang tidak boleh sama dengan nama paket asli. Selain itu, kode tersebut harus unik di antara semua paket tarif Anda. Jika Anda ingin mempertahankan tanggal mulai asli yang dicatat untuk developer, tetapkan tanda keepOriginalStartDate ke true. Flag ini secara default adalah false.

Untuk mengetahui informasi selengkapnya tentang setelan konfigurasi, lihat Setelan konfigurasi untuk paket tarif.

Misalnya, permintaan berikut membuat paket tarif mendatang:

$ 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