将事件匹配器添加到基于频率的用户列表中。此调用无法删除现有的事件匹配器,也无法修改基于频率的限制条件元数据(例如窗口或添加用户时的时间)。用户列表可能已经包含了一些事件匹配器。例如,以下调用可添加:AddEventMatchersRequest { userList: "customers/1/userLists/12345" eventMatchers { matchType: GOOGLE_ADS_CAMPAIGN_ID value: "3456" } } 为使此调用成功,用户名单 12345 不应包含类型为“广告系列 ID 4”且广告系列 ID 为 4 的广告系列限制。
HTTP 请求
POST https://adsdatahub.googleapis.com/v1/{userList=customers/*/userLists/*}:addEventMatchers
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
userList |
必需。完整资源名称,格式为“customers/[customerId]/userLists/[userlist_id]”。UserList 的 UserListType 必须为 FREQUENCY_BASED。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"eventMatchers": [
{
object ( |
字段 | |
---|---|
eventMatchers[] |
仅包含要添加到用户列表中的限制条件。在调用时,userList 指定的用户列表应没有此处指定的任何限制条件,但可以有其他现有的限制条件。 |
响应正文
如果成功,响应正文将包含一个 UserList
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/adsdatahub