Method: subscriptions.suspend

Sospende un abbonamento attivo.

Puoi utilizzare questo metodo per sospendere un abbonamento a pagamento attualmente nello stato ACTIVE.

  • Per gli abbonamenti FLEXIBLE, la fatturazione è in pausa.
  • Per gli abbonamenti ANNUAL_MONTHLY_PAY o ANNUAL_YEARLY_PAY:
    • La sospensione dell'abbonamento non modifica la data di rinnovo originariamente prevista.
    • Un abbonamento sospeso non viene rinnovato.Se attivi l'abbonamento dopo la data di rinnovo originale, a partire dal giorno dell'attivazione verrà creato un nuovo abbonamento annuale.

Ti consigliamo vivamente di sospendere gli abbonamenti solo per brevi periodi di tempo, in quanto sospensioni superiori a 60 giorni potrebbero comportare l'annullamento dell'abbonamento.

Richiesta HTTP

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/suspend

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 deve essere vuoto.

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.