Ön ödemeli hesap bakiyelerini yönetme

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri.
bilgi

Ön ödemeli bir hesapta bakiyeyi yönetmek için şunları yapabilirsiniz:

Kalan ön ödemeli hesap bakiyesini nasıl hesaplarım?

Bir geliştirici veya şirkete ait ön ödemeli hesap bakiyesini görüntülerken, aşağıdaki bölümlerde açıklanmıştır: yanıttan aşağıdaki değerleri alın:

  • amount: Geçerli fatura dönemi için kullanılabilen toplam para tutarı. Yeniden yüklediğinizde bu değer güncellenir bu bölümde açıklanan yöntemler kullanılarak ön ödemeli hesaba ödeme yapılması gerekir.
  • usage: Geçerli fatura döneminde kullanılan toplam para tutarı. Bu değer, para kazanılan her uygun nitelikle güncellenir kredi verilmesiyle (pozitif veya negatif) oluşmalıdır.

Mevcut aylık etkin kullanıcı sayınızı usage değerini amount değeri. Örneğin, amount değeri 335.50 ve usage değeri 34 ise kalan bakiye şu şekilde hesaplanır:

amount(335.50) - usage(34) = 229.50

API'yi kullanarak ön ödemeli hesap bakiyelerini görüntüleme

Aşağıdaki bölümlerde, geliştiricilerin veya aboneliklerin ön ödemeli hesap bakiyelerini yardımcı oluyorum.

Geliştiricinin ön ödemeli hesap bakiyelerini görüntüleme

Bir geliştiricinin ön ödemeli hesap bakiyelerini görüntülemek için aşağıdaki API'lerden birine GET isteği gönderin. Burada {developer_id}, geliştiricinin e-posta adresidir:

  • /mint/organizations/{org_name}/developers/{developer_id}/developer-balances: Geliştiricinin ön ödemeli hesap bakiyesini ve yinelenen kurulum bilgilerini döndürür.
  • /mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances: Şunlar dahil ön ödemeli hesap bakiyesi bilgilerini döndürür: geçerli ve toplam bakiye, kullanım, para eklemeler ve kullanım vergisi.

Sonuçları filtrelemek için aşağıdaki sorgu parametrelerini aktarabilirsiniz:

Sorgu Parametresi Açıklama
all Tüm API paketlerinin döndürülüp döndürülmeyeceğini belirten işaret. false olarak ayarlanırsa sayfa başına döndürülen API paketi sayısı size sorgu parametresiyle tanımlanır. Varsayılan olarak false (yanlış) değerine ayarlanır.
size Sayfa başına döndürülen API paketi sayısı. Varsayılan değer 20'dir. all sorgusu parametresi true olarak ayarlanırsa bu parametre yoksayılır.
page Döndürmek istediğiniz sayfanın sayısı (içerik sayfalara ayrılmışsa). Eğer all sorgu parametresi true olarak ayarlıysa bu parametresi yoksayılır.
currencyId Ön ödemeli hesap bakiyelerini görüntülemek istediğiniz para biriminin kimliği.

Örneğin:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

Aşağıda yanıtın bir örneği verilmiştir:

{
    "developerBalance": [
        {
            "amount": 2005,
            "chargePerUsage": false,
            "id": "your-provider-id",
            "isRecurring": false,
            "supportedCurrency": {
                "description": "United States Dollars",
                "displayName": "United States Dollars",
                "id": "usd",
                "name": "USD",
                "organization": {
                    "address": [
                        {
                            "address1": "10 Almaden Blvd.",
                            "city": "San Jose",
                            "country": "US",
                            "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61",
                            "isPrimary": true,
                            "state": "CA",
                            "zip": "95113"
                        }
                    ],
                    "approveTrusted": false,
                    "approveUntrusted": false,
                    "billingCycle": "CALENDAR_MONTH",
                    "country": "US",
                    "currency": "USD",
                    "description": "my-org",
                    "groupOrganization": false,
                    "hasBillingAdjustment": false,
                    "hasBroker": false,
                    "hasSelfBilling": false,
                    "hasSeparateInvoiceForProduct": false,
                    "id": "my-org",
                    "issueNettingStmt": false,
                    "name": "my-org",
                    "nettingStmtPerCurrency": false,
                    "selfBillingAsExchOrg": false,
                    "selfBillingForAllDev": false,
                    "separateInvoiceForFees": false,
                    "status": "ACTIVE",
                    "supportedBillingType": "BOTH",
                    "taxModel": "HYBRID",
                    "timezone": "UTC"
                },
                "status": "ACTIVE",
                "virtualCurrency": false
            },
            "usage": 2.1572
        }
    ],
    "totalRecords": 1
}

Bir şirketin ön ödemeli hesap bakiyelerini görüntüleme

Bir şirketin ön ödemeli hesap bakiyelerini görüntülemek için şuna bir GET isteği gönderin: /mint/organizations/{org_name}/companies/{company_id}/developer-balances, burada: {company_id} şirketin kimliğidir. Şirket ön ödemeliyse istek Mevcut ön ödemeli hesap bakiyesini alır. Şirket sonradan ödemeliyse istek geçerli kredi limitini aşmamalıdır.

Sonuçları filtrelemek için aşağıdaki sorgu parametrelerini aktarabilirsiniz:

Sorgu Parametresi Açıklama
all Tüm API paketlerinin döndürülüp döndürülmeyeceğini belirten işaret. false olarak ayarlanırsa sayfa başına döndürülen API paketi sayısı size sorgu parametresiyle tanımlanır. Varsayılan olarak false (yanlış) değerine ayarlanır.
size Sayfa başına döndürülen API paketi sayısı. Varsayılan değer 20'dir. all sorgusu parametresi true olarak ayarlanırsa bu parametre yoksayılır.
page Döndürmek istediğiniz sayfanın sayısı (içerik sayfalara ayrılmışsa). Eğer all sorgu parametresi true olarak ayarlıysa bu parametresi yoksayılır.
currencyId Ön ödemeli hesap bakiyelerini görüntülemek istediğiniz para biriminin kimliği.

Örneğin:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

Google Ads hesabının ön ödemeli hesap bakiyesini görüntülerken verilen yanıt, yukarıda gösterilen bir geliştiricidir.