Tarifpakete für API-Produkte verwalten

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Mithilfe von Tarifpaketen können API-Produktinhaber ihre API-Produkte durch Konfigurieren der folgenden Elemente monetarisieren:

  • Rechnungskontomodell
  • Für die Abrechnung verwendete Währung
  • Häufigkeit, mit beim Kunden abgerechnet wird (nur monatlich)
  • Ersteinrichtungsgebühren für die Verwendung eines API-Produkts
  • Verbrauchsabhängige Gebühren für die Nutzung eines API-Produkts
  • Alle wiederkehrenden Gebühren, die nicht auf dem Verbrauch basieren, z. B. monatliche Gebühren für den Zugriff auf Ihr API-Produkt
  • Zeitintervall, für das das Tarifpaket für ein API-Produkt gilt (Aktivierungs und Ablaufzeiten des Tarifpakets)
  • Umsatzbeteiligung von Entwicklerpartnern

Verwalten Sie Tarifpakete für Ihre API-Produkte, wie in den folgenden Abschnitten beschrieben.

Tarifpakete ansehen

Rufen Sie Tarifpakete in Ihrer Organisation auf, wie in den folgenden Abschnitten beschrieben.

Apigee in der Cloud Console

Rufen Sie Tarifpakete mit der Apigee-Benutzeroberfläche in der Cloud Console auf, wie in den folgenden Abschnitten beschrieben.

Für Ihre Organisation definierte Tarifpakete ansehen

Sie können auf der Seite "Tarifpakete" für Ihre Organisation definierte Tarifpakete ansehen.

So greifen Sie auf die Seite "Tarifpakete" zu:

  1. Melden Sie sich in der Apigee-UI in der Cloud Console an.
  2. Wählen Sie in der seitlichen Navigationsleiste Verteilung > Monetarisierung aus.

Die Seite "Tarifpakete" wird geöffnet und listet die aktuellen Tarifpakete auf.

Liste der Tarifpakete mit dem Namen des Tarifpakets, dem API-Produkt und der jeweiligen Aktivierungs- und Ablaufzeit sowie dem Menü, über das Sie das Tarifpaket verwalten können

Auf der Seite „Tarifpakete“ haben Sie folgende Möglichkeiten:

Tarifpakete ansehen, die mit einem API-Produkt verknüpft sind

Wenn Sie ein API-Produkt verwalten, können Sie die mit einem API-Produkt verknüpften Tarifpakete ansehen und verwalten. Scrollen Sie nach unten zum Abschnitt Tarifpaket, um die Tarifpakete aufzurufen.

Klassische Apigee-UI

Rufen Sie Tarifpakete mit der Benutzeroberfläche auf, wie in den folgenden Abschnitten beschrieben.

Für Ihre Organisation definierte Tarifpakete ansehen

Sie können auf der Seite "Tarifpakete" für Ihre Organisation definierte Tarifpakete ansehen.

So greifen Sie auf die Seite "Tarifpakete" zu:

  1. Melden Sie sich in der klassischen Apigee-Benutzeroberfläche an.
  2. Wählen Sie in der seitlichen Navigationsleiste Veröffentlichen > Monetarisierung > Tarifpakete aus.

Auf der Seite „Tarifpakete“ sind die aktuellen Tarifpakete aufgeführt.

Liste der Tarifpakete mit dem Namen des Tarifpakets, dem API-Produkt und der jeweiligen Aktivierungs- und Ablaufzeit sowie dem Drop-down-Menü, über das Sie das Tarifpaket verwalten können

Auf der Seite „Tarifpakete“ haben Sie folgende Möglichkeiten:

Tarifpakete ansehen, die mit einem API-Produkt verknüpft sind

Wenn Sie ein API-Produkt verwalten, können Sie die mit einem API-Produkt verknüpften Tarifpakete ansehen und verwalten. Bearbeiten Sie das API-Produkt und scrollen Sie nach unten zum Abschnitt Tarifpakete.

Apigee API

In den folgenden Abschnitten wird beschrieben, wie Sie die Tarifpakete für eine Organisation mit der API aufrufen können:

Tarifpakete für ein API-Produkt mithilfe der API auflisten

Senden Sie eine GET-Anfrage an die folgende API, um die Tarifpakete für die Organisation aufzulisten: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans

Zum Beispiel mit curl:

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

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen finden Sie unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe, einschließlich der zwei Tarifpakete myrateplan1 und myrateplan2, die mit dem API-Produkt HelloworldProduct verknüpft sind:

{
    "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"
        }
    ]
}

Weitere Informationen zur API und ihrer Antwortnutzlast finden Sie unter List rate plans API.

Details zu einem Tarifpaket mithilfe der API abrufen

Wenn Sie Details zu einem Tarifpaket ansehen möchten, senden Sie eine GET-Anfrage an die folgende API: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME

Informationen zum Ermitteln des Namens des Tarifpakets, das in den Ressourcenpfad übergeben werden soll, finden Sie unter Tarifpakete in einer Organisation auflisten.

Zum Beispiel mit curl:

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

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen finden Sie unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe für das Tarifpaket mit dem Namen 6b51b501-ac15-41b7-bb3e-621edb849e13 und dem Anzeigenamen 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"
}

Weitere Informationen zur API und ihrer Antwortnutzlast finden Sie unter Get rate plan API.

Tarifpakete erstellen

Erstellen Sie Tarifpakete, wie in den folgenden Abschnitten beschrieben.

Apigee in der Cloud Console

So erstellen Sie ein Tarifpaket über die Apigee-Benutzeroberfläche in der Cloud Console:

  1. Führen Sie eine der folgenden Aufgaben aus:
    • Wählen Sie in der seitlichen Navigationsleiste Verteilung > Monetarisierung aus und klicken Sie in der Liste der Tarifpakete auf Erstellen.
    • Bearbeiten Sie ein API-Produkt und klicken Sie im Abschnitt Tarifpakete auf Tarifpaket hinzufügen.
  2. Geben Sie die Tarifpaketdetails so ein:
    Feld Beschreibung
    Name des Tarifpakets Geben Sie den Namen des Tarifpakets ein.
    API-Produkt Wählen Sie aus dem Drop-down-Menü ein API-Produkt aus, mit dem Sie das Tarifpaket verknüpfen möchten.
  3. Klicken Sie auf Weiter.
  4. Geben Sie die Details zur Abrechnung folgendermaßen ein:
    Feld Beschreibung Standard
    Abrechnungswährung Wählen Sie aus dem Drop-down-Menü die Währung aus, die für die Abrechnung verwendet werden soll. USD
    Abrechnungszeitraum Wählen Sie aus dem Drop-down-Menü die Häufigkeit aus, mit der die Abrechnung beim Kunden erfolgen soll. Monatlich
    Initialisierungsgebühr

    Eine einmalige Gebühr, die jedem Entwickler am Startdatum des Tarifpakets in Rechnung gestellt wird, also dem Datum, an dem der Entwickler das API-Produkt kauft.

    Wenn Sie die Einrichtungsgebühr in Rechnung stellen möchten, wählen Sie Initialisierungsgebühr in Rechnung stellen aus und geben Sie den zu berechnenden Betrag in das Feld Initialisierungsgebühr ein.

    		 Deaktiviert
  5. Klicken Sie auf Weiter.
  6. Geben Sie die Details zu den Preisen folgendermaßen ein.
    Feld Beschreibung Standard
    Feste wiederkehrende Gebühr Feste wiederkehrende Gebühr pro Einheit aktivieren:
    1. Wählen Sie Feste wiederkehrende Gebühr berechnen aus.
    2. Konfigurieren Sie die Häufigkeit der festen Gebühr und den Betrag der festen wiederkehrenden Gebühr.

    Die Gebühr wird für den ersten Abrechnungszeitraum anteilig berechnet.

    Wenn diese Option aktiviert ist, können Sie eine Vorschau der Auswirkungen der festen wiederkehrenden Gebühr auf die einzeln aufgelisteten Kosten und die Gesamtkosten aufrufen, wie in Vorschau des Tarifpakets ansehen beschrieben.

    Wenn Sie die Gebühr deaktivieren möchten, heben Sie die Auswahl von Feste wiederkehrende Gebühr berechnen auf.

    		Deaktiviert
    Nutzungsbasierte Gebühren Verbrauchsabhängige Preise aktivieren:
    1. Wählen Sie Verbrauchsabhängige Gebühr aus.
    2. Wählen Sie eine der folgenden Optionen aus:
      • Feste Gebühr pro Einheit (feste Gebühr pro genutzter Einheit)
      • Bandbasiert (eine variable Gebühr pro genutzter Einheit, bestimmt durch Nutzungsbereiche)

    • Feste Gebühr pro Einheit: Für jede monetarisierte Transaktion wird eine feste Gebühr berechnet. Geben Sie in das Feld Feste Gebühr pro Einheit einen Wert ein, der für jede Transaktion berechnet werden soll.

    • Bandbasiert: Für jede monetarisierte Transaktion wird eine variable Gebühr berechnet. Das Transaktionsband und die Nutzung bestimmen die Gebühren für eine Transaktion. Ein Band bezieht sich auf einen API-Nutzungsbereich und für jedes Band gilt eine andere Gebühr. Im Abschnitt Ranges of unit consumption können Sie die Bandbereiche und die entsprechenden Gebühren für das Band festlegen. Sie können beliebig viele Bänder angeben, indem Sie auf + BAND klicken.

      Beispiel: Angenommen, Sie möchten die ersten 1.000 API-Aufrufe mit 2 $ pro Aufruf und alle nachfolgenden API-Aufrufe mit 1 $ pro Aufruf abrechnen. Geben Sie dazu im Abschnitt Ranges of unit consumption die folgenden beiden Bänder an:

      • Geben Sie in der ersten Zeile die folgenden Werte ein:
        • Start: 0
        • Ende: 1000
        • Gebühr: 2
      • Geben Sie in der zweiten Zeile die folgenden Werte ein:
        • Start: 1001
        • Ende: Unbegrenzte Einheiten
        • Gebühr: 1

      Wenn ein Entwickler 1.500 APIs nutzt, betragen die Gesamtkosten 2.500 $ ((1000 * 2) + (500 * 1)).

    Wenn Sie nutzungsbasierte Gebühren aktivieren, können Sie eine Vorschau der Auswirkungen des ausgewählten Gebührentyps auf den Gesamtumsatz als Vorschau anzeigen, wie unter Vorschau des Tarifpakets ansehen beschrieben.

    Wenn Sie die Gebühr deaktivieren möchten, entfernen Sie das Häkchen bei Verbrauchsabhängiges Preismodell.

    Wenn Sie in Ihrer DataCapture-Richtlinie die Monetarisierungsvariable perUnitPriceMultiplier konfiguriert haben, werden die Kosten pro Transaktion in einem beliebigen Typ (feste Gebühr pro Einheit oder bandbasiert) von nutzungsbasierten Gebühren mit dem Wert von perUnitPriceMultiplier multipliziert.

    		 Deaktiviert
  7. Klicken Sie auf Weiter.
  8. Geben Sie die Details zur Umsatzbeteiligung so ein:
    Feld Beschreibung Standard
    Umsatzbeteiligung Aktivieren Sie die Umsatzbeteiligung, um einen Prozentsatz des Umsatzes mit Entwicklerpartnern zu teilen.
    1. Wählen Sie Umsatzbeteiligung aktivieren aus.
    2. Geben Sie einen Prozentsatz des Umsatzes, der geteilt werden soll, in das Feld Prozentsatz (%) des Umsatzes, der mit dem Entwickler geteilt werden soll ein.

    Sie können den geteilten Umsatz für jede monetarisierte Transaktion abrufen, indem Sie die Monetarisierungsvariable revShareGrossPrice in Ihrer DataCapture-Richtlinie konfigurieren. Weitere Informationen finden Sie unter Monetarisierungsvariablen.

    Wenn Sie die Umsatzbeteiligung aktivieren, können Sie eine Vorschau der Auswirkungen des eingegebenen Werts für Prozentsatz (%) auf die einzelnen Elemente und auf die Gesamtkosten anzeigen, wie in Vorschau des Tarifpakets ansehen beschrieben.

    Um die Gebühr zu deaktivieren, deaktivieren Sie Umsatzbeteiligung aktivieren.

    		Deaktiviert
  9. Klicken Sie auf Weiter.
  10. Klicken Sie auf eine der folgenden Optionen:
    • Speichern und veröffentlichen, um das Tarifpaket zu speichern und zu veröffentlichen. Sie werden aufgefordert, eine Aktivierungszeit einzugeben. Weitere Informationen finden Sie unter Aktivierungsdatum für Ihr Tarifpaket festlegen.
    • Klicken Sie auf Speichern, um einen Entwurf des Tarifpakets zu speichern.
    • Klicken Sie auf Abbrechen, um den Vorgang abzubrechen.

Klassische Apigee-UI

So erstellen Sie einen Tarifpaket über die Benutzeroberfläche:

  1. Führen Sie eine der folgenden Aufgaben aus:
    • Wählen Sie in der seitlichen Navigationsleiste Veröffentlichen > Monetarisierung > Tarifpakete aus und klicken Sie auf Tarifpaket erstellen.
    • Bearbeiten Sie ein API-Produkt und klicken Sie auf Schaltfläche "Hinzufügen" im Abschnitt Tarifpakete.
  2. Geben Sie die Tarifpaketdetails so ein:
    Feld Beschreibung
    Name des Tarifpakets Geben Sie den Namen des Tarifpakets ein.
    API-Produkt Wählen Sie aus dem Drop-down-Menü ein API-Produkt aus, mit dem Sie das Tarifpaket verknüpfen möchten.
  3. Klicken Sie auf Weiter.
  4. Geben Sie die Details zur Abrechnung folgendermaßen ein:
    Feld Beschreibung Standard
    Abrechnungswährung Wählen Sie aus dem Drop-down-Menü die Währung aus, die für die Abrechnung verwendet werden soll. USD
    Abrechnungszeitraum Wählen Sie aus dem Drop-down-Menü die Häufigkeit aus, mit der die Abrechnung beim Kunden erfolgen soll. Monatlich
    Initialisierungsgebühr

    Eine einmalige Gebühr, die jedem Entwickler am Startdatum des Tarifs in Rechnung gestellt wird, also dem Datum, an dem der Entwickler das API-Produkt kauft.

    Wenn Sie die Einrichtungsgebühr in Rechnung stellen möchten, wählen Sie Einrichtungsgebühr in Rechnung stellen aus und geben Sie den zu berechnenden Betrag in das Feld Initialisierungsgebühr ein.

    		 Deaktiviert
  5. Klicken Sie auf Weiter.
  6. Geben Sie die Details zu den Preisen folgendermaßen ein.
    Feld Beschreibung Standard
    Feste wiederkehrende Gebühr Feste wiederkehrende Gebühr pro Einheit aktivieren:
    1. Wählen Sie Feste wiederkehrende Gebühr berechnen aus.
    2. Konfigurieren Sie die feste wiederkehrende Gebühr und die Gebührenhäufigkeit.

    Die Gebühr wird für den ersten Abrechnungszeitraum anteilig berechnet.

    Wenn diese Option aktiviert ist, können Sie eine Vorschau der Auswirkungen der festen wiederkehrenden Gebühr auf die einzeln aufgelisteten Kosten und die Gesamtkosten aufrufen, wie in Vorschau des Tarifpakets ansehen beschrieben.

    Wenn Sie die Gebühr deaktivieren möchten, heben Sie die Auswahl von Feste wiederkehrende Gebühr berechnen auf.

    		Deaktiviert
    Nutzungsbasierte Gebühren Verbrauchsabhängige Preise aktivieren:
    1. Wählen Sie Verbrauchsabhängige Gebühr aus.
    2. Wählen Sie eine der folgenden Optionen aus:
      • Feste Gebühr pro Einheit (feste Gebühr pro genutzter Einheit)
      • Bandbasiert (eine variable Gebühr pro genutzter Einheit, bestimmt durch Nutzungsbereiche)

    • Feste Gebühr pro Einheit: Für jede monetarisierte Transaktion wird eine feste Gebühr berechnet. Geben Sie in das Feld Feste Gebühr pro Einheit einen Wert ein, der für jede Transaktion berechnet werden soll.

    • Bandbasiert: Für jede monetarisierte Transaktion wird eine variable Gebühr berechnet. Das Transaktionsband und die Nutzung bestimmen die Gebühren für eine Transaktion. Ein Band bezieht sich auf einen API-Nutzungsbereich und für jedes Band gilt eine andere Gebühr. Im Abschnitt Ranges of unit consumption können Sie die Bandbereiche und die entsprechenden Gebühren für das Band festlegen. Sie können beliebig viele Bänder angeben, indem Sie auf + BAND klicken.

      Beispiel: Angenommen, Sie möchten die ersten 1.000 API-Aufrufe mit 2 $ pro Aufruf und alle nachfolgenden API-Aufrufe mit 1 $ pro Aufruf abrechnen. Geben Sie dazu im Abschnitt Ranges of unit consumption die folgenden beiden Bänder an:

      • Geben Sie in der ersten Zeile die folgenden Werte ein:
        • Start: 0
        • Ende: 1000
        • Gebühr: 2
      • Geben Sie in der zweiten Zeile die folgenden Werte ein:
        • Start: 1001
        • Ende: Unbegrenzte Einheiten
        • Gebühr: 1

      Wenn ein Entwickler 1.500 APIs nutzt, betragen die Gesamtkosten 2.500 $ ((1000 * 2) + (500 * 1)).

    Wenn Sie nutzungsbasierte Gebühren aktivieren, können Sie eine Vorschau der Auswirkungen des ausgewählten Gebührentyps auf den Gesamtumsatz als Vorschau anzeigen, wie unter Vorschau des Tarifs ansehen beschrieben.

    Wenn Sie die Gebühr deaktivieren möchten, entfernen Sie das Häkchen bei Verbrauchsabhängiges Preismodell.

    Wenn Sie in Ihrer DataCapture-Richtlinie die Monetarisierungsvariable perUnitPriceMultiplier konfiguriert haben, werden die Kosten pro Transaktion in einem beliebigen Typ (feste Gebühr pro Einheit oder bandbasiert) von nutzungsbasierten Gebühren mit dem Wert von perUnitPriceMultiplier multipliziert.

    		Deaktiviert
  7. Klicken Sie auf Weiter.
  8. Geben Sie die Details zur Umsatzbeteiligung so ein:
    Feld Beschreibung Standard
    Umsatzbeteiligung Aktivieren Sie die Umsatzbeteiligung, um einen Prozentsatz des Umsatzes mit Entwicklerpartnern zu teilen.
    1. Wählen Sie Umsatzbeteiligung aktivieren aus.
    2. Geben Sie einen Prozentsatz des Umsatzes, der geteilt werden soll, in das Feld Prozentsatz (%) des Umsatzes, der mit dem Entwickler geteilt werden soll ein.

    Sie können den geteilten Umsatz für jede monetarisierte Transaktion abrufen, indem Sie die Monetarisierungsvariable revShareGrossPrice in Ihrer DataCapture-Richtlinie konfigurieren. Weitere Informationen finden Sie unter Monetarisierungsvariablen.

    Wenn Sie die Umsatzbeteiligung aktivieren, können Sie eine Vorschau der Auswirkungen des eingegebenen Werts für Prozentsatz (%) auf die einzelnen Elemente und auf die Gesamtkosten anzeigen, wie in Vorschau des Tarifs ansehen beschrieben.

    Um die Gebühr zu deaktivieren, deaktivieren Sie Umsatzbeteiligung aktivieren.

    		Deaktiviert
  9. Klicken Sie auf Weiter.
  10. Klicken Sie auf eine der folgenden Optionen:
    • Speichern und veröffentlichen, um das Tarifpaket zu speichern und zu veröffentlichen. Sie werden aufgefordert, eine Aktivierungszeit einzugeben. Weitere Informationen finden Sie unter Aktivierungsdatum für Ihr Tarifpaket festlegen.
    • Klicken Sie auf Speichern, um einen Entwurf des Tarifpakets zu speichern.
    • Klicken Sie auf Abbrechen, um den Vorgang abzubrechen.

Apigee API

Um ein Tarifpaket zu erstellen, senden Sie eine POST-Anfrage an die folgende API: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans

Konfigurieren Sie das Tarifpaket, indem Sie die Pflichtfelder im Anfragetext übergeben, wie unter Ressource: RatePlans beschrieben.

In der folgenden Tabelle sind die Pflichtfelder für die Erstellung eines Entwurfs und eines veröffentlichten Tarifpakets zusammengefasst.

Pflichtfelder für Tarifpaketentwurf Pflichtfelder für veröffentlichtes Tarifpaket
  • apiproduct
  • displayName
  • state
  • apiproduct
  • billingPeriod
  • currencyCode
  • displayName
  • startTime
  • state

Der folgende API-Aufruf erstellt beispielsweise einen Tarifpaketentwurf namens myrateplan5, der dem API-Produkt HelloworldProduct zugeordnet ist: 

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"
    }'

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Create rate plan API.

Vorschau Ihres Tarifpakets in der Benutzeroberfläche ansehen

Basierend auf der Konfiguration für Preise und Umsatzbeteiligung können Sie eine Vorschau der pro Element aufgeführten Kosten und der Gesamtgebühren im Abschnitt Tarifpaketvorschau der Seite "Tarifpaket" aufrufen, wie in der folgenden Abbildung dargestellt.

Beispielwerte eingeben, Ergebnisse in der Tarifpaketvorschau ansehen

Aktualisieren Sie das Feld Nutzung von API-Einheiten im Abschnitt Beispielnutzerdaten, um die Schätzungen in der Vorschau zu ändern. Die Gebühren pro Element und insgesamt werden anhand Ihrer Eingabe aktualisiert.

Aktualisieren Sie die folgenden Felder im Abschnitt Beispielnutzerdaten:

  • Nutzung von API-Einheiten
    Wenn unter Preise die Option Nutzungsbasierte Gebühr berechnen ausgewählt ist.
  • Umsatz
    Wenn unter Umsatzbeteiligung die Option Umsatzbeteiligung aktivieren ausgewählt ist.

Aktivierungs- und Ablaufzeiten für Tarifpakete festlegen

Legen Sie die Aktivierungs- und Ablaufzeit für ein Tarifpaket fest, um anzugeben, wann ein veröffentlichtes Tarifpaket aktiv ist und ob das verbundene API-Produkt für Entwickler in ihren Anwendungen verfügbar ist.

Beachten Sie beim Festlegen von Aktivierungs- und Ablaufzeiten Folgendes:

  • Für ein API-Produkt kann zu einem bestimmten Zeitpunkt immer nur ein Tarifpaket aktiv sein.
  • Sie können mehrere Tarifpakete für dasselbe API-Produkt mit nicht überlappenden Aktivierungs- und Ablaufzeiten veröffentlichen.
  • Sie müssen die Aktivierungszeit für ein Tarifpaket festlegen, bevor es veröffentlicht werden kann.
    Wenn Sie ein Tarifpaket über die Benutzeroberfläche veröffentlichen, werden Sie aufgefordert, die Aktivierungszeit festzulegen, falls sie nicht festgelegt ist.
  • Die Aktivierungszeit muss vor der Ablaufzeit liegen (falls festgelegt) und die Ablaufzeit nach der Aktivierungszeit.
  • Die Ablaufzeit ist nicht erforderlich. Wenn keine Angabe erfolgt, wird die Ablaufzeit standardmäßig auf Never gesetzt (der Tarifplan läuft nie ab).
  • Wenn Sie die Aktivierungs- und Ablaufzeiten über die Benutzeroberfläche festlegen, können Sie nur das Datum und nicht die Uhrzeit (hh:mm:ss:mmm) angeben. Die Uhrzeit für die Aktivierungs- und Ablaufwerte ist standardmäßig auf 12:00:00:000 AM bzw. 11:59:59:999 PM festgelegt.

Legen Sie die Aktivierungs- und Ablaufzeiten für Tarifpakete fest, wie in den folgenden Abschnitten beschrieben.

Apigee in der Cloud Console

So legen Sie die Aktivierungszeit für ein Tarifpaket über die Apigee-Benutzeroberfläche in der Cloud Console fest:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Klicken Sie für das Tarifpaket, für das Sie die Aktivierungszeit festlegen möchten, auf  und dann auf Aktivierung festlegen.
  3. Folgende Optionen sind verfügbar:
    • Unbestimmt, um die Festlegung einer Aktivierungszeit für das Tarifpaket aufzuheben (nur für Tarifpaketentwürfe verfügbar).
    • Sofort, um das Tarifpaket sofort als aktiv festzulegen.
    • In der Zukunft, um das Datum auszuwählen, ab dem das Tarifpaket aktiv ist.
  4. Klicken Sie auf Aktivierung festlegen.
  5. Veröffentlichen Sie das Tarifpaket, sofern es noch nicht veröffentlicht wurde, damit Entwickler es in ihren Anwendungen verwenden können.

So legen Sie die Ablaufzeit für ein Tarifpaket über die Apigee-Benutzeroberfläche in der Cloud Console fest:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Klicken Sie für das Tarifpaket, für das Sie die Ablaufzeit festlegen möchten, auf  und dann auf Ablaufzeit festlegen.
  3. Folgende Optionen sind verfügbar:
    • Nie (Standardeinstellung), um das Tarifpaket nie ablaufen zu lassen.
    • Sofort, um das Tarifpaket sofort als aktiv festzulegen.
    • In der Zukunft, um das Datum auszuwählen, ab dem das Tarifpaket aktiv ist.
  4. Klicken Sie auf Ablaufzeit festlegen.

Klassische Apigee-UI

So legen Sie die Aktivierungszeit für ein Tarifpaket über die Benutzeroberfläche fest:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Klicken Sie für das Tarifpaket, für das Sie die Aktivierungszeit festlegen möchten, auf > Aktivierung festlegen.
  3. Wählen Sie eine der folgenden Optionen aus:
    • Unbestimmt, um die Festlegung einer Aktivierungszeit für das Tarifpaket aufzuheben (nur für Tarifpaketentwürfe verfügbar).
    • Sofort, um das Tarifpaket sofort als aktiv festzulegen.
    • In der Zukunft, um das Datum auszuwählen, ab dem das Tarifpaket aktiv ist.
  4. Klicken Sie auf Aktivierung festlegen.
  5. Veröffentlichen Sie das Tarifpaket, sofern es noch nicht veröffentlicht wurde, damit Entwickler es in ihren Anwendungen verwenden können.

So legen Sie die Ablaufzeit für ein Tarifpaket über die Benutzeroberfläche fest:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Klicken Sie für das Tarifpaket, für das Sie die Ablaufzeit festlegen möchten, auf > Ablaufzeit festlegen.
  3. Wählen Sie eine der folgenden Optionen aus:
    • Nie, um das Tarifpaket nie ablaufen zu lassen.
    • Sofort, um das Tarifpaket sofort als aktiv festzulegen.
    • In der Zukunft, um das Datum auszuwählen, ab dem das Tarifpaket aktiv ist.
  4. Klicken Sie auf Ablaufzeit festlegen.

Apigee API

So legen Sie die Aktivierungs- oder Ablaufzeiten für ein Tarifpaket mithilfe der API fest:

  1. Rufen Sie die Details für das Tarifpaket auf, das Sie aktualisieren möchten.
  2. Verwenden Sie die Antwort, um den Anfragetext zu erstellen, und aktualisieren Sie die folgenden Felder:
    • startTime, um die Aktivierungszeit festzulegen
    • endTime, um die Ablaufzeit festzulegen

  3. Um das Tarifpaket mit der neuen Konfiguration zu aktualisieren, senden Sie eine PUT-Anfrage an die folgende API und übergeben Sie den geänderten Anfragetext in Ihrer Anfrage: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME

Im folgenden Beispiel wird die Aktivierungszeit auf den 1. April 2021 (Epochenzeit 1617302588000) festgelegt: 

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
    }'

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen finden Sie unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Weitere Informationen über die Felder, die Sie im Anfragetext angeben können, finden Sie unter Ressource: RatePlans.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Update rate plan API.

Tarifpakete veröffentlichen

Veröffentlichen Sie Tarifpakete, wie in den folgenden Abschnitten beschrieben.

Apigee in der Cloud Console

Zum Veröffentlichen eines Tarifpakets über die Benutzeroberfläche haben Sie folgende Möglichkeiten:

  • Wenn Sie ein Tarifpaket erstellen oder aktualisieren, können Sie auf Speichern und veröffentlichen klicken, um das Tarifpaket zu speichern und zu veröffentlichen. Sie werden aufgefordert, die Aktivierungszeit festzulegen.
  • Rufen Sie die Seite „Tarifpakete“ auf und klicken Sie für den Tarifpaketentwurf, den Sie veröffentlichen möchten, auf  und dann auf Veröffentlichen.

    Diese Option wird nur angezeigt, wenn Sie eine Aktivierungszeit für den Tarifpaketentwurf festgelegt haben.

Klassische Apigee-UI

Zum Veröffentlichen eines Tarifpakets über die Benutzeroberfläche haben Sie folgende Möglichkeiten:

  • Wenn Sie ein Tarifpaket erstellen oder aktualisieren, können Sie auf Speichern und veröffentlichen klicken, um das Tarifpaket zu speichern und zu veröffentlichen. Sie werden aufgefordert, die Aktivierungszeit festzulegen.
  • Rufen Sie die Seite "Tarifpakete" auf und klicken Sie für den Tarifpaketentwurf, den Sie veröffentlichen möchten, auf > Veröffentlichen.

    Diese Option wird nur angezeigt, wenn Sie eine Aktivierungszeit für den Tarifpaketentwurf festgelegt haben.

Apigee API

So veröffentlichen Sie ein Tarifpaket mithilfe der API:

  1. Rufen Sie die Details für das Tarifpaket auf, das Sie veröffentlichen möchten.
  2. Verwenden Sie die Antwort, um den Anfragetext zu erstellen, und aktualisieren Sie die folgenden Felder:
    • Legen Sie den Status auf VERÖFFENTLICHT fest.
    • Legen Sie für startTime die Aktivierungszeit in Millisekunden seit der Epoche fest.
    • Legen Sie optional für endTime die Ablaufzeit in Millisekunden seit der Epoche oder Nie fest. Wenn keine Angabe gemacht wird, wird standardmäßig die Ablaufzeit Never verwendet.
    • Legen Sie die anderen Felder fest, die Sie beibehalten möchten.

  3. Senden Sie zum Veröffentlichen des Tarifpakets eine PUT-Anfrage an die folgende API und übergeben Sie den geänderten Anfragetext in Ihrer Anfrage: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME

Im folgenden Beispiel wird der Status des Tarifpakets rateplan1 in PUBLISHED geändert und die Aktivierungszeit auf den 1. April 2021 festgelegt, angegeben in Millisekunden seit der Epoche: 

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
    }'

Weitere Informationen über die Felder, die Sie im Anfragetext angeben können, finden Sie unter Ressource: RatePlans.

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Update rate plan API.

Veröffentlichte Tarifpakete in den Entwurfsstatus verschieben

Verschieben Sie die veröffentlichten Tarifpakete in den Entwurfsstatus, wie in den folgenden Abschnitten beschrieben.

Apigee in der Cloud Console

So verschieben Sie ein veröffentlichtes Tarifpaket mithilfe der Apigee-Benutzeroberfläche in der Cloud Console in den Entwurfsstatus:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Wählen Sie und dann In Entwürfe verschieben aus.

Das Tarifpaket wird aktualisiert und das Feld Status wird in Entwurf geändert.

Klassische Apigee-UI

So verschieben Sie einen veröffentlichtes Tarifpaket mithilfe der Benutzeroberfläche in den Entwurfsstatus:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Wählen Sie > In Entwürfe verschieben aus.

Das Tarifpaket wird aktualisiert und das Feld Status wird in Entwurf geändert.

Apigee API

So verschieben Sie einen veröffentlichtes Tarifpaket mithilfe der API in den Entwurfsstatus:

  1. Rufen Sie die Details für das veröffentlichte Tarifpaket auf, das Sie in den Entwurfsstatus verschieben möchten.
  2. Verwenden Sie die Antwort, um den Anfragetext zu erstellen, und aktualisieren Sie die folgenden Felder:
    • Legen Sie den Status auf ENTWURF fest.
    • Legen Sie die anderen Felder fest, die Sie beibehalten möchten.

  3. Wenn Sie das veröffentlichte Tarifpaket in den Entwurfsstatus verschieben möchten, senden Sie eine PUT-Anfrage an die folgende API und übergeben Sie den geänderten Anfragetext in Ihrer Anfrage: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME

Das folgende Beispiel ändert den Status des Tarifpakets rateplan1 in 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
    }'

Weitere Informationen über die Felder, die Sie im Anfragetext angeben können, finden Sie unter Ressource: RatePlans.

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Update rate plan API.

Tarifpakete aktualisieren

Aktualisieren Sie Tarifpakete, wie in den folgenden Abschnitten beschrieben. Weitere Informationen:

Aktualisieren Sie ein Tarifpaket, wie in den folgenden Abschnitten beschrieben.

Apigee in der Cloud Console

So aktualisieren Sie ein Tarifpaket über die Benutzeroberfläche:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Klicken Sie in der Liste auf den Namen des Tarifpakets, das Sie aktualisieren möchten.
  3. Aktualisieren Sie das Tarifpaket nach Bedarf.
  4. Klicken Sie auf eine der folgenden Optionen:
    • Speichern und veröffentlichen, um das Tarifpaket zu speichern und zu veröffentlichen. Sie werden aufgefordert, eine Aktivierungszeit einzugeben. Weitere Informationen finden Sie unter Aktivierungszeit für ein Tarifpaket festlegen.
    • Klicken Sie auf Speichern, um einen Entwurf des Tarifpakets zu speichern.
    • Klicken Sie auf Abbrechen, um die Aktualisierungen abzubrechen.

Klassische Apigee-UI

So aktualisieren Sie ein Tarifpaket über die Benutzeroberfläche:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Klicken Sie in der Liste auf den Namen des Tarifpakets, das Sie aktualisieren möchten.
  3. Aktualisieren Sie das Tarifpaket nach Bedarf.
  4. Klicken Sie auf eine der folgenden Optionen:
    • Speichern und veröffentlichen, um das Tarifpaket zu speichern und zu veröffentlichen. Sie werden aufgefordert, eine Aktivierungszeit einzugeben. Weitere Informationen finden Sie unter Aktivierungszeit für ein Tarifpaket festlegen.
    • Klicken Sie auf Speichern, um einen Entwurf des Tarifpakets zu speichern.
    • Klicken Sie auf Abbrechen, um die Aktualisierungen abzubrechen.

Apigee API

So aktualisieren Sie ein Tarifpaket mithilfe der API:

  1. Rufen Sie die Details für das Tarifpaket auf, das Sie aktualisieren möchten.
  2. Verwenden Sie die Antwort, um den Anfragetext zu erstellen und aktualisieren Sie bei Bedarf weitere Konfigurationseinstellungen.

  3. Um ein Tarifpaket zu aktualisieren, senden Sie eine PUT-Anfrage an die folgende API und übergeben Sie den geänderten Anfragetext in Ihrer Anfrage: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME

Im Folgenden wird beispielsweise die nutzungsbasierte Gebühr in 5 und der Prozentsatz der Umsatzbeteiligung in 6,5 % geändert. Alle anderen Konfigurationseinstellungen werden einbezogen, um sicherzustellen, dass sie beibehalten werden: 

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":"5",
          "nanos":0
        }
    }],
    "revenueShareType":"FIXED",
    "revenueShareRates":[{
       "sharePercentage":"6.5"
    }],
    "state":"DRAFT",
    "startTime": 1617302588000
    }'

Weitere Informationen über die Felder, die Sie im Anfragetext angeben können, finden Sie unter Ressource: RatePlans.

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe:

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

Weitere Informationen finden Sie unter Update rate plan API.

Tarifpakete klonen

Tarifpakete klonen, um anhand vorhandener Tarifpakete weitere zu erstellen

Apigee in der Cloud Console

So klonen Sie ein Tarifpaket über die UI:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Wählen Sie und dann Klonen aus.
  3. Aktualisieren Sie die Felder Tarifpaketname und API-Produkt.
  4. Klicken Sie auf Klonen.

Das Preismodell wird der Liste der Tarifpakete hinzugefügt.

Klassische Apigee-UI

So klonen Sie ein Tarifpaket über die UI:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Wählen Sie > Klonen aus.
  3. Aktualisieren Sie die Felder Tarifpaketname und API-Produkt nach Bedarf.
  4. Klicken Sie auf Klonen.

Das Preismodell wird der Liste der Tarifpakete hinzugefügt.

Apigee API

So klonen Sie ein Tarifpaket mithilfe der API:

  1. Rufen Sie die Details für das Tarifpaket auf, das Sie klonen möchten.
  2. Verwenden Sie die Antwort, um den Anfragetext zu erstellen, und aktualisieren Sie die folgenden Felder:
    • Entfernen Sie das Feld Name.
    • Aktualisieren Sie bei Bedarf weitere Konfigurationseinstellungen.
  3. Erstellen Sie ein Tarifpaket, indem Sie den geänderten Anfragetext in Ihrer Anfrage übergeben.

Tarifpakete löschen

Das Löschen eines Tarifpakets ist endgültig. Das Tarifpaket wird sofort gelöscht und kann nicht wiederhergestellt werden.

Löschen Sie Tarifpakete, wie in den folgenden Abschnitten beschrieben.

Apigee in der Cloud Console

So löschen Sie ein Tarifpaket über die Benutzeroberfläche:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Wählen Sie für das Tarifpaket, das Sie löschen möchten, und dann Löschen aus.
  3. Prüfen Sie, ob es sich um das richtige Tarifpaket handelt, das Sie löschen möchten, und klicken Sie auf Löschen.

Das Tarifpaket wird gelöscht und aus der Liste entfernt.

Klassische Apigee-UI

So löschen Sie ein Tarifpaket über die Benutzeroberfläche:

  1. Rufen Sie die Seite "Tarifpakete" auf.
  2. Wählen Sie für das Tarifpaket, das Sie löschen möchten, > Löschen aus.
  3. Wenn Sie dazu aufgefordert werden, den Löschvorgang zu bestätigen, klicken Sie auf Löschen.

Das Tarifpaket wird gelöscht und aus der Liste entfernt.

Apigee API

Wenn Sie ein Tarifpaket löschen möchten, senden Sie eine DELETE-Anfrage an die folgende API: https://apigee.googleapis.com/v1/organizations/$ORG/apiproducts/$APIPRODUCT/rateplans/$RATEPLAN_NAME.

Informationen zum Ermitteln des Namens des Tarifpakets, das in den Ressourcenpfad übergeben werden soll, finden Sie unter Tarifpakete in einer Organisation auflisten.

Im folgenden Beispiel wird das Tarifpaket mit dem Namen cc6252c0-c5d0-4aaf-85f2-203ec8fa5707 und dem Anzeigenamen myrateplan3 gelöscht: 

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

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt, wie unter OAuth 2.0-Zugriffstoken abrufen beschrieben. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwortausgabe:

{
    "name": "93ca14aa-7a48-4384-ae09-c85a0e8a8df8",
    "apiproduct": "HelloworldProduct",
    "displayName": "myrateplan3",
    "billingPeriod": "MONTHLY",
    "currencyCode": "USD",
    "consumptionPricingType": "FIXED_PER_UNIT",
    "consumptionPricingRates": [
        {
            "fee": {
                "currencyCode": "USD",
                "units": "5"
            }
        }
    ],
    "revenueShareType": "FIXED",
    "revenueShareRates": [
        {
            "sharePercentage": 6.5
        }
    ],
    "state": "DRAFT",
    "startTime": "1617302588000"
}

Weitere Informationen finden Sie unter Delete rate plans API.