Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Giriş
Fiyat listesi planında, geliştiriciden her işlem için ücret alınır. Bu tür planlar için şarj modeli ve şarj modelinin fiyatlandırması gibi ek ayrıntılar sağlamanız gerekir.
İsteğe bağlı olarak, tek tek ürünler için (API paketi yerine) freemium planı belirtebilirsiniz. Bunu yalnızca ürüne özel bir plan için yapabilirsiniz.
Yinelenen ücretler ne zaman alınır ve paket planları ne zaman sıfırlanır?
Ücretlendirme planları, yinelenen ücretlerin yanı sıra API paketlerini (hacim bazlı ve paket planları) de içerebilir. Her ikisinde de ücretlerin tahsil edildiği ve paket planlarının sıfırlandığı belirli zamanlar vardır. Aşağıdaki tabloda, yinelenen ücretlerin ne zaman alındığı ve paket sayılarının ne zaman sıfırlandığı açıklanmaktadır. Geliştirici uygulamaları belirli bir işlem sınırına ulaştığı için daha fazla API çağrısı yapması engellenirse API çağrıları sayısının sıfırlandığı ve uygulamaların tekrar çağrı yapmaya başlayabileceği zamanlar şunlardır:
| Planın... | ...bu durum oluşur |
|---|---|
|
Yinelenen ücret ve paket planı sıfırlaması ayın ilk günü gerçekleşir (varsayılan). Belirli bir günde aylık olarak yinelenen bir plan için yönetim API'sini kullanarak bir ücret planı oluşturun ve API'yi kullanarak ücret planları oluşturma bölümünde açıklandığı gibi |
|
Yinelenen ücret ve paket planı sıfırlaması, geliştiricinin ücret planı başlangıç tarihinden 7 gün sonra gerçekleşir. |
|
Yinelenen ücret ve paket planı sıfırlaması, geliştiricinin ücret planı başlangıç tarihinden sonra her X günde bir gerçekleşir. |
|
Paket planları, fiyat listesinde tanımlanan Toplama Temeli'ne göre sıfırlanır. Örneğin, bir geliştirici ayın 19'unda bir ücret planı başlatırsa ve Toplama Temeli her 1 ayda bir ise paket kullanımı her ayın 19'unda sıfırlanır. Ayın gününün her zaman aynı olmayabileceğini unutmayın. Örneğin, bir fiyat planı 31 Aralık'ta başlıyorsa sıfırlama tarihi, Şubat ayında yalnızca 28 gün olduğu için artık 28 Şubat olur (artık yıl olmayan yıllarda). 28'i, sıfırlama günü olarak kalır. |
Kullanıcı arayüzünü kullanarak ücret listesi planlarını yapılandırma
Aşağıda açıklandığı şekilde fiyat listesi planlarını yapılandırın.
Edge
Bir ücret listesi planı yapılandırmak için bir ücret planı oluştururken veya düzenlerken Ücret Listesi ya da Ücret Listesi ve Gelir Paylaşımı ücret planı türünü seçin ve Ücret Listesi bölümünde aşağıdaki ücretlendirme modellerinden birini belirleyin:
| Şarj modeli | Açıklama |
| Sabit Ücret: | Geliştiriciden her işlem için sabit bir ücret alınır. |
| Hacim Bantlı | Geliştiriciden, işlem hacmine bağlı olarak değişken bir oran üzerinden ücret alınır. |
| Paketler | Geliştiriciden her işlem paketi için önceden belirli bir tutar alınır. Geliştiriciden, paket tamamen kullanılsın veya kullanılmasın belirlenen tutar alınır.
Not: Bu seçenek, fiyat listesi ve gelir paylaşımı seçildiğinde kullanılamaz. |
Ardından, seçilen ödeme modeline göre aşağıdaki bilgileri yapılandırın.
| Şarj Modeli | Alan | Açıklama |
| Tümü | Hesaplama sıklığı | İşlem hacminin (veya özel özellikle ilgili hacmin) hesaplandığı dönem. Ay sayısı seçin (1-24 ay). |
| Sabit Ücret: | Sabit ücret | Her işlem için alınan ücret. Ondalık sayı (en fazla dört ondalık basamaklı) girin.
Not: API (kullanıcı arayüzü değil) kullanılarak ücretlendirilen oran için belirtilebilecek ondalık basamak sayısını yapılandırabilirsiniz. Ayrıntılar için Fiyat planı fiyatları için ondalık basamak sayısını yapılandırma başlıklı makaleyi inceleyin. Örneğin, 0, 10 girerseniz ve para birimi ABD doları ise geliştiriciden her işlem için 0, 10 ABD doları ücret alınır (veya bir işlemde iletilen bayt sayısı gibi özel bir özelliğe göre ücretlendirme yapılıyorsa belirtilen bayt sayısının iletilmesi için 0, 10 ABD doları ücret alınır). |
| Hacim Bantlı | Hacim Bantları | Hacim bantlı ücretlendirme modeli için bir veya daha fazla işlem (ya da müşteri özelliğine dayalı) hacim aralığı (her aralık bir "hacim bandı"dır). Her hacim aralığına bir oran atanabilir. Ücret, geçerli hacim aralığındaki tüm işlemler için uygulanır. İlk aralığın üst sınırını belirtin. Örneğin, 1.000'e kadar (alt sınır 0'dan büyük olacak şekilde önceden ayarlanmıştır).
Başka bantlar eklemek için +Yeni'yi tıklayın. Bu seviyenin üzerindeki tüm işlemleri belirtmek için son aralığın üst sınırını boş bırakın. Not: API (kullanıcı arayüzü değil) kullanılarak ücretlendirilen oran için belirtilebilecek ondalık basamak sayısını yapılandırabilirsiniz. Ayrıntılar için Fiyat planı fiyatları için ondalık basamak sayısını yapılandırma başlıklı makaleyi inceleyin. Örneğin, Ses Aralığı bölümünde iki ses aralığı belirtirseniz (>0-1000 ve 1000 ve üzeri), >0-1000 ses aralığı için 0,15, 1000 ve üzeri ses aralığı için 0,10 girebilirsiniz. Seçilen para birimi ABD doları ise ilk 1.000 işlem için işlem başına 0, 15 ABD doları, 1.000'den fazla işlem için ise işlem başına 0, 10 ABD doları ücret alınır. |
| Paketler | API paketi fiyatları | Paketteki işlem sayısı (veya pakette iletilen toplam bayt sayısı gibi özel bir özellikle ilgili sayı). Her pakete bir fiyat atanabilir. Fiyat, paketin tamamı için geçerlidir. İlk paketin üst sınırını belirtin. Örneğin, 1.000'e kadar (alt sınır 0'dan büyük olacak şekilde önceden ayarlanmıştır).
Başka paketler eklemek için +Yeni'yi tıklayın. Son paketteki sınırsız işlemler için geliştiriciden sabit bir tutar almak istemiyorsanız son paketin üst sınırını belirtmeniz gerekir. Not: API (kullanıcı arayüzü değil) kullanılarak ücretlendirilen oran için belirtilebilecek ondalık basamak sayısını yapılandırabilirsiniz. Ayrıntılar için Fiyat planı fiyatları için ondalık basamak sayısını yapılandırma başlıklı makaleyi inceleyin. Örneğin, Paket Boyutu bölümünde iki paket belirtirseniz (0'dan büyük ve 1.000'e kadar, 1.000'den büyük ve 2.000'e kadar), 0'dan büyük ve 1.000'e kadar olan paket için 50, 1.000'den büyük ve 2.000'e kadar olan paket için 40 girebilirsiniz. Seçilen para birimi ABD doları ise ilk paket için fiyat 50 ABD doları, ikinci paket için fiyat 40 ABD dolarıdır. Geliştiriciden, pakette kaç işlem kullandığına bakılmaksızın geçerli paket fiyatı alınır (yani, paketteki ilk işlem tamamlanır tamamlanmaz geliştiriciden paket fiyatı alınır). |
API ürününüz için özel özellikler tanımladıysanız uygulama geliştiriciden her işlemdeki özel bir özelliğe göre ücret almak için özel derecelendirme parametresi yapılandırabilirsiniz. Örneğin, geliştiriciden her işlem için ücret aldığınız bir plan oluşturursanız planın oranını, her işlemde değişebilen arka uçta iletilen bayt sayısı gibi özel bir özelliğe göre belirleyebilirsiniz.
Bu durumda, Özel derecelendirme parametresini kullan'ı seçin ve açılır listeden özel özelliği belirleyin. Daha fazla bilgi için Özel özelliklerle fiyat planı yapılandırma başlıklı makaleyi inceleyin.
Classic Edge (Private Cloud)
Klasik Edge kullanıcı arayüzünü kullanarak ücret tarifesi planlarını yapılandırmak için:
- Fiyat planı oluşturma adımlarını uygulayın.
- Gelir modelini yapılandırmak için Fiyat Planı Türü açılır listesinde Fiyat Listesi'ni seçin.
- Seçilen API paketi birden fazla API ürünü içeriyorsa aşağıdaki seçeneklerden birini belirleyin:
Not: API paketi tek bir API ürünü içeriyorsa bu adımı atlayabilirsiniz.
- Her API ürünü için ayrı ayrı ücret planı ayrıntılarını yapılandırmak üzere ürüne özel planlar.
- Tüm API ürünleri için ücret planı ayrıntılarını yapılandırmak üzere Tüm Ürünler İçin Genel Plan'ı kullanın.
- Genel ücret planı veya her bir API ürününe özel ücret planı için Ücret Tablosu'nu tıklayın.
Not: API ürününe özel planları yapılandırırken her API ürünü için ayrı ayrı bir ücret tarifesi planı yapılandırmanız gerekir.
Fiyat listesi penceresi açılır.
- API ürünü için freemium planı oluşturun. Freemium planı, geliştiricilere bir API ürününü belirli bir süre boyunca veya belirli bir kullanım miktarına kadar ücretsiz olarak kullanma imkanı sunar.
Aşağıdaki bilgileri girin:
Alan Açıklama Freemium Ürün mü? Ücretsiz dönemin kapsamı. Aşağıdaki radyo düğmelerinden birini seçin:
- Miktara göre. Ücretsiz dönem, Volume (Hacim) alanında belirtilen miktara göre belirlenir.
- Süreye göre. Ücret dönemi, Freemium Süresi alanında belirtilen zaman aralığına göre belirlenir.
- Hangisi önce gelirse. Ücretsiz dönem, hangisi önce gerçekleşirse, birim alanındaki miktara veya Freemium Süresi alanındaki zaman aralığına ulaşıldığında sona erer.
- Hayır. Bu, ücretsiz bir plan değildir. Bu, varsayılan seçenektir.
Freemium Volume Geliştiricilerden ücret alınmayan işlemlerin hacmi (veya işlem kayıt politikasına kaydedilen özel bir özellikle ilgili hacim). Hacim, API ürünü için ölçülür. 5000 gibi bir birim numarası girin. Bu nedenle, geliştiriciler planı başlattığında ilk 5.000 işlem (veya özel özelliklerle ilgili öğelerin ilk 5.000 kullanımı) için ücret alınmaz. Bu alan yalnızca "Freemium Ürün?" alanında "Miktara Göre" veya "Hangisi Önce Gelirse" seçeneğini belirlediyseniz etkinleştirilir.
Freemium Süresi Geliştiricilerden ücret alınmadığı zaman aralığı. Bir sayı girin ve bir dönem seçin (ör. 1 Ay). Bu, geliştiricilerden 1 ay boyunca ücret alınmayacağı anlamına gelir. Bu alan yalnızca "Freemium ürün mü?" alanında "Süreye Göre" veya "Hangisi önce gelirse" seçeneğini belirlerseniz etkinleştirilir.
- Aşağıdaki ödeme modellerinden birini seçin:
- Sabit ücret. Bu modelde, geliştiriciden her işlem için sabit bir ücret alınır.
- Hacim Bantlı. Bu modelde, geliştiriciden işlem hacmine bağlı olarak değişken bir ücret alınır.
- Paketler. Bu modelde, geliştiriciden her işlem paketi için sabit bir tutar (peşin) alınır. Geliştiriciden, paket tamamen kullanılsın veya kullanılmasın, belirlenen tutar tahsil edilir.
Sabit ücret modeli için: Genel Fiyat Listesi penceresinin Fiyatlandırma bölümüne aşağıdaki bilgileri girin:
Alan Açıklama Operatör (veya Kuruluş) Kuruluşunuzun adı. Bu alan, kuruluş profilindeki Operatör (veya Kuruluş) alan değeri kullanılarak önceden ayarlanır.
Ülke Kuruluşunuzun faaliyet gösterdiği ülke. Bu alan, kuruluş profilindeki Ülke alanı değeri kullanılarak önceden ayarlanır.
Sabit Ücret: Her işlem için alınan ücret. Ondalık sayı (en fazla dört ondalık basamaklı) girin.
Not: API (kullanıcı arayüzü değil) kullanılarak alınan ücret için belirtilebilecek ondalık basamak sayısını yapılandırabilirsiniz. Ayrıntılar için Fiyat planı fiyatları için ondalık basamak sayısını yapılandırma başlıklı makaleyi inceleyin.
Örneğin, 0, 10 girerseniz ve para birimi ABD doları ise geliştiriciden her işlem için 0, 10 ABD doları ücret alınır (veya bir işlemde iletilen bayt sayısı gibi özel bir özelliğe göre ücretlendirme yapılıyorsa belirtilen bayt sayısının iletilmesi için geliştiriciden 0, 10 ABD doları ücret alınır).
Bantlı hacim modeli için: Genel Ücret Listesi penceresinde, toplama için bir temel belirtmek ve "hacim bantları" (yani farklı oranlar uygulayabileceğiniz işlem hacmi aralıkları) belirtmek için kullandığınız ek alanlar gösterilir.
Bu tür planlar genellikle daha yüksek hacimli bantlar için indirimli fiyatlar sunarak geliştiricileri daha yüksek hacimler oluşturmaya teşvik etmek amacıyla oluşturulur.
Genel Fiyat Listesi penceresine aşağıdaki bilgileri girin:
Alan Açıklama Toplama Temeli İşlem hacminin (veya özel özelliklerle ilgili hacmin) toplandığı süre. Toplanan hacim, hacim aralığını ve her işleme uygulanacak oranı belirlemek için kullanılır. Ay sayısı seçin (1-12 ay).
Paketlerin ne zaman sıfırlandığıyla ilgili ayrıntılar için Yinelenen ücretler ne zaman alınır ve paket planları ne zaman sıfırlanır? başlıklı makaleyi inceleyin.
Hacim Bantları İşlem (veya müşteri özelliğine dayalı) hacminin bir veya daha fazla aralığı (her aralık bir "hacim grubu"dur). Her bir hacim aralığına bir ücret atanabilir (bu ücreti Fiyatlandırma bölümündeki Hacim Aralığı alanında belirlersiniz). Ücret, geçerli hacim aralığındaki tüm işlemler için uygulanır. İlk bandın üst sınırını belirtin. Örneğin, 1.000'e kadar (alt sınır 0'dan büyük olacak şekilde önceden ayarlanmıştır). Örneğin, 1.000 ile 2.000 arasında ikinci bir bant eklemek için + simgesini tıklayın. Daha fazla bant eklemek için + simgesini tıklayın. Bu seviyenin üzerindeki tüm işlemleri belirtmek için son aralığın üst sınırını boş bırakabilirsiniz.
Fiyatlandırma Operatör (veya Kuruluş) Kuruluşunuzun adı. Bu alan, Kuruluş Profilindeki Operatör (veya Kuruluş) alan değeri kullanılarak önceden ayarlanır.
Ülke Kuruluşunuzun faaliyet gösterdiği ülke. Bu alan, kuruluş profilindeki ülke alanı değeri kullanılarak önceden ayarlanır.
Para Birimi Kuruluşunuzun kullandığı "temel" veya muhasebe para birimi. Bu alan, Kuruluş Profili'ndeki Para Birimi alan değeri kullanılarak önceden ayarlanır ancak burada değiştirilebilir.
Hacim Bantları Bir hacim aralığının oranı. Her hacim aralığı için bir oran belirtirsiniz. Her bant için ondalık sayı girin (en fazla dört ondalık basamak).
Not: API'yi (kullanıcı arayüzünü değil) kullanarak hacim aralığı oranı için belirtilebilecek ondalık basamak sayısını yapılandırabilirsiniz. Ayrıntılar için Fiyat planı fiyatları için ondalık basamak sayısını yapılandırma başlıklı makaleyi inceleyin.
Örneğin, Ses Aralığı bölümünde iki ses aralığı belirtirseniz (>0-1000 ve 1000 ve üzeri), >0-1000 ses aralığı için 0,15, 1000 ve üzeri ses aralığı için 0,10 girebilirsiniz. Seçilen para birimi ABD doları ise ilk 1.000 işlem için işlem başına 0, 15 ABD doları, 1.000'den fazla işlem için ise işlem başına 0, 10 ABD doları ücret alınır.
Paket modelinde: Genel fiyat listesi penceresinde, toplama için bir temel belirtmek (geliştiricinin işlem paketini kullanabileceği süre) ve paketle ilgili bilgileri (ör. paket boyutu) belirtmek için kullandığınız ek alanlar gösterilir.
Genel Fiyat Listesi penceresine aşağıdaki bilgileri girin:
Alan Açıklama Toplama Temeli Geliştiricinin işlem paketini kullanabileceği (veya özel bir özelliğe dayalı paket kullanabileceği) süre. Ay sayısı seçin (1-12 ay). Bu süre sona erdiğinde planın geçerliliği sona erer ve geliştiricinin planı (ve paketleri) tekrar satın alması gerekir.
Paketlerin ne zaman sıfırlandığıyla ilgili ayrıntılar için Yinelenen ücretler ne zaman alınır ve paket planları ne zaman sıfırlanır? başlıklı makaleyi inceleyin.
Paket Boyutu Bir paketteki işlem sayısı (veya bir pakette iletilen toplam bayt sayısı gibi özel bir özellikle ilgili sayı). Her pakete bir fiyat atanabilir (bu fiyatı Fiyatlandırma bölümünün Paket Boyutu alanında belirlersiniz). Fiyat, paketin tamamı için geçerlidir. İlk paketin üst sınırını belirtin. Örneğin, 1.000'e kadar (alt sınır 0'dan büyük olacak şekilde önceden ayarlanmıştır). İkinci bir paket eklemek için + işaretini tıklayın (örneğin, 1.000'den büyük ve 2.000'e kadar). Daha fazla paket eklemek için + işaretini tıklayın. Son paketteki sınırsız işlemler için geliştiriciden sabit bir tutar almak istemiyorsanız son paketin üst sınırını belirtmeniz gerekir.
Fiyatlandırma Operatör (veya Kuruluş) Kuruluşunuzun adı. Bu alan, Kuruluş Profilindeki Operatör (veya Kuruluş) alan değeri kullanılarak önceden ayarlanır.
Ülke Kuruluşunuzun faaliyet gösterdiği ülke. Bu alan, kuruluş profilindeki ülke alanı değeri kullanılarak önceden ayarlanır.
Para Birimi Kuruluşunuzun kullandığı "temel" veya muhasebe para birimi. Bu alan, Kuruluş Profili'ndeki Para Birimi alan değeri kullanılarak önceden ayarlanır ancak burada değiştirilebilir.
Paket boyutu (fiyat) Paketin fiyatı. Her paket için bir fiyat belirlersiniz. Ondalık sayı (en fazla dört ondalık basamaklı) girin.
Not: API'yi (kullanıcı arayüzünü değil) kullanarak paket ücreti için belirtilebilecek ondalık basamak sayısını yapılandırabilirsiniz. Ayrıntılar için Fiyat planı fiyatları için ondalık basamak sayısını yapılandırma başlıklı makaleyi inceleyin.
Örneğin, Paket Boyutu bölümünde iki paket belirtirseniz (0'dan büyük, 1.000'e kadar ve 1.000'den büyük, 2.000'e kadar), 0'dan büyük, 1.000'e kadar olan paket için 50, 1.000'den büyük, 2.000'e kadar olan paket için 40 girebilirsiniz. Seçilen para birimi ABD doları ise ilk paket için fiyat 50 ABD doları, ikinci paket için fiyat 40 ABD dolarıdır. Geliştiriciden, pakette kaç işlem kullandığına bakılmaksızın geçerli paket fiyatı alınır (yani, paketteki ilk işlem tamamlanır tamamlanmaz geliştiriciden paket fiyatı alınır).
- Fiyat listesi ayrıntılarını kaydedip Standart Fiyat Planı penceresine dönmek için Uygula ve Kapat'ı tıklayın.
- API ürününe özel ücret planları için ücret planı ayrıntılarını gerektiği gibi ek API ürünleri için yapılandırın.
API'yi kullanarak fiyat listesi planını yapılandırma
Aşağıdaki bölümlerde açıklandığı gibi, API'yi kullanarak fiyat listesi planı ayrıntılarını yapılandırın.
API'yi kullanarak fiyat listesi planı ayrıntılarını belirtme
Ücret planını oluştururken ücret planı ayrıntılarını belirtirsiniz. Ayrıntıları, ratePlanDetails özelliğinde /organizations/{org_name}/monetization-packages/{package_id}/rate-plans çağrısındaki istek gövdesinde belirtirsiniz. ratePlanDetails özelliğinde belirlediğiniz değerler, seçtiğiniz ücretlendirme modeline (sabit ücret, hacim bantlı veya paketler) bağlıdır.
Sabit ücretli bir fiyatlandırma modeli belirtme
Sabit ücretli faturalandırma modelini uygulamak için ücret planı ayrıntılarında aşağıdakileri belirtirsiniz:
- Ücret planının işlemlere (
VOLUME) veya özel bir özelliğe (ör.MINT_CUSTOM_ATTRIBUTE_1) dayalı olduğunu belirten bir derecelendirme parametresi.VOLUMEvarsayılandır. - Ücretin birim başına sabit olduğunu (yani, hacim bantlı veya paketler ücretlendirme modelinde olduğu gibi işlem hacmine dayalı olmadığını) belirten bir ölçüm türü (
UNIT). - Ödeme son tarihi (örneğin, 30 gün).
- Kuruluşunuzun kimliği.
- Şirketinizin kullandığı "temel" veya muhasebe para birimi.
- Ücretin nasıl hesaplandığıyla ilgili ayrıntılar sağlayan bir ücret planı ücreti. Ücretlendirme modeli sabit bir ücrete dayandığından yalnızca bir ücret planı ücreti belirtirsiniz.
Ücret planı ücretinde şunları belirtirsiniz:
- Ücret planı ücretinin türü (
RATECARD). - Planın ücreti. Örneğin, 0, 10 değerini belirtirseniz ve para birimi ABD doları ise geliştiriciden her işlem için 0,10 ABD doları ücret alınır (veya bir işlemde iletilen bayt sayısı gibi özel bir özelliğe göre ücret alınırsa belirtilen bayt sayısını iletmek için geliştiriciden 0, 10 ABD doları ücret alınır).
- Oran uygulamasının başlangıç birimi (
0). Bu, oranın ilk işlemden başlayarak her işlem için uygulandığı anlamına gelir.
Ücret planı ayrıntısı seçeneklerinin tam listesi için Ücret planı ayrıntıları yapılandırma ayarları başlıklı makaleyi inceleyin.
Örneğin, aşağıdaki kod, sabit bir ücretlendirme modeline sahip bir fiyat listesi planı oluşturur. Oran, her işlem için 0,10 ABD doları olarak belirlenir. Ödeme 30 gün içinde yapılmalıdır. (Ücret listesiyle ilgili ayrıntılar vurgulanır.)
curl -H "Content-Type:application/json" -X POST -d \
'{
"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": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
Hacim bantlı şarj modeli belirtme
Hacim bantlı bir modelde, bir veya daha fazla fiyat planı fiyatı içeren fiyat planı ayrıntılarını belirtirsiniz. Her fiyat, bir "hacim bandı" için geçerlidir. Hacim bandı, işlem hacmi aralığı (veya iletilen bayt sayısı gibi özel bir özelliğe dayalı aralık) anlamına gelir. Bu tür planlar genellikle daha yüksek hacimli bantlar için indirimli fiyatlar sunarak geliştiricileri daha yüksek hacimler oluşturmaya teşvik etmek amacıyla oluşturulur.
Ücret planı ücretlerine ek olarak, ücret planı ayrıntılarında aşağıdakileri belirtirsiniz:
- Ücret planının işlemlere (
VOLUME) veya özel bir özelliğe (ör.CUSTOM_ATTRIBUTE_1) dayalı olduğunu belirten bir derecelendirme parametresi.VOLUMEvarsayılandır. - Ücretin işlem hacmine göre belirlendiğini (yani sabit ücretli faturalandırma modelinde olduğu gibi işlem başına sabit bir ücret olmadığını) gösteren bir ölçüm türü (
VOLUME). - Ödeme son tarihi (örneğin, 30 gün).
- Kuruluşunuzun kimliği.
- Şirketinizin kullandığı "temel" veya muhasebe para birimi.
- İşlem hacminin (veya özel özellikle ilgili hacmin) toplandığı süreyi birlikte belirten bir süre ve süre türü. Bu, "toplama temeli" olarak da adlandırılır. Geçerli hacim aralığını belirlemek için işlem hacmi, toplama temeli (örneğin, 1 ay) üzerinden toplanır.
- Geçerli hacim aralığını belirlemek için kullanılan toplama sayaçları.
Her ücret planı için şunları belirtirsiniz:
- Ücret planı ücretinin türü (
RATECARD). - Planın ücreti. Örneğin, 0, 10 belirtirseniz ve para birimi ABD doları ise geliştiriciden her işlem için 0,15 ABD doları ücret alınır (veya bir işlemde iletilen bayt sayısı gibi özel bir özelliğe göre ücret alınırsa belirtilen bayt sayısını iletmek için geliştiriciden 0, 15 ABD doları ücret alınır).
- Hacim bandının başlangıç ve bitiş birimi. Başlangıç birimi, hacim bandının alt sınırını, bitiş birimi ise hacim bandının üst sınırını belirtir. Örneğin, başlangıç birimini 0, bitiş birimini 1.000 olarak belirtirseniz hacim aralığı, toplama döneminde 1.000 işleme kadar olan kısmı kapsar. Para birimi ABD doları ise toplama dönemi 1 aydır ve ilk 1.000 işlem için oran 0, 15'tir. Geliştiriciden ayda 1.000 işleme kadar işlem başına 0, 15 ABD doları ücret alınır.
Paketlerin ne zaman sıfırlandığıyla ilgili ayrıntılar için Yinelenen ücretler ne zaman alınır ve paket planları ne zaman sıfırlanır? başlıklı makaleyi inceleyin.
Son hacim aralığı için bir bitiş birimi belirtmezseniz bu aralığın oranı, işlem sayısı söz konusu aralığın başlangıç biriminin üzerine çıktıktan sonraki tüm işlemlere uygulanır. Örneğin, son bant için başlangıç birimi 1.000 ise ve bu bant için bir bitiş birimi belirtmezseniz bant ücreti, toplama döneminde 1.000 işlemden sonraki tüm işlemler için uygulanır.
Ücret planı ayrıntısı seçeneklerinin tam listesi için Ücret planı ayrıntıları yapılandırma ayarları başlıklı makaleyi inceleyin.
Örneğin, aşağıda hacim bantlı bir ücretlendirme modeline sahip bir oran listesi planı oluşturulmaktadır. İlk 1.000 işlem için 0,15 ABD doları, 1.000'den fazla işlem için 0,10 ABD doları ücret alınır. Toplama temeli 1 aydır. Ödeme 30 gün içinde yapılmalıdır. (Ücret listesi ayrıntıları vurgulanır.)
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Volume banded rate card plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Volume banded rate card plan",
"displayName" : "Volume banded 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"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "VOLUME",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.15",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "1000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
Paketlenmiş bir şarj modeli belirtme
Paketlenmiş ücretlendirme modelinde geliştirici, bir işlem "paketi" (veya iletilen bayt sayısı gibi özel bir özelliğe dayalı bir paket) için (önceden) ödeme yapar. Her paket için bir oran ve toplama temeli (yani geliştiricinin paketi kullanabileceği bir süre) belirtirsiniz.
Örneğin, ilk paketin boyutunu 1-1.000 işlem, ikinci paketin boyutunu ise 1.001-2.000 işlem olarak ayarladığınızı varsayalım. İlk paket için ücret 50 ABD doları, ikinci paket için 40 ABD dolarıdır ve toplama temeli 1'dir. Geliştirici ilk paket için fiyat listesi planı satın alırsa bir ayda 1.000 işlem için 50 ABD doları (ön ödeme) öder. Geliştiriciden, paket tamamen kullanılsın veya kullanılmasın belirlenen tutar alınır. Toplama dönemi sona erdikten sonra planın süresi dolar. Geliştirici paketi tekrar kullanmak isterse planı (ve paketi) yeniden satın alması gerekir.
Ücret planı ayrıntılarında belirttiğiniz bilgiler, hacim bantlı ücretlendirme modeli için ücret planı ayrıntılarında belirttiğiniz bilgilerle aynıdır. Farklar şunlardır:
- Belirttiğiniz her ücret planı, bir hacim aralığı yerine bir paket içindir.
- Son pakette sınırsız işlem için geliştiriciden sabit bir tutar almak istemiyorsanız son paketin üst sınırını belirtmeniz gerekir.
Ücret planı ayrıntısı seçeneklerinin tam listesi için Ücret planı ayrıntıları yapılandırma ayarları başlıklı makaleyi inceleyin.
Örneğin, aşağıdaki kod, paketlenmiş bir ücretlendirme modeli içeren bir fiyat listesi planı oluşturur. Ücret, ilk paket (1.000'e kadar işlem) için 50 ABD doları, ikinci paket (1.000'den fazla ve 2.000'e kadar işlem) için 40 ABD doları olarak belirlenir. Toplama temeli 1 aydır. Ödeme 30 gün içinde yapılmalıdır.
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Bundled rate plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Bundled rate plan",
"displayName" : "Bundled rate plan",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "true",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "STAIR_STEP",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "50",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "40",
"startUnit": "1000",
"endUnit": "2000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
API'yi kullanarak tek tek ürünler için freemium planı belirtme
Fiyat listesi planında, bir API paketi yerine tek bir ürün için ücretsiz plan oluşturabilirsiniz. Freemium planı, geliştiricilere bir API ürününü belirli bir süre boyunca veya belirli bir kullanım miktarına kadar ücretsiz olarak kullanma imkanı sunar.
Bir API ürünü için ücretsiz plan ayarladığınızda, ücret tablosu plan ayrıntılarında geliştiricinin API ürünü tarafından sağlanan kaynakları ücretsiz olarak kullanabileceği dönemi belirtirsiniz. Dönem, aşağıdakilerden birine göre belirlenebilir:
- Süre, yani geçerlilik tarihi ile bitiş tarihi arasındaki zaman.
- API ürünüyle ilgili işlem sayısı veya işlem kayıt politikasına kaydedilen özel bir özellikle ilgili hacim gibi miktar.
Ücretsiz dönem miktara göre belirleniyorsa bunu ücretsiz birim sayısı olarak belirtin. Örneğin, aşağıda 5.000 birim hacmine dayalı bir freemium planı içeren bir fiyat listesi planı oluşturulmaktadır (freemium ile ilgili özellikler vurgulanmıştır).
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Flat rate card plan with freemium period",
"developer":null,
"developerCategory":null,
"advance": "false",
"currency": {
"id" : "usd"
},
"description": "Flat rate card plan with freemium period",
"displayName" : "Flat rate card plan with freemium period",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "myorg"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "false",
"ratePlanDetails": [
{
"currency": {
"aggregateFreemiumCounters" : true,
"aggregateStandardCounters" : true,
"id" : "usd"
},
"product" : {
"id" : "location",
"displayName":"Location"
},
"paymentDueDays": "30",
"meteringType": "UNIT",
"organization": {
"id": "myorg"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"freemiumUnit": "5000",
"freemiumDuration": "0",
"freemiumDurationType": "DAY",
"ratingParameterUnit":"MB",
"customPaymentTerm": "false",
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password