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.

Facoltativamente, questo metodo può filtrare la risposta in base a un customerNamePrefix. Per ulteriori informazioni, vedi Gestire gli abbonamenti.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

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 l'abbonamento di un altro cliente 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, 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.
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 viene recuperato un elenco di grandi dimensioni, maxResults corrisponde al 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 consente di gestire 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. Un 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 raccolta di abbonamenti. Valore: rivenditore#abbonamenti
subscriptions[]

object (Subscription)

Le iscrizioni in questa pagina dei risultati.
nextPageToken

string

Il token di continuazione, utilizzato per sfogliare grandi set di risultati. 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 alle autorizzazioni.