Consente di aggiornare un piano di abbonamento. Utilizza questo metodo per aggiornare un piano per una prova di 30 giorni o un abbonamento con piano flessibile a un piano con impegno annuale con pagamenti mensili o annuali.
Le modalità di aggiornamento di un piano variano in base al piano e ai prodotti. Per ulteriori informazioni, consulta la descrizione in Gestire gli abbonamenti.
Richiesta HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan
Può trattarsi del nome di dominio principale del cliente o dell'identificatore univoco del cliente. Se il nome di dominio di un cliente cambia, non è possibile utilizzare il nome di dominio precedente per accedere al cliente, ma è sempre possibile utilizzare l'identificatore univoco del cliente (restituito dall'API). Ti consigliamo di archiviare l'identificatore univoco nei tuoi sistemi, ove applicabile.
subscriptionId
string
Questa proprietà è obbligatoria. subscriptionId è l'identificatore dell'abbonamento ed è univoco per ogni cliente. Poiché un valore subscriptionId cambia quando un abbonamento viene aggiornato, ti consigliamo di non utilizzare questo ID come chiave per i dati permanenti. Inoltre, subscriptionId può essere trovato utilizzando il metodo recupera tutti gli abbonamenti del rivenditore.
Identifica la risorsa come richiesta di un piano di modifica dell'abbonamento. Valore: subscriptions#changePlanRequest
planName
string
La proprietà planName è obbligatoria. Questo è il nome del piano di pagamento dell'abbonamento. Per ulteriori informazioni sui piani di pagamento di Google, consulta i concetti delle API.
I valori possibili sono:
ANNUAL_MONTHLY_PAY: il piano di impegno annuale con pagamenti mensili
ANNUAL_YEARLY_PAY: il piano con impegno annuale con pagamenti annuali
Questa proprietà è obbligatoria. La proprietà delle utenze corrisponde al numero di licenze delle utenze utente.
purchaseOrderId
string
Questa proprietà è facoltativa. Le informazioni sugli ordini di acquisto possono essere utilizzate dai rivenditori per il monitoraggio della loro azienda. Se viene assegnato un valore purchaseOrderId, questo viene visualizzato nelle risposte dell'API e nella fattura. La proprietà accetta fino a 80 caratteri di testo normale.
dealCode
string
Codice emesso da Google (massimo 100 caratteri) per prezzi scontati per i piani di abbonamento. Per poter usufruire della tariffa scontata, il codice deal deve essere incluso nella richiesta changePlan. Questa proprietà è facoltativa. Se è già stato aggiunto un codice promozionale a un abbonamento, questa proprietà potrebbe essere lasciata vuota e continuerà a essere applicata la tariffa scontata esistente (se non è vuota, fornisci solo il codice promozionale già presente nell'abbonamento). Se non è mai stato aggiunto un codice promozionale a un abbonamento e questa proprietà viene lasciata vuota, verrà applicato il prezzo normale.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-09-09 UTC."],[[["Updates a subscription's plan, allowing changes from trial or flexible plans to annual commitments with monthly or yearly payments, with varying update processes based on the specific plan and products."],["Requires sending a POST request to a specific URL, including the `customerId` and `subscriptionId` as path parameters."],["The request body must contain a `ChangePlanRequest` object specifying the desired plan name, number of seats, and optional purchase order ID and deal code."],["Successful responses return a `Subscription` object representing the updated subscription."],["Requires authorization with the `https://www.googleapis.com/auth/apps.order` scope."]]],[]]
