Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

Liste toutes les informations client pour une licence globale de liste d'utilisateurs.

Cette fonctionnalité n'est disponible que pour les partenaires de données.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Licence mondiale dont les informations client sont demandées. Format requis : accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Pour lister toutes les informations client sur les licences mondiales d 'un compte, remplacez l'ID de licence mondiale de la liste des utilisateurs par un tiret (par exemple, accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

Paramètres de requête

Paramètres
filter

string

Facultatif. Une chaîne de filtre à appliquer à la requête de liste. Tous les champs doivent se trouver à gauche de chaque condition (par exemple, user_list_id = 123). Les champs doivent être spécifiés en camel case ou en snake case. N'utilisez pas une combinaison de camel case et de snake case.

Opérations compatibles :

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

Champs non compatibles :

  • name (utilisez plutôt la méthode get)
  • historical_pricings et tous ses sous-champs
  • pricing.start_time
  • pricing.end_time
pageSize

integer

Facultatif. Nombre maximal de licences à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 licences au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
pageToken

string

Facultatif. Jeton de page reçu d'un appel ListUserListDirectLicense précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListUserListDirectLicense doivent correspondre à l'appel ayant fourni le jeton de page.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse à la requête [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "userListGlobalLicenseCustomerInfos": [
    {
      object (UserListGlobalLicenseCustomerInfo)
    }
  ],
  "nextPageToken": string
}
Champs
userListGlobalLicenseCustomerInfos[]

object (UserListGlobalLicenseCustomerInfo)

Informations sur le client pour la licence donnée dans la requête.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

UserListGlobalLicenseCustomerInfo

Informations sur un client d'une licence globale de liste d'utilisateurs. Il sera automatiquement créé par le système lorsqu'un client achètera une licence mondiale.

Représentation 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)
  }
}
Champs
name

string

Identifiant. Nom de ressource du client de licence globale de la liste d'utilisateurs.
userListId

string (int64 format)

Uniquement en sortie. ID de la liste d'utilisateurs pour laquelle une licence est accordée.
userListDisplayName

string

Uniquement en sortie. Nom de la liste d'utilisateurs sous licence.
licenseType

enum (UserListGlobalLicenseType)

Uniquement en sortie. Type de produit du client auquel la liste d'utilisateurs est concédée.
status

enum (UserListLicenseStatus)

Uniquement en sortie. État de UserListDirectLicense : ENABLED ou DISABLED.
pricing

object (UserListLicensePricing)

Uniquement en sortie. Tarifs de UserListDirectLicense.
clientAccountType

enum (UserListLicenseClientAccountType)

Uniquement en sortie. Type de produit du client auquel la liste d'utilisateurs est concédée.
clientAccountId

string (int64 format)

Uniquement en sortie. ID du compte client auquel la liste d'utilisateurs est concédée sous licence.
clientAccountDisplayName

string

Uniquement en sortie. Nom du client auquel la liste d'utilisateurs est concédée sous licence.
historicalPricings[]

object (UserListLicensePricing)

Uniquement en sortie. Historique des prix de cette licence de liste d'utilisateurs.
metrics

object (UserListLicenseMetrics)

Uniquement en sortie. Métriques liées à cette licence

Ce champ n'est renseigné que si les dates de début et de fin sont définies dans l'appel userListGlobalLicenseCustomerInfos.list.