מוסיף התאמת אירועים לרשימת משתמשים מבוססת תדירות. לשיחה הזו אין אפשרות למחוק התאמות קיימות של אירועים או לשנות מטא-נתונים של אילוץ המבוססים על תדירות, כמו חלון או כשמשתמש נוסף. ייתכן שרשימת המשתמשים כבר מכילה התאמות מסוימות לאירועים. לדוגמה, השיחה הזו יכולה להוסיף את הנתונים הבאים: AddEventMATCHersRequest { userList: "customers/1/userLists/12345" eventMATCHers { MatchType: GOOGLE_ADS_CAMPAIGN_ID value: "3456" } }כדי שהשיחה הזו תצליח, רשימת המשתמשים 12345"לא יכולה להכיל כבר מגבלת קמפיין של GOOGLE
בקשת HTTP
POST https://adsdatahub.googleapis.com/v1/{userList=customers/*/userLists/*}:addEventMatchers
כתובת ה-URL כוללת תחביר gRPC קידוד מחדש.
פרמטרים של נתיב
פרמטרים | |
---|---|
userList |
חובה. השם של משאב מלא מופיע בפורמט 'customers/[customerId]/userLists/[userlist_id]'. ב-UserListType חייב להיות FREQUENCY_BaseD. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"eventMatchers": [
{
object ( |
שדות | |
---|---|
eventMatchers[] |
מכילים רק את המגבלות האלה כדי להוסיף לרשימת המשתמשים. רשימת המשתמשים שצוינה על ידי userList לא צריכה לכלול אף אחת מהמגבלות המפורטות כאן בזמן השיחה, אבל יכולה להיות לה אילוצים קיימים אחרים. |
גוף התגובה
אם התגובה מוצלחת, גוף התגובה מכיל מופע של UserList
.
היקפי הרשאה
יש צורך בהיקף OAuth הבא:
https://www.googleapis.com/auth/adsdatahub