Sınır bildirimlerini ayarlama

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Giriş

Para Kazanma Sınırları Kontrolü politikasını kullanarak para kazanma sınırları uygulama bölümünde açıklandığı şekilde, para kazanmayla ilgili sınırlar belirleyebilirsiniz. Ayrıca, bir sınıra yaklaştığında veya ulaşıldığında kuruluşunuzdaki geliştiricileri ve/veya kullanıcıları uyaracak otomatik bildirimler ayarlayabilirsiniz.

Örtülü sınırlar ve özel sınırlar için otomatik bildirimler ayarlayabilirsiniz. Örneğin sistem, ön ödemeli geliştiricileriniz için ön ödeme bakiyesi olan bir örtülü sınır belirler. Otomatik bildirimleri ayarlayarak geliştiricilerinizin ön ödeme bakiyesine yaklaştıklarında veya bu bakiyelerine ulaştıklarında bildirim alabilirsiniz.

Araç Kutusu

Yönetim kullanıcı arayüzünü veya para kazanma API'sini kullanarak sınırlar için otomatik bildirimler ayarlayabilirsiniz. Kullanıcı arayüzünü kullanırsanız otomatik bildirimleri Bildirimler sayfasında ayarlarsınız.

API'yi kullanıyorsanız para kazanma tarafından sağlanan bildirim şablonunu düzenleyerek sınırlar için otomatik bildirimler ayarlayabilirsiniz. Daha sonra, düzenlenen şablon tarafından sağlanan bildirimin gönderilmesiyle sonuçlanan koşulu belirtirsiniz.

Kullanıcı arayüzünü kullanarak sınır bildirimlerini ayarlama

  1. Sınır Ekle sayfasının Bildirimler bölümünde Ekle 'yi tıklayın. Bu işlemle Bildirim bölümü açılır.

  2. Bildirim için bir seviye seçin. Bu, mutlak bir sayıya veya sınır tabanının belirli bir yüzdesine dayalı bir eşiktir. Seçiminizi yapın:
    • Açılır menüden büyüktür veya eşittir işareti (?) ya da küçük veya eşittir işareti (?)
    • Tam sayı (yani ondalık basamak içermeyen). Mutlak (sayı değeri belirtmek için) veya yüzde değeri için Yüzde. Yüzde sınırları için sınırı her zaman > olarak ayarladığınızdan emin olun. Bu, geliştirici söz konusu yüzde seviyesine ulaştığında veya bu seviyeyi aştığında bildirimin gönderileceği anlamına gelir.

    Örneğin, 100 ABD doları tutarında bir harcama sınırı belirlerseniz ve bildirimi %90 veya daha yüksek bir değere ayarlarsanız sınırın% 90'ına (90 ABD doları) ulaşıldığında veya bu sınır aşıldığında bildirim gönderilir.

  3. E-posta Gönder alanında, bir veya daha fazla geliştirici ya da kuruluşunuzdan bir veya daha fazla kullanıcı seçin. Etkilenen geliştiricilere veya kullanıcılara bildirim gönderilecektir.

    E-posta alıcıları: Yalnızca Geliştirici sınırı koşulu "Herhangi biri" ise veya belirli bir geliştirici için Geliştirici sınırı koşulu ayarlarsanız geliştiricilere bildirim gönderebilirsiniz. "Herhangi biri" seçeneğini belirlerseniz e-posta adresleri listesinde "Seçili geliştirici (Herhangi biri)" ifadesini görürsünüz. Dolayısıyla para kazanma özelliği, durumdan etkilenen tüm geliştiricilere bildirim gönderilir. Belirli bir geliştirici seçtiyseniz e-posta adresleri listesinde "Seçili geliştirici ({developer_id})" ifadesini görürsünüz (burada {developer_id}, seçilen geliştiricinin kimliğidir). Para Kazanma özelliği yalnızca ilgili geliştiriciye bildirim gönderir.

    Geliştirici sınırı koşulu olarak "Herhangi biri" veya belirli bir geliştirici seçmediyseniz E-posta Gönder alanında "Seçili geliştirici (Herhangi biri)" ifadesini görmezsiniz. Ancak kuruluşunuzdaki hangi kullanıcılara bildirim göndermek istediğinizi seçebilirsiniz.

    Yönetici sekmesinde Kuruluş Kullanıcıları'nı seçerek kuruluşunuzdaki kullanıcılar için e-posta adresleri ekleyebilirsiniz.

    E-posta şablonları: E-posta Gönder alanındaki "Seçili geliştirici (Herhangi biri)" seçeneğini veya kuruluşunuzdaki kullanıcıların e-posta adreslerini (ya da her ikisini) seçtikten sonra bir e-posta şablonu görürsünüz. Şablonda görünenler aşağıdakilere bağlıdır:

    • Bildirimin düzeyi.
    • Sınırın yürütmeyi durdurma sınırı olup olmadığı.
    • E-postanın kuruluş kullanıcıları, geliştiriciler veya her ikisi için mi gönderildiği.

    Örneğin, aşağıdakilerin tümü doğruysa:

    • Yürütmeyi durdur onay kutusu işaretli.
    • Bildirim düzeyi% 100 veya sınırla aynı miktardadır.
    • Bu e-posta yalnızca kuruluş kullanıcıları içindir.

    Şablon aşağıdaki gibi görünür:

    Geliştiricinin şirket adının "XYZ şirketi" olduğunu, işlem hacmi sınırının "X Package" (X Paketi) ve "Y Product" adlı bir API Ürünü için 50 olarak ve geçerlilik bitiş tarihinin 30 Eylül 2013 olarak belirlendiğini varsayalım. Gönderilen e-posta iletisi şu şekilde görünür:

    Developer XYZ company has exceeded their transaction volume limit of 50 transactions for X package, Y product. Their API calls will be blocked till 2013-09-30

    E-posta "Seçili geliştirici (Herhangi biri)" ise şablon aşağıdaki gibi görünür:

    Her iki şablon da geliştirici adı (varsa), paket adı (varsa) ve ürün adı (varsa) gibi ilgili değişkenleri çözümler. Şablonun solundaki Düzenle'yi tıklayarak mesajı gereksinimlerinizi karşılayacak şekilde düzenleyebilirsiniz.

    Sınır "Herhangi biri" veya belirli bir uygulama ve "Herhangi biri" veya belirli bir kullanıcı içinse şablona uygulamalar ve kullanıcılar için değişkenler eklemeniz gerekir. Bu işlemi aşağıdaki şekilde yapabilirsiniz:

    • Şablonun solundaki Düzenle 'yi tıklayın.
    • ${user.name} user, depending on whether the limit is for application and/or user. küçük resmini ekle

    "Herhangi biri" veya belirli bir uygulama için düzenlenmiş şablon aşağıda gösterilir.

    Yürütmeyi durdur seçeneği işaretlenmezse veya bildirim düzeyi %100 veya daha yüksek olursa seçilen bir geliştiricinin şablonu aşağıdaki gibi görünür:

    Sınır "Herhangi biri" (veya belirli bir) uygulama ya da "Herhangi biri" (veya belirli bir) kullanıcı içinse sınırın uygulamaya, kullanıcıya veya her ikisine bağlı olarak şablonu düzenlemeniz ve ardından ${application.name} uygulaması ve/veya ${user.name} kullanıcısı eklemeniz gerekir.

    Şablon değişkenleri: Bir e-posta şablonunda mesajı düzenlediğinizde aşağıdaki değişkenlerden herhangi birini ekleyebilirsiniz.

    Değişken Açıklama
    ${developer.name}

    Geliştiricinin adı.
    ${developer.legalName}

    Geliştiricinin şirketinin adı.
    ${ratePlan.monetizationPackage.displayName}

    API paketinin adı.
    ${application.name}

    Uygulamanın adı.
    ${USER}

    Kullanıcının adı.
    ${USAGE}

    Mevcut kullanım (toplam gelir veya ödemeler ya da hacim).
    ${PERCENT}

    Mevcut kullanım tarafından ulaşılan sınırın yüzdesi.
    ${QUOTA_TYPE}

    Sınır türü (işlem hacmi, harcama sınırı veya gösterilen ücret).
    ${QUOTA_UNIT}

    Sınır için temel birim: para birimi (harcama sınırı için) veya aramalar (işlem sınırı için).
    ${QUOTA_LIMIT}

    Limitin miktarı.
    ${EXPIRY_DATE}

    Sınırın süresinin dolacağı veya sıfırlanacağı tarih veya saat.

    Örneğin, herhangi bir geliştirici herhangi bir uygulamadaki paket için belirli bir işlem hacmine ulaştığında bildirim almak istiyorsanız şablonu aşağıdaki gibi düzenleyebilirsiniz:

    ${developer.legalName} has reached a total volume of ${USAGE} on ${ratePlan.monetizationPackage.displayName}. This is ${PERCENT} of the daily/weekly/monthly (state period of limit as appropriate) transaction volume limit of ${QUOTA_LIMIT}.
  4. Ek seviyeler için gerektiğinde bildirim ekleyin. Her ek seviye için Ekle'yi tıklayın. Bu işlem, sayfanın Bildirimler bölümüne Düzey, E-posta gönder ve E-posta şablonu alanlarını ekler. Bildirimleriniz için 6'ya kadar seviye ekleyebilirsiniz. Örneğin bildirimi > %70, %80, %90, %100 olarak ayarlarsanız bu seviyelerden her birine ulaşıldığında bildirim gönderilir.
  5. Tüm bildirimleri ekledikten sonra Kaydet (bildirimleri daha sonraki bir tarihte kaydedip yayınlamak için), Kaydet ve Yayınla (şimdi yayınlamak için) veya İptal (iptal için) seçeneğini tıklayın.

API'yi kullanarak sınır bildirimleri ayarlama

Para kazanma özelliği, sınır bildirimleri ve geliştiricileri yeni ürünlerin kullanıma sunulduğu konusunda uyarmak gibi anlık bildirimler dahil olmak üzere çeşitli bildirim türleri için metin sağlayan bir dizi şablon sunar. Bu şablonları ihtiyaçlarınıza göre uyarlayabilirsiniz. Otomatik sınır bildirimi ayarlamak için önce uygun bir şablonu düzenleyin. Ardından, düzenlenen şablon tarafından sağlanan bildirimin gönderilmesiyle sonuçlanan koşulu belirtin. Ayrıntılı bilgi için Bildirim şablonlarını kullanarak bildirimleri ayarlama başlıklı makaleyi inceleyin.

Sonraki adımlar

Geliştiricileri yeni ürünler, şartlar ve koşulların yeni sürümleri veya yeni ücret planları gibi etkinlikler hakkında uyarmak için otomatik bildirimleri nasıl ayarlayacağınızı öğrenin. Bildirim şablonlarını kullanarak bildirim oluşturma bölümüne bakın.