Mengelola paket tarif untuk produk API

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Dengan paket tarif, pemilik produk API dapat memonetisasi produk API dengan mengonfigurasi hal berikut:

  • Model akun penagihan
  • Mata uang yang digunakan untuk penagihan
  • Frekuensi penagihan kepada pelanggan (hanya bulanan)
  • Biaya penyiapan awal untuk menggunakan produk API
  • Tagihan berbasis pemakaian untuk menggunakan produk API
  • Biaya berulang yang tidak didasarkan pada konsumsi, seperti biaya bulanan untuk akses ke produk API Anda
  • Interval waktu saat paket tarif berlaku untuk produk API (waktu aktivasi paket tarif dan waktu habis masa berlakunya)
  • Pembagian keuntungan dengan partner developer

Kelola paket tarif untuk produk API seperti yang dijelaskan di bagian berikut.

Melihat paket tarif

Lihat paket tarif di organisasi Anda seperti yang dijelaskan di bagian berikut.

UI Apigee

Lihat paket tarif menggunakan UI seperti yang dijelaskan di bagian berikut:

Melihat paket tarif yang ditentukan untuk organisasi Anda

Lihat paket tarif yang ditentukan untuk organisasi Anda di halaman Paket tarif.

Untuk mengakses halaman Paket tarif:

  1. Login ke UI Apigee.
  2. Pilih Publikasikan> Monetisasi> Paket Tarif di menu navigasi samping.

Halaman Paket Tarif akan terbuka dan mencantumkan paket tarif saat ini.

Daftar paket tarif yang menampilkan nama paket tarif, produk API, serta waktu aktivasi dan habis masa berlaku untuk setiap paket, serta drop-down yang dapat digunakan untuk mengelola paket tarif

Seperti yang dijelaskan pada gambar sebelumnya, halaman Paket Tarif memungkinkan Anda:

Melihat paket tarif yang terkait dengan produk API

Saat mengelola produk API, Anda dapat melihat dan mengelola paket tarif yang terkait dengan produk API, seperti yang ditunjukkan pada gambar berikut.

Halaman Produk API dengan bagian Paket tarif yang ditandai

API Apigee

Bagian berikut menjelaskan cara melihat paket tarif untuk organisasi yang menggunakan API:

Mencantumkan paket tarif untuk produk API menggunakan API

Untuk mencantumkan paket tarif untuk organisasi, berikan permintaan GET ke API berikut: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans

Misalnya menggunakan curl:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans?expand=true" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk deskripsi tentang variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Berikut ini contoh output respons, termasuk dua paket tarif, myrateplan1 dan myrateplan2 yang terkait dengan produk API HelloworldProduct:

{
    "ratePlans": [
        {
            "name": "6b51b501-ac15-41b7-bb3e-621edb849e13",
            "apiproduct": "HelloworldProduct",
            "displayName": "myrateplan2",
            "billingPeriod": "MONTHLY",
            "currencyCode": "USD",
            "setupFee": {
                "currencyCode": "USD",
                "units": "20"
            },
            "fixedRecurringFee": {
                "currencyCode": "USD",
                "units": "25"
            },
            "fixedFeeFrequency": 1,
            "consumptionPricingType": "FIXED_PER_UNIT",
            "consumptionPricingRates": [
                {
                    "fee": {
                        "currencyCode": "USD",
                        "nanos": 500000000
                    }
                }
            ],
            "revenueShareType": "FIXED",
            "revenueShareRates": [
                {
                    "sharePercentage": 2
                }
            ],
            "state": "DRAFT"
        },
        {
            "name": "8c0b527c-ba2f-45f1-ac1c-b9e891546fc2",
            "apiproduct": "HelloworldProduct",
            "displayName": "myrateplan1",
            "billingPeriod": "MONTHLY",
            "currencyCode": "USD",
            "consumptionPricingType": "FIXED_PER_UNIT",
            "consumptionPricingRates": [
                {
                    "fee": {
                        "currencyCode": "USD",
                        "units": "3"
                    }
                }
            ],
            "state": "PUBLISHED",
            "startTime": "1617302588000"
        }
    ]
}

Untuk mengetahui informasi selengkapnya tentang API dan payload responsnya, lihat List rate plans API

Melihat detail untuk paket tarif menggunakan API

Untuk melihat detail paket tarif, kirimkan permintaan GET ke API berikut: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME

Untuk menentukan nama paket tarif yang akan diteruskan di jalur resource, lihat Mencantumkan paket tarif di organisasi.

Misalnya menggunakan curl:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk deskripsi tentang variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Berikut adalah contoh output respons untuk paket tarif dengan nama 6b51b501-ac15-41b7-bb3e-621edb849e13 dan nama tampilan myrateplan2:

{
    "name": "6b51b501-ac15-41b7-bb3e-621edb849e13",
    "apiproduct": "HelloworldProduct",
    "displayName": "myrateplan2",
    "billingPeriod": "MONTHLY",
    "currencyCode": "USD",
    "setupFee": {
        "currencyCode": "USD",
        "units": "20"
    },
    "fixedRecurringFee": {
        "currencyCode": "USD",
        "units": "25"
    },
    "fixedFeeFrequency": 1,
    "consumptionPricingType": "FIXED_PER_UNIT",
    "consumptionPricingRates": [
        {
            "fee": {
                "currencyCode": "USD",
                "nanos": 500000000
            }
        }
    ],
    "revenueShareType": "FIXED",
    "revenueShareRates": [
        {
            "sharePercentage": 2
        }
    ],
    "state": "DRAFT"
}

Untuk mengetahui informasi selengkapnya tentang API dan payload responsnya, lihat Mendapatkan API paket tarif.

Membuat paket tarif

Buat paket tarif seperti yang dijelaskan di bagian berikut.

UI Apigee

Untuk membuat paket tarif menggunakan UI:

  1. Lakukan salah satu tugas berikut:
    • Pilih Publikasikan> Monetisasi> Paket Tarif di menu navigasi samping, lalu klik Buat paket tarif.
    • Edit produk API lalu klik Tombol Tambahkan di bagian Paket tarif.
  2. Masukkan Detail paket tarif, sebagai berikut:
    Kolom Deskripsi
    Nama paket tarif Masukkan nama paket tarif.
    Produk API Pilih produk API yang paket tarifnya ingin Anda kaitkan dari drop-down.
  3. Klik Next.
  4. Masukkan detail Penagihan, sebagai berikut:
    Kolom Deskripsi Default
    Mata uang penagihan Pilih mata uang yang akan digunakan untuk penagihan dari drop-down. USD
    Periode penagihan Pilih frekuensi untuk ditagih kepada pelanggan dari menu drop-down. Bulanan
    Model pendanaan pembayaran Pilih model pembayaran yang digunakan untuk akun pendanaan. Postpaid adalah satu-satunya opsi yang valid dalam rilis ini. Pascabayar
    Biaya inisialisasi

    Biaya satu kali yang ditagihkan kepada setiap developer pada tanggal mulai paket tarif (yaitu, tanggal developer membeli produk API).

    Jika Anda ingin menagih biaya penyiapan, pilih Bayar biaya penyiapan dan masukkan jumlah yang akan ditagih pada kolom Biaya inisialisasi.

    Nonaktif
  5. Klik Next.
  6. Masukkan detail Pricing sebagai berikut.
    Kolom Deskripsi Default
    Biaya berulang tetap Aktifkan biaya berulang tetap per unit:
    1. Pilih Tagih biaya berulang tetap.
    2. Konfigurasikan jumlah Biaya berulang tetap dan Frekuensi biaya.

    Biaya akan dihitung secara prorata untuk periode penagihan pertama.

    Jika diaktifkan, Anda dapat melihat pratinjau dampak biaya berulang tetap terhadap tagihan per item dan total, seperti yang dijelaskan di Melihat pratinjau paket tarif.

    Untuk menonaktifkan biaya ini, batalkan pilihan Tagih biaya berulang tetap.

    Nonaktif
    Biaya berbasis pemakaian Aktifkan harga berdasarkan konsumsi:
    1. Pilih Tagih biaya berbasis konsumsi.
    2. Pilih salah satu opsi berikut:
      • Biaya tetap per unit (biaya tetap per unit yang digunakan)
      • Dibanding (biaya variabel per unit yang dikonsumsi, ditentukan oleh rentang konsumsi)
    • Biaya tetap per unit: Biaya tetap ditagih untuk setiap transaksi yang dimonetisasi. Masukkan nilai pada kolom Biaya tetap per unit yang harus ditagih untuk setiap transaksi.

    • Banded: Biaya variabel dikenakan untuk setiap transaksi yang dimonetisasi. Band transaksi dan konsumsi menentukan biaya transaksi. Band mengacu pada rentang konsumsi API, dan setiap band memiliki biaya yang berbeda. Di bagian Ranges of unit consumption, Anda dapat menentukan rentang band dan biaya yang sesuai untuk band tersebut. Anda dapat menentukan sebanyak mungkin band yang diinginkan dengan mengklik + BAND.

      Contoh: Pertimbangkan untuk menagih 1.000 panggilan API pertama sebesar USD 2 per panggilan dan semua panggilan API berikutnya sebesar USD 1 per panggilan. Untuk mengonfigurasinya, tentukan dua band berikut di bagian Ranges of unit consumption:

      • Di baris pertama, masukkan nilai berikut:
        • Mulai: 0
        • Akhir: 1000
        • Biaya: 2
      • Di baris kedua, masukkan nilai berikut:
        • Mulai: 1001
        • Akhir: unit tak terbatas
        • Biaya: 1

      Dalam contoh ini, jika developer menggunakan 1.500 API, total biayanya adalah USD 2.500 ((1000 * 2) + (500 * 1)).

    Jika mengaktifkan biaya berbasis konsumsi, Anda dapat melihat pratinjau efek jenis biaya yang dipilih terhadap keseluruhan pendapatan seperti yang dijelaskan dalam Melihat pratinjau paket tarif.

    Untuk menonaktifkan biaya ini, batalkan pilihan Tetapkan model penetapan harga berbasis konsumsi.

    Jika Anda telah mengonfigurasi variabel monetisasi perUnitPriceMultiplier dalam kebijakan DataCapture, biaya per transaksi yang ditentukan dalam jenis biaya apa pun (Biaya tetap per unit atau Banded) dari biaya berbasis konsumsi dikalikan dengan nilai perUnitPriceMultiplier.

    Nonaktif
  7. Klik Next.
  8. Masukkan detail Pembagian keuntungan, sebagai berikut:
    Kolom Deskripsi Default
    Pembagian keuntungan Aktifkan pembagian keuntungan untuk berbagi persentase pendapatan dengan partner developer.
    1. Pilih Aktifkan pembagian keuntungan.
    2. Masukkan persentase pendapatan yang akan dibagikan di kolom Persentase (%) pendapatan yang akan dibagikan kepada developer.

    Anda dapat memperoleh bagi hasil untuk setiap transaksi yang dimonetisasi dengan mengonfigurasi variabel monetisasi revShareGrossPrice dalam kebijakan DataCapture Anda. Untuk informasi selengkapnya, lihat Variabel monetisasi.

    Jika mengaktifkan pembagian keuntungan, Anda dapat melihat pratinjau efek dari nilai Persentase (%) yang dimasukkan pada tagihan per item dan total, seperti yang dijelaskan dalam Melihat pratinjau paket tarif.

    Untuk menonaktifkan biaya ini, batalkan pilihan Aktifkan pembagian keuntungan.

    Nonaktif
  9. Klik Next.
  10. Klik salah satu opsi berikut:
    • Simpan dan publikasikan untuk menyimpan dan memublikasikan paket tarif. Anda akan diminta untuk memasukkan tanggal aktivasi. Untuk mengetahui informasi selengkapnya, lihat Menetapkan tanggal aktivasi paket tarif.
    • Simpan untuk menyimpan draf paket tarif.
    • Batal untuk membatalkan.

API Apigee

Untuk membuat paket tarif, kirimkan permintaan POST ke API berikut: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans

Konfigurasikan paket tarif dengan meneruskan kolom wajib diisi dalam isi permintaan, seperti yang dijelaskan di Resource: RatePlans.

Tabel berikut merangkum kolom yang wajib diisi saat membuat draf dan rencana tarif yang dipublikasikan.

Kolom wajib diisi untuk draf rencana tarif Kolom wajib untuk paket tarif yang dipublikasikan
  • apiproduct
  • displayName
  • state
  • apiproduct
  • billingPeriod
  • currencyCode
  • displayName
  • paymentFundingModel (Hanya diperlukan untuk Apigee Hybrid 1.5)
  • startTime
  • state

Misalnya, panggilan API berikut akan membuat draf rencana tarif bernama myrateplan5 yang terkait dengan produk API HelloworldProduct:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/HelloworldProduct/rateplans" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "apiproduct":"HelloworldProduct",
    "billingPeriod":"MONTHLY",
    "consumptionPricingType":"FIXED_PER_UNIT",
    "consumptionPricingRates":[{
       "fee":{
          "units":"3",
          "nanos":0
        }
    }],
    "currencyCode":"USD",
    "displayName":"myrateplan5",
    "revenueShareType":"FIXED",
    "revenueShareRates":[{
       "sharePercentage":"1"
    }],
    "setupFee":{
       "units":"10",
       "nanos":0
     },
	 "state":"DRAFT"
    }'

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk deskripsi tentang variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Berikut ini contoh output respons:

{
    "name": "4403a3a5-b366-44f0-aa4d-bd54dcfd3239",
    "apiproduct": "HelloworldProduct",
    "displayName": "myrateplan5",
    "billingPeriod": "MONTHLY",
    "currencyCode": "USD",
    "setupFee": {
        "currencyCode": "USD",
        "units": "10"
    },
    "consumptionPricingType": "FIXED_PER_UNIT",
    "consumptionPricingRates": [
        {
            "fee": {
                "currencyCode": "USD",
                "units": "3"
            }
        }
    ],
    "revenueShareType": "FIXED",
    "revenueShareRates": [
        {
            "sharePercentage": 1
        }
    ],
    "state": "DRAFT"
}

Untuk informasi selengkapnya, lihat Membuat API paket tarif

Melihat pratinjau paket tarif di UI

Berdasarkan konfigurasi pricing dan pembagian keuntungan, Anda dapat melihat pratinjau tagihan per item dan total yang ditagih di bagian Pratinjau paket tarif pada halaman Paket tarif, seperti yang ditampilkan dalam gambar berikut.

Masukkan nilai contoh untuk melihat hasil di pratinjau paket tarif

Perbarui kolom API unit konsumsi di bagian Contoh data konsumen untuk mengubah estimasi dalam pratinjau. Tagihan per item dan jumlah total akan diperbarui berdasarkan input Anda.

Perbarui kolom berikut di bagian Contoh data konsumen:

  • Konsumsi unit API
    Jika Tetapkan biaya berbasis konsumsi dipilih di bagian Harga.
  • Pendapatan
    Jika opsi Aktifkan pembagian keuntungan dipilih di bagian Pembagian keuntungan.

Menetapkan waktu aktivasi dan waktu habis masa berlaku untuk paket tarif

Tetapkan waktu aktivasi dan habis masa berlaku untuk paket tarif guna menunjukkan kapan paket tarif yang dipublikasikan aktif dan bahwa produk API terkait tersedia bagi developer untuk digunakan dalam aplikasi mereka.

Pertimbangkan hal berikut saat menetapkan waktu aktivasi dan habis masa berlaku:

  • Hanya satu paket tarif yang dapat aktif untuk produk API pada waktu tertentu.
  • Anda dapat memublikasikan beberapa paket tarif untuk produk API yang sama dengan waktu aktivasi dan waktu habis masa berlaku yang tidak tumpang-tindih.
  • Anda harus menetapkan waktu aktivasi paket tarif sebelum paket tersebut dapat dipublikasikan.
    Saat memublikasikan paket tarif menggunakan UI, Anda akan diminta untuk menetapkan waktu aktivasi jika tidak disetel.
  • Waktu aktivasi harus terjadi sebelum waktu habis masa berlaku (jika ditetapkan), dan waktu habis masa berlaku harus terjadi setelah waktu aktivasi.
  • Waktu habis masa berlaku tidak wajib diisi. Jika tidak ditentukan, masa berlaku akan ditetapkan secara default ke Never (paket tarif tidak akan pernah berakhir masa berlakunya).
  • Saat menetapkan waktu aktivasi dan waktu habis masa berlaku menggunakan UI, Anda hanya dapat menentukan tanggal, bukan waktu (hh:mm:ss:mmm). Nilai waktu untuk aktivasi dan habis masa berlaku ditetapkan secara default ke 12:00:00:000 AM dan 11:59:59:999 PM.

Tetapkan waktu aktivasi dan habis masa berlaku untuk paket tarif seperti yang dijelaskan di bagian berikut.

UI Apigee

Untuk menyetel waktu aktivasi untuk paket tarif menggunakan UI:

  1. Akses halaman Paket Tarif.
  2. Klik > Tetapkan aktivasi untuk paket tarif yang waktu aktivasinya ingin Anda tetapkan.
  3. Pilih salah satu opsi berikut:
    • Belum ditentukan untuk membatalkan penetapan waktu aktivasi paket tarif (hanya tersedia untuk draf paket tarif).
    • Segera untuk langsung menetapkan paket tarif sebagai aktif.
    • Pada tanggal yang akan datang untuk memilih tanggal aktifnya paket tarif.
  4. Klik Setel aktivasi.
  5. Publikasikan paket tarif jika belum dipublikasikan agar tersedia bagi developer untuk digunakan di aplikasi mereka.

Untuk menetapkan waktu habis masa berlaku untuk paket tarif menggunakan UI:

  1. Akses halaman Paket Tarif.
  2. Klik > Tetapkan akhir masa berlaku untuk paket tarif yang ingin ditetapkan waktu habis masa berlakunya.
  3. Pilih salah satu opsi berikut:
    • Tidak pernah agar paket tarif tidak pernah berakhir masa berlakunya.
    • Segera untuk langsung menetapkan paket tarif sebagai aktif.
    • Pada tanggal yang akan datang untuk memilih tanggal aktifnya paket tarif.
  4. Klik Tetapkan tanggal habis masa berlaku.

API Apigee

Untuk menetapkan waktu aktivasi atau habis masa berlaku untuk paket tarif menggunakan API:

  1. Lihat detail untuk paket tarif yang ingin diperbarui.
  2. Gunakan respons untuk membuat isi permintaan dan memperbarui kolom berikut:
    • startTime untuk menyetel waktu aktivasi
    • endTime untuk menetapkan waktu habis masa berlaku
  3. Untuk memperbarui paket tarif dengan konfigurasi yang baru, berikan permintaan PUT ke API berikut, dengan meneruskan isi permintaan yang diubah dalam permintaan Anda: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME

Misalnya, kode berikut menetapkan waktu aktivasi ke 1 April 2021 (waktu epoch 1617302588000):

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME" \
  -X PUT \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "apiproduct": "HelloworldProduct",
    "displayName": "myrateplan3",
    "currencyCode":"USD",
    "billingPeriod":"MONTHLY",
    "consumptionPricingType":"FIXED_PER_UNIT",
    "consumptionPricingRates":[{
       "fee":{
          "units":"3",
          "nanos":0
        }
    }],
    "revenueShareType":"FIXED",
    "revenueShareRates":[{
       "sharePercentage":"5"
    }],
    "state":"DRAFT",
    "startTime": 1617302588000
    }'

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk deskripsi tentang variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Untuk informasi selengkapnya tentang kolom yang dapat Anda tentukan dalam isi permintaan, lihat Resource: RatePlans.

Berikut ini contoh output respons:

{
    "name": "cb9f420e-313d-4900-aa4f-e07b2b76918d",
    "apiproduct": "HelloworldProduct",
    "displayName": "myrateplan3",
    "billingPeriod": "MONTHLY",
    "currencyCode": "USD",
    "consumptionPricingType": "FIXED_PER_UNIT",
    "consumptionPricingRates": [
        {
            "fee": {
                "currencyCode": "USD",
                "units": "3"
            }
        }
    ],
    "revenueShareType": "FIXED",
    "revenueShareRates": [
        {
            "sharePercentage": 5
        }
    ],
    "state": "DRAFT",
    "startTime": "1617302588000"
}

Untuk informasi selengkapnya, lihat Memperbarui API paket tarif

Memublikasikan paket tarif

Publikasikan paket tarif seperti yang dijelaskan di bagian berikut.

UI Apigee

Untuk memublikasikan paket tarif menggunakan UI, gunakan salah satu metode berikut:

  • Saat membuat atau memperbarui paket tarif, Anda dapat mengklik Simpan dan Publikasikan untuk menyimpan dan memublikasikan rencana tarif. Anda akan diminta untuk menetapkan tanggal aktivasi.
  • Akses halaman Paket Tarif lalu klik > Publikasikan untuk draf rencana tarif yang ingin dipublikasikan.

    Opsi ini hanya muncul jika Anda telah menetapkan tanggal aktivasi untuk paket tarif draf.

API Apigee

Untuk memublikasikan paket tarif menggunakan API:

  1. Lihat detail untuk paket tarif yang ingin dipublikasikan.
  2. Gunakan respons untuk membuat isi permintaan dan memperbarui kolom berikut:
    • Tetapkan state ke state.
    • Tetapkan startTime ke waktu aktivasi dalam milidetik sejak epoch.
    • Secara opsional, setel endTime ke waktu habis masa berlaku dalam milidetik sejak epoch atau ke Jangan pernah. Jika dihilangkan, waktu habis masa berlaku akan ditetapkan secara default ke Never.
    • Tetapkan kolom lain yang ingin Anda pertahankan.
  3. Untuk memublikasikan paket tarif, kirimkan permintaan PUT ke API berikut, dengan meneruskan isi permintaan yang diubah dalam permintaan Anda: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME

Misalnya, contoh berikut akan mengubah status paket tarif rateplan1 menjadi PUBLISHED dan menetapkan waktu aktivasi ke 1 April 2021, yang ditetapkan sebagai milidetik sejak epoch:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME" \
  -X PUT \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "apiproduct": "HelloworldProduct",
    "displayName": "myrateplan3",
    "currencyCode":"USD",
    "billingPeriod":"MONTHLY",
    "consumptionPricingType":"FIXED_PER_UNIT",
    "consumptionPricingRates":[{
       "fee":{
          "units":"3",
          "nanos":0
        }
    }],
    "revenueShareType":"FIXED",
    "revenueShareRates":[{
       "sharePercentage":"5"
    }],
    "state":"PUBLISHED",
    "startTime": 1617302588000
    }'

Untuk mengetahui informasi selengkapnya tentang kolom yang dapat ditentukan dalam isi permintaan, lihat Resource: RatePlans.

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Untuk mengetahui informasi tentang opsi curl yang digunakan dalam contoh ini, lihat Menggunakan curl. Untuk deskripsi tentang variabel lingkungan yang digunakan, lihat Menetapkan variabel lingkungan untuk permintaan Apigee API.

Berikut ini contoh output respons:

{
    "name": "cb9f420e-313d-4900-aa4f-e07b2b76918d",
    "apiproduct": "HelloworldProduct",
    "displayName": "myrateplan3",
    "billingPeriod": "MONTHLY",
    "currencyCode": "USD",
    "consumptionPricingType": "FIXED_PER_UNIT",
    "consumptionPricingRates": [
        {
            "fee": {
                "currencyCode": "USD",
                "units": "3"
            }
        }
    ],
    "revenueShareType": "FIXED",
    "revenueShareRates": [
        {
            "sharePercentage": 5
        }
    ],
    "state": "PUBLISHED",
    "startTime": "1617302588000"
}

Untuk informasi selengkapnya, lihat Memperbarui API paket tarif

Memindahkan paket tarif yang dipublikasikan ke status draf

Pindahkan paket tarif yang dipublikasikan ke status draf seperti yang dijelaskan di bagian berikut.

UI Apigee

Untuk memindahkan paket tarif yang dipublikasikan ke status draf menggunakan UI:

  1. Akses halaman Paket Tarif.
  2. Pilih > Pindahkan ke draf.

Paket tarif diperbarui dan kolom Status diubah menjadi Draf.

API Apigee

Untuk memindahkan paket tarif yang dipublikasikan ke status draf menggunakan API:

  1. Lihat detail untuk paket tarif yang dipublikasikan yang ingin dipindahkan ke status draf.
  2. Gunakan respons untuk membuat isi permintaan dan memperbarui kolom berikut:
    • Tetapkan state ke state.
    • Tetapkan kolom lain yang ingin Anda pertahankan.
  3. Untuk memindahkan paket tarif yang dipublikasikan ke status draf, berikan permintaan PUT ke API berikut, dengan meneruskan isi permintaan yang diubah dalam permintaan Anda: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME

Misalnya, kode berikut akan mengubah status paket tarif rateplan1 menjadi DRAFT:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME" \
  -X PUT \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "apiproduct": "HelloworldProduct",
    "displayName": "myrateplan3",
    "currencyCode":"USD",
    "billingPeriod":"MONTHLY",
    "consumptionPricingType":"FIXED_PER_UNIT",
    "consumptionPricingRates":[{
       "fee":{
          "units":"3",
          "nanos":0
        }
    }],
    "revenueShareType":"FIXED",
    "revenueShareRates":[{
       "sharePercentage":"5"
    }],
    "state":"DRAFT",
    "startTime": 1617302588000
    }'

Untuk mengetahui informasi selengkapnya tentang kolom yang dapat ditentukan dalam isi permintaan, lihat Resource: RatePlans.

Dengan $TOKEN ditetapkan ke