Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

Wyświetla wszystkie informacje o klientach na potrzeby globalnej licencji na listę klientów.

Ta funkcja jest dostępna tylko dla partnerów danych.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Licencja globalna, której dotyczy zapytanie o informacje o kliencie. Powinien mieć format accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. Aby wyświetlić wszystkie informacje o klientach z globalną licencją na koncie, zastąp identyfikator globalnej licencji na liście użytkowników znakiem „-” (np. accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

Parametry zapytania

Parametry
filter

string

Opcjonalnie. Ciąg filtra do zastosowania w żądaniu listy. Wszystkie pola muszą znajdować się po lewej stronie każdego warunku (np. user_list_id = 123). Pola muszą być określone w formacie camel case lub snake case. Nie używaj kombinacji notacji camel case i snake case.

Obsługiwane operacje:

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

Nieobsługiwane pola:

  • name (zamiast tego użyj metody GET)
  • historical_pricings i wszystkie jego pola podrzędne.
  • pricing.start_time
  • pricing.end_time
pageSize

integer

Opcjonalnie. Maksymalna liczba licencji do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 50 licencji. Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania ListUserListDirectLicense. Podaj ten token, aby pobrać kolejną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji ListUserListDirectLicense muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "userListGlobalLicenseCustomerInfos": [
    {
      object (UserListGlobalLicenseCustomerInfo)
    }
  ],
  "nextPageToken": string
}
Pola
userListGlobalLicenseCustomerInfos[]

object (UserListGlobalLicenseCustomerInfo)

Informacje o kliencie dotyczące danej licencji w żądaniu.
nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

UserListGlobalLicenseCustomerInfo

Informacje o kliencie globalnej licencji na listę użytkowników. Zostanie on automatycznie utworzony przez system, gdy klient kupi licencję globalną.

Zapis 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)
  }
}
Pola
name

string

Identyfikator. Nazwa zasobu klienta z globalną licencją na listę użytkowników.
userListId

string (int64 format)

Tylko dane wyjściowe. Identyfikator listy użytkowników, na którą przyznawana jest licencja.
userListDisplayName

string

Tylko dane wyjściowe. Nazwa listy użytkowników, na którą przyznawana jest licencja.
licenseType

enum (UserListGlobalLicenseType)

Tylko dane wyjściowe. Rodzaj usługi klienta, na którą licencjonowana jest lista użytkowników.
status

enum (UserListLicenseStatus)

Tylko dane wyjściowe. Stan UserListDirectLicense – ENABLED lub DISABLED.
pricing

object (UserListLicensePricing)

Tylko dane wyjściowe. Ceny UserListDirectLicense.
clientAccountType

enum (UserListLicenseClientAccountType)

Tylko dane wyjściowe. Rodzaj usługi klienta, na którą licencjonowana jest lista użytkowników.
clientAccountId

string (int64 format)

Tylko dane wyjściowe. Identyfikator klienta, któremu licencjonowana jest lista użytkowników.
clientAccountDisplayName

string

Tylko dane wyjściowe. Nazwa klienta, któremu licencjonowana jest lista użytkowników.
historicalPricings[]

object (UserListLicensePricing)

Tylko dane wyjściowe. Historia cen licencji na tę listę użytkowników.
metrics

object (UserListLicenseMetrics)

Tylko dane wyjściowe. Dane związane z tą licencją

To pole jest wypełniane tylko wtedy, gdy daty rozpoczęcia i zakończenia są ustawione w wywołaniu userListGlobalLicenseCustomerInfos.list.