Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

Listet alle Kundeninformationen für eine globale Lizenz für Nutzerlisten auf.

Diese Funktion ist nur für Datenpartner verfügbar.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die globale Lizenz, deren Kundeninformationen abgefragt werden. Muss im Format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID} angegeben werden. Wenn Sie alle Kundeninformationen für globale Lizenzen unter einem Konto auflisten möchten, ersetzen Sie die ID der globalen Lizenz für Nutzerlisten durch einen Bindestrich (`-`), z. B. accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-.

Suchparameter

Parameter
filter

string

Optional. Ein Filterstring, der auf die Listenanfrage angewendet werden soll. Alle Felder müssen auf der linken Seite jeder Bedingung stehen, z. B. user_list_id = 123. Felder müssen entweder im Camel-Case-Format oder im Snake-Case-Format angegeben werden. Verwenden Sie keine Kombination aus Camel-Case- und Snake-Case-Format.

Unterstützte Operationen :

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

Unterstützte Funktionen: - IN(field, value1, value2, ...): Gibt „true“ zurück, wenn das Feld mit einem der Werte übereinstimmt. Beispiel: IN(user_list_id, 123, 456)

Nicht unterstützte Felder :

  • name (verwenden Sie stattdessen die Methode „get“)
  • historical_pricings und alle zugehörigen Unterfelder
  • pricing.start_time
  • pricing.end_time
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Lizenzen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Lizenzen zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen ListUserListDirectLicense-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListUserListDirectLicense bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort von [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "userListGlobalLicenseCustomerInfos": [
    {
      object (UserListGlobalLicenseCustomerInfo)
    }
  ],
  "nextPageToken": string
}
Felder
userListGlobalLicenseCustomerInfos[]

object (UserListGlobalLicenseCustomerInfo)

Die Kundendaten für die angegebene Lizenz in der Anfrage.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

UserListGlobalLicenseCustomerInfo

Informationen zu einem Kunden einer globalen Lizenz für Nutzerlisten. Diese werden automatisch vom System erstellt, wenn ein Kunde eine globale Lizenz erwirbt.

JSON-Darstellung 
{
  "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)
  }
}
Felder
name

string

ID. Der Ressourcenname des Kunden der globalen Lizenz für Nutzerlisten.
userListId

string (int64 format)

Nur Ausgabe. ID der lizenzierten Nutzerliste.
userListDisplayName

string

Nur Ausgabe. Name der lizenzierten Nutzerliste.
licenseType

enum (UserListGlobalLicenseType)

Nur Ausgabe. Produkttyp des Kunden, für den die Nutzerliste lizenziert wird.
status

enum (UserListLicenseStatus)

Nur Ausgabe. Status von UserListDirectLicense: AKTIVIERT oder DEAKTIVIERT.
pricing

object (UserListLicensePricing)

Nur Ausgabe. Preise für UserListDirectLicense.
clientAccountType

enum (UserListLicenseClientAccountType)

Nur Ausgabe. Produkttyp des Kunden, für den die Nutzerliste lizenziert wird.
clientAccountId

string (int64 format)

Nur Ausgabe. ID des Kunden, für den die Nutzerliste lizenziert wird.
clientAccountDisplayName

string

Nur Ausgabe. Name des Kunden, für den die Nutzerliste lizenziert wird.
historicalPricings[]

object (UserListLicensePricing)

Nur Ausgabe. Preishistorie dieser Lizenz für Nutzerlisten.
metrics

object (UserListLicenseMetrics)

Nur Ausgabe. Messwerte im Zusammenhang mit dieser Lizenz.

Dieses Feld wird nur ausgefüllt, wenn die Start- und Enddaten im Aufruf „userListGlobalLicenseCustomerInfos.list“ festgelegt sind.