Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

Отображает всю информацию о клиенте для глобальной лицензии, содержащей список пользователей.

Эта функция доступна только партнерам по передаче данных.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Обязательно. Глобальная лицензия, информация о клиентах которой запрашивается. Должна быть в формате accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID} . Чтобы отобразить всю информацию о клиентах глобальных лицензий в рамках учетной записи, замените идентификатор глобальной лицензии в списке пользователей на '-' (например, accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/- ).

Параметры запроса

Параметры
filter

string

Необязательно. Строка фильтра , применяемая к запросу списка. Все поля должны располагаться слева от каждого условия (например: user_list_id = 123 ). Поля должны быть указаны либо в формате camel case , либо в формате snake case . Не используйте комбинацию camel case и snake case.

Поддерживаемые операции:

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

Неподдерживаемые поля:

  • name (используйте метод get вместо этого)
  • historical_pricings и все их подполя
  • pricing.start_time
  • pricing.end_time
pageSize

integer

Необязательно. Максимальное количество возвращаемых лицензий. Сервис может вернуть меньше этого значения. Если не указано, будет возвращено не более 50 лицензий. Максимальное значение — 1000; значения выше 1000 будут преобразованы в 1000.

pageToken

string

Необязательный параметр. Токен страницы, полученный из предыдущего вызова ListUserListDirectLicense . Укажите его, чтобы получить следующую страницу.

При использовании постраничной навигации все остальные параметры, передаваемые в ListUserListDirectLicense , должны соответствовать вызову, который предоставил токен страницы.

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

Ответ от [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "userListGlobalLicenseCustomerInfos": [
    {
      object (UserListGlobalLicenseCustomerInfo)
    }
  ],
  "nextPageToken": string
}
Поля
userListGlobalLicenseCustomerInfos[]

object ( UserListGlobalLicenseCustomerInfo )

Информация о клиенте, относящаяся к данной лицензии, указывается в запросе.

nextPageToken

string

Токен, который можно отправить в качестве pageToken для получения следующей страницы. Если это поле опущено, последующих страниц не будет.

Области полномочий

Требуется следующая область действия OAuth:

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

UserListGlobalLicenseCustomerInfo

Информация о клиенте, использующем глобальную лицензию, будет автоматически создана системой при покупке клиентом глобальной лицензии.

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)
  }
}
Поля
name

string

Идентификатор. Имя ресурса списка пользователей, глобальной лицензии клиента.

userListId

string ( int64 format)

Только вывод. Идентификатор списка пользователей, для которого предоставляется лицензия.

userListDisplayName

string

Только вывод. Название списка пользователей, для которых предоставляется лицензия.

licenseType

enum ( UserListGlobalLicenseType )

Только вывод. Тип продукта клиента, которому предоставляется лицензия на список пользователей.

status

enum ( UserListLicenseStatus )

Только вывод. Статус UserListDirectLicense — ВКЛЮЧЕНО или ОТКЛЮЧЕНО.

pricing

object ( UserListLicensePricing )

Только вывод. Цены UserListDirectLicense.

clientAccountType

enum ( UserListLicenseClientAccountType )

Только вывод. Тип продукта клиента, которому предоставляется лицензия на список пользователей.

clientAccountId

string ( int64 format)

Только вывод. Идентификатор клиента, которому предоставляется лицензия на список пользователей.

clientAccountDisplayName

string

Только вывод. Имя клиента, которому предоставляется лицензия на список пользователей.

historicalPricings[]

object ( UserListLicensePricing )

Только вывод. История цен на лицензию для этого списка пользователей.

metrics

object ( UserListLicenseMetrics )

Только для вывода. Метрики, относящиеся к данной лицензии.

Это поле заполняется только в том случае, если даты начала и окончания заданы в вызове userListGlobalLicenseCustomerInfos.list.