Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

Elenca tutte le informazioni sui clienti per una licenza globale dell'elenco utenti.

Questa funzionalità è disponibile solo per i partner di dati.

Richiesta HTTP

GET https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*/userListGlobalLicenses/*}/userListGlobalLicenseCustomerInfos

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. La licenza globale di cui vengono richieste le informazioni sul cliente. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Per elencare tutte le informazioni sui clienti con licenza globale in un account, sostituisci l'ID licenza globale dell'elenco utenti con un trattino ("-", ad esempio accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

Parametri di query

Parametri
filter

string

Facoltativo. Una stringa di filtro da applicare alla richiesta di elenco. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio: user_list_id = 123). I campi devono essere specificati utilizzando tutti i caratteri camel case o tutti i caratteri snake case. Non utilizzare una combinazione di camel case e snake case.

Operazioni supportate:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Campi non supportati:

  • name (utilizza invece il metodo get)
  • historical_pricings e tutti i relativi campi secondari
  • pricing.start_time
  • pricing.end_time
pageSize

integer

Facoltativo. Il numero massimo di licenze da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituite al massimo 50 licenze. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.
pageToken

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListUserListDirectLicense. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListUserListDirectLicense devono corrispondere alla chiamata che ha fornito il token di pagina.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta da [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

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

Rappresentazione JSON 
{
  "userListGlobalLicenseCustomerInfos": [
    {
      object (UserListGlobalLicenseCustomerInfo)
    }
  ],
  "nextPageToken": string
}
Campi
userListGlobalLicenseCustomerInfos[]

object (UserListGlobalLicenseCustomerInfo)

Le informazioni sul cliente per la licenza specificata nella richiesta.
nextPageToken

string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/datamanager

UserListGlobalLicenseCustomerInfo

Informazioni su un cliente di una licenza globale per l'elenco di utenti. Verrà creato automaticamente dal sistema quando un cliente acquista una licenza globale.

Rappresentazione JSON 
{
  "name": string,
  "userListId": string,
  "userListDisplayName": string,
  "licenseType": enum (UserListGlobalLicenseType),
  "status": enum (UserListLicenseStatus),
  "pricing": {
    object (UserListLicensePricing)
  },
  "clientAccountType": enum (UserListLicenseClientAccountType),
  "clientAccountId": string,
  "clientAccountDisplayName": string,
  "historicalPricings": [
    {
      object (UserListLicensePricing)
    }
  ],
  "metrics": {
    object (UserListLicenseMetrics)
  }
}
Campi
name

string

Identificatore. Il nome risorsa del cliente con licenza globale dell'elenco utenti.
userListId

string (int64 format)

Solo output. ID dell'elenco utenti per cui viene concessa la licenza.
userListDisplayName

string

Solo output. Nome dell'elenco utenti per cui viene concessa la licenza.
licenseType

enum (UserListGlobalLicenseType)

Solo output. Tipo di prodotto del cliente a cui viene concessa la licenza dell'elenco utenti.
status

enum (UserListLicenseStatus)

Solo output. Stato di UserListDirectLicense: ENABLED o DISABLED.
pricing

object (UserListLicensePricing)

Solo output. Prezzi di UserListDirectLicense.
clientAccountType

enum (UserListLicenseClientAccountType)

Solo output. Tipo di prodotto del cliente a cui viene concessa la licenza dell'elenco utenti.
clientAccountId

string (int64 format)

Solo output. ID del cliente cliente a cui viene concessa la licenza dell'elenco utenti.
clientAccountDisplayName

string

Solo output. Nome del cliente del cliente a cui viene concessa la licenza dell'elenco utenti.
historicalPricings[]

object (UserListLicensePricing)

Solo output. Cronologia dei prezzi di questa licenza per l'elenco di utenti.
metrics

object (UserListLicenseMetrics)

Solo output. Metriche relative a questa licenza

Questo campo viene compilato solo se le date di inizio e fine sono impostate nella chiamata userListGlobalLicenseCustomerInfos.list.