Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Introduzione
Una volta pubblicato un piano tariffario esistente, l'unica proprietà che puoi modificare è la data di fine. Tuttavia, puoi creare una nuova versione del piano che include le proprietà modificate, ad esempio le tariffe del piano tariffario. Puoi impostare la revisione in modo che entri in vigore in una data futura. Il piano tariffario originale termina quando entrerà in vigore la revisione.
Ad esempio, supponi di aver creato un piano tariffario standard che scade il 31 dicembre 2019 e di volerlo sostituire con un altro piano che entrerà in vigore il 1° gennaio 2020. Per farlo, crea un piano tariffario futuro e impostalo in modo che entri in vigore il 1° gennaio 2020.
Se non è impostata una data di fine per il piano tariffario attuale, puoi sostituire un piano tariffario esistente con un piano tariffario futuro che inizia a partire da oggi. Dovrai far scadere il piano tariffario corrente, come descritto in Scadenza di un piano tariffario pubblicato.
Gli sviluppatori vengono informati del piano tariffario rivisto. Gli sviluppatori che accettano il piano tariffario originale vengono registrati automaticamente per la revisione (ma hanno la possibilità di rifiutare la revisione).
Puoi creare un piano tariffario futuro utilizzando l'interfaccia utente di gestione o l'API di monetizzazione, come descritto nelle sezioni seguenti.
Creare un piano tariffario futuro utilizzando l'interfaccia utente
Crea un piano tariffario futuro, come descritto di seguito.
Perimetrale
Per creare una versione futura di un piano tariffario che inizia dopo oggi utilizzando l'interfaccia utente Edge, segui questi passaggi.
- Nella pagina Piani tariffari,
posiziona il cursore all'interno della riga associata al piano tariffario per cui vuoi creare un piano tariffario futuro.
Il piano tariffario deve avere una data di fine. - Fai clic su +Futuro.
- Nella sezione Piano tariffario futuro, seleziona una delle seguenti opzioni:
- Riavvia l'intero periodo del contratto alla nuova data di validità: il piano tariffario futuro entrerà in vigore a partire dalla data di validità. La durata di rinnovo del piano tariffario futuro è la stessa di quella del piano tariffario attuale.
- Detrazione del tempo speso sul contratto precedente dal nuovo periodo, alla data di validità: il piano tariffario futuro entrerà in vigore a partire dalla data di validità. Il tempo dedicato all'utilizzo del piano tariffario attuale viene detratto dal termine di rinnovo del piano tariffario futuro. Ciò significa che se uno sviluppatore utilizza il piano attuale per 3 mesi e il periodo di rinnovo viene ridotto di 3 mesi.
- Configura i seguenti campi nel riquadro in alto:
Nota: gli altri campi sono di sola lettura.Campo Descrizione Predefinito Obbligatorie Nome piano tariffario Nome del piano tariffario.
Nota: il nome non deve necessariamente corrispondere al nome del piano tariffario originale.
Nome piano esistente Sì Data di inizio Data di entrata in vigore del piano tariffario. Inserisci una data di inizio o selezionane una utilizzando il calendario. Oggi No Data di fine Data di fine del piano tariffario. Per specificare una data di fine, attiva l'opzione Ha una data di fine,attiva/disattiva e inserisci una data di fine oppure seleziona una data utilizzando il calendario. Nota: il piano tariffario sarà attivo fino alla fine della giornata della data specificata. Ad esempio, se vuoi far scadere un piano tariffario il 1° dicembre 2018, devi impostare il valore endDate su 2018-11-30. In questo caso, il piano tariffario scadrà alla fine della giornata, il 30 novembre 2018; tutte le richieste del 1° dicembre 2018 verranno bloccate.
Nessuno No Visibile ai portali Imposta se il piano tariffario è pubblico o privato. Consulta la sezione Piani tariffari pubblici e privati. Abilitati No - Configura le tariffe per il piano tariffario. Consulta Configurazione delle tariffe.
Nota: non applicabile ai piani di notifica modificabili. - Se selezioni un pacchetto di prodotti che contiene più di un prodotto API, imposta le seguenti preferenze nella sezione Piano tariffario specifico o generico:
Nota: questo passaggio non è applicabile ai piani di notifica modificabili.
Campo Descrizione Predefinito Configurare ogni prodotto singolarmente Flag che specifica se configurare un singolo piano tariffario per ogni prodotto API. Disabilitata Configurare l'offerta freemium di ogni prodotto singolarmente Flag che specifica se configurare un piano freemium per ogni prodotto API. Disabilitata Seleziona un prodotto Se attivi uno o entrambi i flag, devi selezionare ogni prodotto singolarmente dall'elenco a discesa e configurare i dettagli del relativo piano tariffario. Nota: assicurati di configurare tutti i prodotti che contiene.
N/A - Configura i dettagli del piano tariffario in base al tipo di piano tariffario selezionato:
- Fai clic su una delle seguenti opzioni:
Pulsante Descrizione Aggiorna bozza Salva il piano tariffario come bozza. Il piano tariffario non sarà visibile agli sviluppatori di app finché non lo pubblichi. Puoi modificare qualsiasi campo in un piano tariffario in bozza.
Pubblica bozza Pubblica il piano. Nota: dopo aver pubblicato un piano tariffario, puoi modificare la data di fine solo se non è già impostata. Non puoi eliminare un piano tariffario dopo la sua pubblicazione, ma puoi far scadere il piano tariffario e sostituirlo con un piano tariffario futuro, come descritto nella sezione Scadenza di un piano tariffario pubblicato.
Classic Edge (private cloud)
Per creare una versione futura di un piano tariffario che inizi dopo oggi utilizzando l'interfaccia utente classica di Edge, procedi nel seguente modo.
- Nel catalogo dei pacchetti, fai clic su +Futuro nella colonna Bozza/Futuro per il piano tariffario da sostituire.
Viene visualizzata la finestra Piano tariffario futuro.
La differenza principale tra una finestra del piano tariffario futuro e una finestra del piano tariffario corrente è l'aggiunta di una sezione Abbonati esistenti.
- Come per qualsiasi piano tariffario:
- Inserisci un nome per il piano nel campo Nome piano tariffario. Il nome non deve corrispondere a quello del piano tariffario originale.
- (Facoltativo) Configurare le tariffe per un piano tariffario.
- Configura i dettagli del piano tariffario in base al tipo di piano tariffario selezionato:
- Specifica una data di entrata in vigore del piano futuro (consulta la sezione Piani tariffari di pubblicazione) e una data di fine (puoi anche selezionare "Nessuna data di fine" se non vuoi che il piano tariffario futuro termini in una data specifica). Se per il piano attuale è impostata una data di fine, la data di validità del piano futuro deve essere successiva alla data di fine del piano corrente.
- Nella sezione Sottoscrittori esistenti, seleziona una delle seguenti opzioni:
- Riavvia l'intero periodo del contratto alla nuova data di validità. Il piano tariffario futuro entrerà in vigore dalla data di validità. La durata di rinnovo del piano tariffario futuro è la stessa di quella del piano tariffario attuale.
- Deduci il tempo speso sul contratto precedente dal nuovo periodo, alla data di validità. Il piano tariffario futuro entrerà in vigore dalla data di validità. Il tempo dedicato all'utilizzo del piano tariffario attuale viene detratto dal termine di rinnovo del piano tariffario futuro. Ciò significa che se uno sviluppatore utilizza il piano attuale per 3 mesi e il periodo di rinnovo viene ridotto di 3 mesi.
- Nel campo Data di validità, inserisci una data di inizio successiva alla data di fine del piano tariffario esistente.
Creare un piano tariffario futuro utilizzando l'API
Puoi creare un piano tariffario futuro utilizzando l'API inviando una richiesta POST a
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision.
Dove:
{org_id}è il nome dell'organizzazione.{package_id}è l'identificazione del pacchetto API.{plan_Id}è il nome del piano tariffario.
parentRatePlanspecifica l'ID del piano tariffario originale.startDatespecifica la data di entrata in vigore del nuovo piano.
Il nome del piano tariffario futuro non deve necessariamente corrispondere a quello del piano originale. Se vuoi mantenere la data di inizio originale registrata per gli sviluppatori, imposta il flag keepOriginalStartDate su true. Il valore predefinito di questo flag è false.
Per saperne di più sulle impostazioni di configurazione, consulta la sezione Impostazioni di configurazione per i piani tariffari.
Ad esempio, la seguente richiesta crea un piano tariffario futuro:
$ 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