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. Er sollte folgendes Format haben: accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Wenn Sie alle Kundeninformationen für globale Lizenzen unter einem Konto auflisten möchten, ersetzen Sie die globale Lizenz-ID der Nutzerliste durch ein „-“ (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 sich auf der linken Seite der jeweiligen Bedingung befinden (z. B. user_list_id = 123). Felder müssen entweder alle im CamelCase oder alle im SnakeCase angegeben werden. Verwenden Sie keine Kombination aus Camel Case und Snake Case.

Unterstützte Vorgänge:

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

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 Kundeninformationen 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. Sie wird 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 globalen Lizenzkunden der Nutzerliste.
userListId

string (int64 format)

Nur Ausgabe. ID der Nutzerliste, für die eine Lizenz erteilt wird.
userListDisplayName

string

Nur Ausgabe. Name der Nutzerliste, für die eine Lizenz erteilt wird.
licenseType

enum (UserListGlobalLicenseType)

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

enum (UserListLicenseStatus)

Nur Ausgabe. Status von „UserListDirectLicense“: ENABLED oder DISABLED.
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, an den die Nutzerliste lizenziert wird.
clientAccountDisplayName

string

Nur Ausgabe. Name des Kunden des Kunden, an den die Nutzerliste lizenziert wird.
historicalPricings[]

object (UserListLicensePricing)

Nur Ausgabe. Preisverlauf dieser Nutzerlistenlizenz.
metrics

object (UserListLicenseMetrics)

Nur Ausgabe. Messwerte zu dieser Lizenz

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