Thêm trình so khớp sự kiện vào danh sách người dùng dựa trên tần suất. Lệnh gọi này không thể xoá trình so khớp sự kiện hiện có hoặc sửa đổi siêu dữ liệu ràng buộc dựa trên tần suất, chẳng hạn như cửa sổ hoặc khi người dùng được thêm. Danh sách người dùng có thể đã chứa một số trình so khớp sự kiện. Ví dụ: lệnh gọi này có thể thêm: AddEventMatchersRequest { userList: "customers/1/userLists/12345" eventMatchers { matchType: GOOGLE_ADS_CAMPAIGN_ID value: "3456" } } Để lệnh gọi này thành công, danh sách người dùng 12345 không được chứa ràng buộc chiến dịch thuộc loại GOOGLE_ADS_3.
Yêu cầu HTTP
POST https://adsdatahub.googleapis.com/v1/{userList=customers/*/userLists/*}:addEventMatchers
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Các tham số | |
|---|---|
userList |
Bắt buộc. Tên tài nguyên đầy đủ, có dạng "customer/[customerId]/userLists/[userlist_id]". UserList phải có UserListType FREQUENCY_BASED. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{
"eventMatchers": [
{
object ( |
| Các trường | |
|---|---|
eventMatchers[] |
Chỉ chứa các quy tắc ràng buộc đó để thêm vào danh sách người dùng. Danh sách người dùng do userList chỉ định không được có điều kiện ràng buộc nào được chỉ định tại đây vào thời điểm diễn ra lệnh gọi nhưng có thể có các điều kiện ràng buộc khác đã có từ trước. |
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của UserList.
Phạm vi cấp phép
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/adsdatahub