Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
Einführung
Nach der Veröffentlichung eines vorhandenen Preisplans können Sie nur das Enddatum der Property ändern. Sie können jedoch eine neue Version des Plans erstellen, die geänderte Properties enthält, z. B. geänderte Preisplanpreise. Sie können festlegen, dass die Überarbeitung zu einem späteren Zeitpunkt in Kraft tritt. Der ursprüngliche Preisplan endet mit Inkrafttreten der Überarbeitung.
Angenommen, Sie haben einen Standardpreisplan erstellt, der am 31. Dezember 2019 abläuft, und ihn durch einen anderen Tarif ersetzen, der am 1. Januar 2020 in Kraft tritt. Dazu erstellen Sie einen zukünftigen Preisplan und richten ihn so ein, dass er am 1. Januar 2020 in Kraft tritt.
Wenn für den aktuellen Preisplan kein Enddatum festgelegt ist, können Sie einen vorhandenen Preisplan durch einen zukünftigen Preisplan ersetzen, der bereits am heutigen Tag beginnt. Sie müssen den aktuellen Preisplan ablaufen, wie unter Veröffentlichten Preisplan ablaufen beschrieben.
Entwickler werden über den überarbeiteten Preisplan informiert. Entwickler, die den ursprünglichen Preisplan akzeptieren, werden automatisch für die Überarbeitung registriert. Sie haben jedoch die Möglichkeit, die Überarbeitung abzulehnen.
Sie können über die Verwaltungs-UI oder die Monetarisierungs-API einen Tarif mit zukünftigen Preisen erstellen. Dies wird in den folgenden Abschnitten beschrieben.
Zukünftigen Preisplan über die UI erstellen
Erstellen Sie einen zukünftigen Preisplan, wie unten beschrieben.
Edge
Führen Sie die folgenden Schritte aus, um mithilfe der Edge-Benutzeroberfläche eine zukünftige Version eines Tarifplans zu erstellen, der irgendwann nach heute beginnt.
- Positionieren Sie den Cursor auf der Seite Preispläne in der Zeile des Preisplans, für den Sie einen zukünftigen Preisplan erstellen möchten.
Der Preisplan muss ein Enddatum haben. - Klicken Sie auf +Future.
- Wählen Sie im Bereich Zukünftiger Preisplan eine der folgenden Optionen aus:
- Vollständigen Vertragszeitraum am neuen Datum des Inkrafttretens neu starten: Der zukünftige Preisplan tritt am Datum des Inkrafttretens in Kraft. Der Verlängerungszeitraum des zukünftigen Preisplans entspricht dem des aktuellen Preisplans.
- Die für den vorherigen Vertrag aufgewendete Zeit vom neuen Zeitraum am Datum des Inkrafttretens abziehen: Der zukünftige Preisplan tritt am Datum des Inkrafttretens in Kraft. Die für die Nutzung des aktuellen Preisplans benötigte Zeit wird vom Verlängerungszeitraum des zukünftigen Preisplans abgezogen. Wenn ein Entwickler also das aktuelle Abo 3 Monate lang verwendet, wird der Verlängerungszeitraum um 3 Monate verkürzt.
- Konfigurieren Sie im oberen Bereich die folgenden Felder:
Hinweis: Andere Felder sind schreibgeschützt.Feld Beschreibung Standard Erforderlich Name des Tarifpakets Name Ihres Preisplans.
Hinweis: Der Name muss nicht mit dem ursprünglichen Preisplannamen übereinstimmen.
Vorhandener Planname Ja Startdatum Datum, an dem der Preisplan in Kraft tritt. Geben Sie ein Startdatum ein oder wählen Sie im Kalender ein Datum aus. Heute Nein Enddatum Datum, an dem der Preisplan endet. Wenn Sie ein Enddatum festlegen möchten, aktivieren Sie den Umschalter Hat Enddatum und geben Sie ein Enddatum ein oder wählen Sie ein Datum mithilfe des Kalenders aus. Hinweis: Der Preisplan gilt bis zum Tagesende des angegebenen Datums. Wenn Sie beispielsweise einen Preisplan am 1. Dezember 2018 auslaufen lassen möchten, sollten Sie den Wert "endDate" auf 2018-11-30 festlegen. In diesem Fall läuft der Preisplan am Ende des Tages am 30. November 2018 ab. Alle Anfragen am 1. Dezember 2018 werden blockiert.
Keine Nein Für Portale sichtbar Legen Sie fest, ob der Preisplan öffentlich oder privat sein soll. Weitere Informationen finden Sie unter Öffentliche und private Preispläne im Vergleich. Aktiviert Nein - Konfigurieren Sie Gebühren für den Preisplan. Weitere Informationen finden Sie unter Gebühren konfigurieren.
Hinweis: Gilt nicht für anpassbare Benachrichtigungspläne. - Wenn Sie ein Produktpaket auswählen, das mehr als ein API-Produkt enthält, legen Sie im Bereich Spezifischer oder allgemeiner Preisplan die folgenden Einstellungen fest:
Hinweis: Dieser Schritt gilt nicht für anpassbare Benachrichtigungspläne.
Feld Beschreibung Standard Jedes Produkt einzeln konfigurieren Flag, das angibt, ob für jedes API-Produkt ein individueller Tarifplan konfiguriert werden soll. Deaktiviert Das Freemium-Angebot für jedes Produkt einzeln konfigurieren Flag, das angibt, ob für jedes API-Produkt ein Freemium-Tarif konfiguriert werden soll. Deaktiviert Produkt auswählen Wenn Sie eine oder beide Flags aktivieren, müssen Sie jedes Produkt einzeln aus der Drop-down-Liste auswählen und die zugehörigen Preisplandetails konfigurieren. Hinweis: Achten Sie darauf, dass Sie alle Produkte im Produktset konfigurieren.
– - Konfigurieren Sie die Preisplandetails basierend auf dem ausgewählten Preisplantyp:
- Klicken Sie auf eine der folgenden Optionen:
Schaltfläche Beschreibung Entwurf aktualisieren Speichern Sie den Preisplan als Entwurf. Der Preisplan ist für App-Entwickler erst sichtbar, wenn Sie ihn veröffentlichen. Sie können jedes Feld in einem Entwurf des Preisplans bearbeiten.
Entwurf veröffentlichen Veröffentlichen Sie den Plan. Hinweis: Nach dem Veröffentlichen eines Preisplans können Sie das Enddatum nur ändern, wenn es noch nicht festgelegt wurde. Sie können einen Preisplan nach der Veröffentlichung nicht mehr löschen. Sie können ihn jedoch ablaufen und durch einen zukünftigen Preisplan ersetzen, wie unter Veröffentlichten Preisplan ablaufen beschrieben.
Classic Edge (Private Cloud)
Führen Sie die folgenden Schritte aus, um über die Classic Edge-Benutzeroberfläche eine zukünftige Version eines Preisplans zu erstellen, der irgendwann nach heute beginnt.
- Klicken Sie im Paketkatalog in der Spalte "Entwurf/Future" für den Preisplan, den Sie ersetzen möchten, auf +Future.
Dadurch wird ein zukünftiges Preisplanfenster geöffnet.
Der Hauptunterschied zwischen einem zukünftigen Preisplanfenster und einem aktuellen Preisplanfenster besteht im Hinzufügen eines Abschnitts für bestehende Abonnenten.
- Wie bei jedem Preisplan gilt:
- Geben Sie in das Feld Preisplanname einen Namen für den Plan ein. Der Name muss nicht mit dem Namen des ursprünglichen Preisplans übereinstimmen.
- Gebühren für einen Tarifplan konfigurieren (optional).
- Konfigurieren Sie die Preisplandetails basierend auf dem ausgewählten Preisplantyp:
- Geben Sie ein Datum an, an dem der zukünftige Preisplan wirksam wird (siehe Preispläne veröffentlichen) und ein Enddatum. Sie können auch „Kein Enddatum“ auswählen, wenn der zukünftige Preisplan nicht an einem bestimmten Datum enden soll. Wenn für den aktuellen Plan ein Enddatum festgelegt ist, muss das Gültigkeitsdatum des zukünftigen Plans nach dem Enddatum des aktuellen Plans liegen.
- Wähle im Abschnitt „Bestehende Abonnenten“ eine der folgenden Optionen aus:
- Beginn der vollständigen Vertragslaufzeit am neuen Datum des Inkrafttretens. Der zukünftige Preisplan tritt zum Datum des Inkrafttretens in Kraft. Der Verlängerungszeitraum des zukünftigen Preisplans entspricht dem des aktuellen Preisplans.
- Die für den vorherigen Vertrag aufgewendete Zeit wird zum Datum des Inkrafttretens von der neuen Periode abgezogen. Der zukünftige Preisplan tritt zum Datum des Inkrafttretens in Kraft. Die für die Nutzung des aktuellen Preisplans benötigte Zeit wird vom Verlängerungszeitraum des zukünftigen Preisplans abgezogen. Wenn ein Entwickler also das aktuelle Abo 3 Monate lang verwendet, wird der Verlängerungszeitraum um 3 Monate verkürzt.
- Geben Sie im Feld Gültigkeitsdatum ein Startdatum ein, das nach dem Enddatum des vorhandenen Preisplans liegt.
Zukünftigen Tarif mit der API erstellen
Sie können mit der API einen zukünftigen Preisplan erstellen. Senden Sie dazu eine POST-Anfrage an /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision.
Wobei:
{org_id}ist der Name der Organisation.{package_id}ist die Identifizierung des API-Pakets.{plan_Id}ist die Kennzeichnung des Preisplans.
parentRatePlangibt die ID des ursprünglichen Preisplans an.startDategibt das Datum an, an dem der neue Plan in Kraft tritt.
Der Name des zukünftigen Preisplans muss nicht mit dem Namen des ursprünglichen Tarifs übereinstimmen. Wenn Sie das für die Entwickler aufgezeichnete ursprüngliche Startdatum beibehalten möchten, setzen Sie das Flag keepOriginalStartDate auf true. Die Standardeinstellung für dieses Flag ist false.
Weitere Informationen zu den Konfigurationseinstellungen finden Sie unter Konfigurationseinstellungen für Preispläne.
Die folgende Anfrage erstellt beispielsweise einen zukünftigen Preisplan:
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"parentRatePlan": {
"id": "monetization_package_flat_rate_card_plan_1379513833409"
},
"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": "myorg"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.05",
"startUnit": "0"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2014-01-01 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \
-u email:password