Method: subscriptions.changePlan

Aggiorna un piano di abbonamento. Utilizza questo metodo per aggiornare un piano per una prova di 30 giorni o un abbonamento a un piano flessibile in un piano con impegno annuale con pagamenti mensili o annuali.

Il modo in cui viene aggiornato un piano varia 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ò essere il nome di dominio principale del cliente o il suo identificatore univoco. Se il nome di dominio di un cliente cambia, il vecchio nome di dominio non può essere utilizzato per accedere al cliente, ma è sempre possibile utilizzare l'identificatore univoco del cliente (come restituito dall'API). Ti consigliamo di memorizzare l'identificatore univoco nei tuoi sistemi, se applicabile.
subscriptionId

string

Questa è una proprietà obbligatoria. subscriptionId è l'identificatore dell'abbonamento ed è univoco per ogni cliente. Poiché un subscriptionId cambia quando un abbonamento viene aggiornato, ti consigliamo di non utilizzare questo ID come chiave per i dati permanenti. 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 modifica del piano di abbonamento. Valore: subscriptions#changePlanRequest
planName

string

La proprietà planName è obbligatoria. Si tratta del nome del piano di pagamento dell'abbonamento. Per ulteriori informazioni sui piani di pagamento di Google, consulta Concetti API.

I valori possibili sono:

  • ANNUAL_MONTHLY_PAY: il piano di impegno annuale con pagamenti mensili
  • ANNUAL_YEARLY_PAY: il piano con impegno annuale e 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à seats indica il numero di licenze per utenti.
purchaseOrderId

string

Questa è una proprietà facoltativa. Queste informazioni sull'ordine di acquisto (OA) sono destinate all'utilizzo dei rivenditori per il monitoraggio dell'utilizzo della loro azienda. Se viene specificato 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 i prezzi scontati dei piani di abbonamento. Il codice promozionale deve essere incluso nella richiesta changePlan per ricevere la tariffa scontata. Questa proprietà è facoltativa. Se a un abbonamento è già stato aggiunto un codice sconto, questa proprietà può essere lasciata vuota e verrà applicata la tariffa scontata esistente (se non è vuota, fornisci solo il codice sconto già presente nell'abbonamento). Se non è mai stato aggiunto un codice sconto a un abbonamento e questa proprietà viene lasciata vuota, verranno applicati i prezzi normali.