Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Giriş
Ücret 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 fiyatı gibi ek ayrıntılar sağlamanız gerekir.
İsteğe bağlı olarak, tek tek ürünler için (API paketi yerine) ücretsiz sürüm 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?
Ücret planları, yinelenen ücretlerin yanı sıra API paketlerini (hacim bantlı ve paket planlar) de içerebilir. Her ikisinde de ücretlerin tahsil edildiği ve paket planları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ızda... | ...bu durum yaşanır |
|---|---|
|
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 fiyat planı oluşturmak için yönetim API'sini kullanarak bir fiyat planı oluşturun ve API'yi kullanarak fiyat planları oluşturma bölümünde açıklandığı gibi günü |
|
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ğundan artık 28 Şubat olur. 28'i, sıfırlama günü olarak kalır. |
Kullanıcı arayüzünü kullanarak ücret listesi planlarını yapılandırma
Ücret listesi planlarını aşağıda açıklandığı şekilde 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 ücret alınır. |
| Paketler | Geliştiriciden her işlem paketi için önceden belirli bir tutar alınır. Paketin tamamı kullanılsın veya kullanılmasın, geliştiriciden belirlenen tutar alınır.
Not: Bu seçenek, fiyat listesi ve gelir paylaşımı seçildiğinde kullanılamaz. |
Ardından, seçilen ücretlendirme 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ığı süre. 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ı makaleye bakın. Ö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ı fiyatlandırma 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. Oran, 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).
Başka bantlar eklemek için +Yeni'yi tıklayın. Bu seviyenin üzerindeki tüm işlemleri belirtmek için son bandı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ı makaleye bakın. Örneğin, Hacim Aralığı bölümünde iki hacim aralığı belirtirseniz (>0-1000 ve 1000 ve üzeri), >0-1000 hacim aralığı için 0,15, 1000 ve üzeri hacim aralığı için 0,10 girebilirsiniz. Seçilen para birimi ABD doları ise ilk 1.000 işlem için oran 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ıdı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).
Ek paketler eklemek için +Yeni'yi tıklayın. Geliştiriciden son paketteki sınırsız işlemler için sabit bir tutar almak istemiyorsanız son paket için bir üst sınır 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ı makaleye bakın. Ö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 paketin fiyatı 50 ABD doları, ikinci paketin fiyatı ise 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 üzere özel bir 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 listeden özel özelliği belirleyin. Daha fazla bilgi için Özel özelliklerle fiyat planı yapılandırma başlıklı makaleyi inceleyin.
Classic Edge (Özel Bulut)
Klasik Edge kullanıcı arayüzünü kullanarak ücret listesi planlarını yapılandırmak için:
- Fiyat planı oluşturma adımlarını uygulayın.
- Gelir modelini yapılandırmak için Ücret Planı Türü açılır listesinde Ücret Tablosu'nu 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ı fiyat planı ayrıntılarını yapılandırmak üzere ürüne özel planlar.
- Tüm API ürünleri için fiyat planı ayrıntılarını yapılandırmak üzere Tüm Ürünler İçin Genel Plan'ı kullanın.
- Genel fiyat planı veya her API ürününe özel fiyat planı için Fiyat Listesi'ni tıklayın.
Not: API'ye özgü planları yapılandırırken her API ürünü için ayrı ayrı bir fiyat listesi planı yapılandırmanız gerekir.
Ücret 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, Hacim alanında belirtilen miktara göre belirlenir.
- Süreye göre. Ücretli dönem, Freemium Süresi alanında belirtilen zaman aralığına göre belirlenir.
- Hangisi önce gelirse. Ücretsiz dönem, birim alanındaki miktar veya Freemium Süresi alanındaki zaman aralığına ulaşıldığında (hangisi önce gerçekleşirse) sona erer.
- Hayır, bu bir freemium planı değildir. Bu, varsayılan seçenektir.
Freemium Volume Geliştiricilerden ücret alınmayan işlem 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 hacim numarası girin. Bu nedenle, geliştiriciler planı başlattığında ilk 5.000 işlem (veya özel özelliklerle ilgili öğenin ilk 5.000 kullanımı) için ücret alınmaz. Bu alan yalnızca "Freemium Ürün mü?" alanında "Miktara Göre" veya "Hangisi Önce Gelirse" seçeneğini belirlediğinizde etkinleştirilir.
Freemium Süresi Geliştiricilerden ücret alınmadığı zaman aralığı. Bir sayı girin ve bir zaman aralığı seçin (örneğin, 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. Paketin tamamen kullanılıp kullanılmadığına bakılmaksızın geliştiriciden belirlenen tutar alınır.
Sabit ücret modeli için: Genel Ücret 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 ü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ı makaleye bakın.
Ö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 ücret alınırsa belirtilen bayt sayısını ilettiği için geliştiriciden 0, 10 ABD doları ücret alınır).
Hacim bantlı model için: Genel Fiyat 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 özellikle 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 hacim aralığına bir ücret atanabilir (bu ücreti Fiyatlandırma bölümünün Hacim Aralığı alanında belirlersiniz). Oran, geçerli hacim aralığındaki tüm işlemler için geçerlidir. İ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). İkinci bir bant eklemek için (ör. 1.000'den büyük ve 2.000'e kadar) + 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 bandı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ş Profili'ndeki Ü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ı 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ı makaleye bakın.
Örneğin, Hacim Aralığı bölümünde iki hacim aralığı belirtirseniz (>0-1000 ve 1000 ve üzeri), >0-1000 hacim aralığı için 0,15, 1000 ve üzeri hacim aralığı için 0,10 girebilirsiniz. Seçilen para birimi ABD doları ise ilk 1.000 işlem için her işlem başına ücret 0, 15 ABD doları, 1.000'den fazla işlem için ise her işlem başına ücret 0, 10 ABD dolarıdır.
Paketlenmiş model için: 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 bir 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 + simgesini tıklayın (örneğin, 1.000'den fazla 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 paket için bir üst sınır 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ş Profili'ndeki Ü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 belirtirsiniz. 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ı makaleye bakın.
Ö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 paketin fiyatı 50 ABD doları, ikinci paketin fiyatı ise 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 fiyat planları için gerektiğinde ek API ürünlerinin fiyat planı ayrıntılarını 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 kartı 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 belirttiğiniz değerler, seçtiğiniz ücretlendirme modeline (sabit ücret, hacim bantlı veya paketler) bağlıdır.
Sabit ücretli bir ücretlendirme 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 dayalı olduğundan 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ın iletilmesi için geliştiriciden 0, 10 ABD doları ücret alınır).
- Ücret uygulamasının başlangıç birimi (
0). Bu, ücretin 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ı 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 gösteren bir ölçüm türü (
VOLUME) (yani sabit ücretli faturalandırma modelinde olduğu gibi işlem başına sabit bir ücret değildir). - Ö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ü. Buna "toplama temeli" de denir. 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ı ücreti 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ın iletilmesi için 0, 15 ABD doları ücret alınır).
- Ses 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 işlemleri kapsar. Para birimi ABD doları ise toplama dönemi 1 aydır ve ilk 1.000 işlem için oran 0,15'tir. Bu durumda, 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ı bu 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 oranı, 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 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 ise 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 paket boyutunun 1-1.000 işlem, ikinci paket boyutunun ise 1.001-2.000 işlem olduğu iki paket oluşturduğunuzu varsayalım. İlk paket için ücret 50 TL, ikinci paket için 40 TL'dir ve toplama temeli 1'dir. Geliştirici ilk paket için fiyat listesi planı satın alırsa ayda 1.000 işlem için 50 ABD doları (peşin) öder. Paketin tamamen kullanılıp kullanılmadığına bakılmaksızın geliştiriciden 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 paket içindir.
- Son paketteki sınırsız işlemler için geliştiriciden sabit bir tutar almak istemiyorsanız son paket için bir üst sınır 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ğıdakiler paketlenmiş bir ücretlendirme modeline sahip bir fiyat listesi planı oluşturur. İlk paket (1.000'e kadar işlem) için ücret 50 ABD doları, ikinci paket (1.000'den fazla ve 2.000'e kadar işlem) için ise 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 ücretsiz 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 kullanım miktarına göre ücretsiz olarak kullanma imkanı sunar.
Bir API ürünü için ücretsiz plan oluşturduğunuzda, fiyat listesi plan ayrıntılarında geliştiricinin API ürünü tarafından sağlanan kaynakları ücretsiz olarak kullanabileceği süreyi 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 miktarlar.
Ü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şturulmuştur (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