Method: subscriptions.changePlan

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

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.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di ChangePlanRequest.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Subscription.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/apps.order

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

ChangePlanRequest

Modello JSON per la richiesta RPC Subscriptions.changePlan.

Rappresentazione JSON 
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
Campi
kind

string

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
  • FLEXIBLE - Il piano flessibile
  • TRIAL: il piano di prova senza costi di 30 giorni

seats

object (Seats)

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.