Method: customers.describeValidFrequencyLimitingEventMatchers

Список действительных сопоставителей событий вместе с их метаданными для списков аудитории с ограничением частоты показов. У каждого сопоставителя событий есть метаданные, которые включают, например, AdsDataLink.Entity-владельца и имя соответствующей кампании или позиции.

HTTP-запрос

GET https://adsdatahub.googleapis.com/v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers

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

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

Параметры
customer

string

Имя ресурса клиента, например «customers/123».

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

Параметры
adsDataCustomerId

string ( int64 format)

Рекламные данные Владелец идентификатора клиента, например 456.

pageSize

integer

Максимальное количество товаров для возврата. Если 0, сервер определит количество возвращенных связанных клиентов.

pageToken

string

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

filter

string

Ограничьте возвращаемые сопоставители событий. Принимает фильтры для всех подполей eventMatcher, eventMatcherMetadata.entity и eventMatcherMetadata.parent_event_matcher. Примеры фильтров: eventMatcher.value = 1234 eventMatcher.match_type = DV360_LINE_ITEM_ID ИЛИ eventMatcher.match_type = DV360_INSERTION_ORDER_ID eventMatcherMetadata.display_name = "Campaign 456" GMP_DV360_ADVERTISER eventMatcherMetadata.parent_event_matcher.value = 6789 eventMatcherMetadata.parent_event_matcher.match_type = DV360_INSERTION_ORDER_ID

Тело запроса

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

Тело ответа

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

Ответ на запрос DescribeValidFrequencyLimitingEventMatchersRequest.

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

object ( EventMatcherInfo )

Список модулей, каждый из которых содержит средство сопоставления событий вместе со своими метаданными.

nextPageToken

string

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

Области авторизации

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

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

EventMatcherInfo

Сопоставитель событий вместе с его метаданными.

Представление JSON
{
  "eventMatcher": {
    object (EventMatcher)
  },
  "eventMatcherMetadata": {
    object (EventMatcherMetadata)
  }
}
Поля
eventMatcher

object ( EventMatcher )

Сопоставитель событий, содержащий тип ограничения и действительный идентификатор ограничения.

eventMatcherMetadata

object ( EventMatcherMetadata )

Метаданные для средства сопоставления событий.

EventMatcherМетаданные

Метаданные для средства сопоставления событий.

Представление JSON
{
  "entity": {
    object (Entity)
  },
  "displayName": string,
  "parentEventMatcher": {
    object (EventMatcher)
  }
}
Поля
entity

object ( Entity )

Связанный объект из AdsDataLink.

displayName

string

Имя в базовом хранилище данных для ограничения. Это может быть название кампании, название позиции и т. д.

parentEventMatcher

object ( EventMatcher )

Связанный родительский EventMatcher, если есть. Если eventMatcher является элементом строки DV360, это поле будет ссылаться на EventMatcher для соответствующего заказа на размещение DV360, частью которого является элемент строки.