Method: subscriptions.list

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

Se vuoi, questo metodo può filtrare la risposta in base a un customerNamePrefix. Per saperne di più, consulta la sezione 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 è obbligatoria quando crei un account rivenduto che trasferisce l'abbonamento di un cliente diretto o l'abbonamento di un altro cliente del rivenditore alla tua gestione del rivenditore. Si tratta di un token di autenticazione esadecimale necessario per completare il trasferimento dell'abbonamento. Per ulteriori informazioni, visita il Centro assistenza per gli amministratori.
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.
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. Utilizzando un gruppo di clienti di esempio che include exam.com, example20.com e example.com:

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

integer (uint32 format)

Quando viene recuperato un elenco di grandi dimensioni, maxResults è il numero massimo di risultati per pagina. Il valore nextPageToken ti reindirizza 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, le licenze utente, lo stato della prova senza costi di 30 giorni e le opzioni di rinnovo di un prodotto. Il ruolo principale di un rivenditore è gestire gli 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#subscriptions
subscriptions[]

object (Subscription)

Gli abbonamenti in questa pagina di risultati.
nextPageToken

string

Il token di continuazione, utilizzato per sfogliare set di risultati di grandi dimensioni. Fornisci questo valore in una richiesta successiva per restituire la pagina di 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.