Method: subscriptions.suspend

Sospende un abbonamento attivo.

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

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

Ti consigliamo vivamente di sospendere gli abbonamenti solo per brevi periodi di tempo, poiché 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ò 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 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 all'autorizzazione.