Method: customers.userLists.addEventMatchers

تطبیق رویدادها را به لیست کاربران مبتنی بر فرکانس اضافه می کند. این تماس نمی‌تواند تطبیق‌های رویداد موجود را حذف کند یا ابرداده‌های محدودیت مبتنی بر فرکانس را تغییر دهد، مانند پنجره یا زمانی که کاربر اضافه می‌شود. فهرست کاربران ممکن است قبلاً دارای تطبیق‌کننده‌های رویداد باشد. برای مثال، این تماس می‌تواند اضافه کند: AddEventMatchersRequest { userList: "customers/1/userLists/12345" eventMatchers { matchType: GOOGLE_ADS_CAMPAIGN_ID مقدار: "3456" } } برای موفقیت این تماس، لیست کاربران 12345 نباید از قبل دارای محدودیت کمپین باشد. نوع GOOGLE_ADS_CAMPAIGN_ID با شناسه کمپین "3456".

درخواست HTTP

POST https://adsdatahub.googleapis.com/v1/{userList=customers/*/userLists/*}:addEventMatchers

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
userList

string

ضروری. نام کامل منبع، به شکل «customers/[customerId]/userLists/[userlist_id]» است. UserList باید UserListType FREQUENCY_BASED داشته باشد.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "eventMatchers": [
    {
      object (EventMatcher)
    }
  ]
}
زمینه های
eventMatchers[]

object ( EventMatcher )

فقط شامل آن محدودیت ها برای اضافه کردن به لیست کاربران باشد. لیست کاربری مشخص شده توسط userList نباید هیچ یک از محدودیت های مشخص شده در اینجا در زمان تماس را داشته باشد اما می تواند محدودیت های دیگر از قبل موجود را داشته باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه از UserList است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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