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 globale dont les informations client sont interrogées. Doit être au format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Pour lister toutes les informations client de licence globale sous un compte, remplacez l'ID de licence globale de liste d'utilisateurs par un tiret ("-") (par exemple, accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

Paramètres de requête

Paramètres
filter

string

Facultatif. 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
  • =
  • !=
  • >
  • >=
  • <
  • <=

Fonctions compatibles : - IN(field, value1, value2, ...) : renvoie la valeur "true" si le champ correspond à l'une des valeurs. Exemple : IN(user_list_id, 123, 456)

Champs incompatibles :

  • 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 seront 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 de [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.

Niveaux d'accès 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. Ces informations sont créées automatiquement par le système lorsqu'un client achète une licence globale.

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 liste d'utilisateurs.
userListId

string (int64 format)

Uniquement en sortie. ID de la liste d'utilisateurs sous licence.
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 sous licence.
status

enum (UserListLicenseStatus)

Uniquement en sortie. État de UserListDirectLicense : ACTIVÉ ou DÉSACTIVÉ.
pricing

object (UserListLicensePricing)

Uniquement en sortie. Tarification de UserListDirectLicense.
clientAccountType

enum (UserListLicenseClientAccountType)

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

string (int64 format)

Uniquement en sortie. ID du 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 tarifs de cette licence de liste d'utilisateurs.
metrics

object (UserListLicenseMetrics)

Uniquement en sortie. Métriques associé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.