Method: subscriptions.list

Elenchi di abbonamenti gestiti dal rivenditore. L'elenco può includere tutti gli abbonamenti, tutti gli abbonamenti di un cliente o tutti gli abbonamenti trasferibili di un cliente.

Se vuoi, questo metodo può filtrare la risposta in base a un valore customerNamePrefix. Per ulteriori informazioni, leggi l'articolo Gestire gli abbonamenti.

Richiesta HTTP

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
customerAuthToken

string

La stringa di query customerAuthToken è necessaria quando si crea un account del rivenditore che trasferisce l'abbonamento di un cliente diretto o trasferisce l'abbonamento di un altro cliente di un rivenditore alla tua gestione del rivenditore. Si tratta di un token di autenticazione esadecimale necessario per completare il trasferimento dell'abbonamento. Per ulteriori informazioni, consulta il Centro assistenza per gli amministratori.

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.

customerNamePrefix

string

Quando recuperi tutti i tuoi abbonamenti e filtri in base a clienti specifici, puoi inserire un prefisso per il nome di un cliente. Utilizzo di un gruppo di clienti di esempio che include exam.com, example20.com e example.com:

  • exa: restituisce tutti i nomi di clienti che iniziano con "exa" che potrebbero includere exam.com, example20.com e example.com. Un prefisso nome è simile all'utilizzo di un asterisco di un'espressione regolare, exa*.
  • example: restituisce example20.com e example.com.

maxResults

integer (uint32 format)

Quando recuperi un elenco di grandi dimensioni, maxResults è il numero massimo di risultati per pagina. Il valore nextPageToken ti porta alla pagina successiva. Il valore predefinito è 20.

pageToken

string

Token per specificare la pagina successiva nell'elenco

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Un abbonamento gestisce la relazione del piano di pagamento di un cliente Google con lo SKU di un prodotto, le licenze utente, lo stato della prova senza costi di 30 giorni e le opzioni di rinnovo. Il ruolo principale di un rivenditore è la gestione degli abbonamenti del cliente Google.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Identifica la risorsa come una raccolta di abbonamenti. Valore: reseller#abbonamenti

subscriptions[]

object (Subscription)

Le iscrizioni in questa pagina dei risultati.

nextPageToken

string

Il token di continuazione, utilizzato per scorrere set di risultati di grandi dimensioni. Fornisci questo valore in una richiesta successiva per restituire la pagina dei risultati successiva.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.