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 di impegno annuale con pagamenti mensili o annuali.

Le modalità di aggiornamento di un piano variano a seconda del piano e dei 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, il nome di dominio precedente non può essere utilizzato per accedere al cliente, ma è sempre possibile utilizzare l'identificatore univoco del cliente (come restituito dall'API). Ti consigliamo di archiviare l'identificatore univoco nei tuoi sistemi, ove applicabile.
subscriptionId

string

Questa è una proprietà obbligatoria. subscriptionId è l'identificatore dell'abbonamento ed è univoco per ciascun cliente. Poiché un subscriptionId cambia quando viene aggiornato un abbonamento, consigliamo di non utilizzare questo ID come chiave per i dati permanenti. Inoltre, subscriptionId è reperibile 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 alle autorizzazioni.

ChangePlanRequest

Modello JSON per la richiesta subscriptions.changePlan rpc.

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

string

Identifica la risorsa come richiesta del 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 di impegno annuale con pagamenti annuali
  • FLEXIBLE - Il piano flessibile
  • TRIAL: il piano di prova senza costi di 30 giorni

seats

object (Seats)

Questa è una proprietà obbligatoria. La proprietà delle utenze corrisponde al numero di licenze delle utenze.
purchaseOrderId

string

Si tratta di una proprietà facoltativa. Le informazioni relative all'ordine di acquisto (PO) devono essere utilizzate dai rivenditori per il monitoraggio dell'utilizzo da parte della loro azienda. Se viene fornito 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 rilasciato da Google (massimo 100 caratteri) per i prezzi scontati sui piani di abbonamento. Per poter usufruire della tariffa scontata, è necessario includere il codice promozione nella richiesta changePlan. Questa proprietà è facoltativa. Se è già stato aggiunto un codice promozionale a un abbonamento, questa proprietà potrebbe essere lasciata vuota e verrà comunque 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, verranno applicati i prezzi normali.