- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
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 |
La stringa di query |
customerId |
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 |
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
|
maxResults |
Quando recuperi un elenco di grandi dimensioni, |
pageToken |
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 ( |
Campi | |
---|---|
kind |
Identifica la risorsa come una raccolta di abbonamenti. Valore: reseller#abbonamenti |
subscriptions[] |
Le iscrizioni in questa pagina dei risultati. |
nextPageToken |
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.