Ads Data Hub API

ממשק API להפעלת שאילתות ב-Ads Data Hub.

שירות: adsdatahub.googleapis.com

כדי להתקשר לשירות הזה, מומלץ להשתמש בספריות לקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי להתקשר לשירות הזה, השתמשו במידע הבא כשתבצעו את בקשות ה-API.

מסמך Discovery

מסמך Discovery הוא מפרט שמחשב יכול לקרוא כדי לתאר ולצרוך ממשקי API של REST. הוא משמש לבניית ספריות לקוח, יישומי פלאגין של IDE וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד עשוי לספק מספר מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:

נקודת הקצה של השירות

נקודת קצה (endpoint) היא כתובת URL בסיסית המציינת את כתובת הרשת של שירות API. ייתכן שלשירות אחד יהיו כמה נקודות קצה. לשירות הזה יש נקודת קצה (endpoint) הבאה וכל ה-URIs הבאים הם יחסיים לנקודת הקצה הזו:

  • https://adsdatahub.googleapis.com

משאב REST: v1.customers

שיטות
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
מתאר את מזהי המפרסמים ב-DV360 החוקיים
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
רשימות התאמת אירועים חוקיות יחד עם המטא-נתונים של רשימות קהלים למכסת תדירות.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
מתבצע ייצוא של היסטוריית המשרות של חשבון לקוח למערך נתונים שנבחר על ידי הלקוח ב-BigQuery.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
מתחילה הפעלה של שאילתה כדי לאחזר מדדי ניראות של תנועה לא חוקית בפלטפורמת DV360.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
מתחילה הפעלה של שאילתה כדי לאחזר סיכום יומי של ספירת תנועה לא חוקית עבור פלטפורמה ספציפית.
get GET /v1/{name=customers/*}
מתבצע אחזור של הלקוח המבוקש של Ads Data Hub.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
פונקציה זו מחזירה את אחוז הנתונים של Google מכל הלקוחות שהטמעתם בהצלחה ב-ADH בתאריך הנתון.
list GET /v1/customers
רשימה של לקוחות Ads Data Hub שאליהם יש למשתמש הנוכחי גישה.

משאב REST: v1.customers.adsDataCustomers

שיטות
get GET /v1/{name=customers/*/adsDataCustomers/*}
מתבצע אחזור של הלקוח המבוקש של Ads Data Hub.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
מאחזר את התקציב של הגישה לנתונים עבור מקור הנתונים של המודעות המבוקש במהלך 366 הימים האחרונים.
list GET /v1/{parent=customers/*}/adsDataCustomers
מפורטת רשימה של נתוני המודעות שלקוחות יכולים לגשת אליהם.

משאב REST: v1.customers.analysisQuery

שיטות
create POST /v1/{parent=customers/*}/analysisQueries
יוצרת שאילתת ניתוח להפעלה בהמשך.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
מחיקת שאילתת ניתוח.
get GET /v1/{name=customers/*/analysisQueries/*}
מאחזר את שאילתת הניתוח המבוקשת.
list GET /v1/{parent=customers/*}/analysisQueries
מפרט את שאילתות הניתוח שבבעלות הלקוח שצוין.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
עדכון שאילתת ניתוח קיימת.
start POST /v1/{name=customers/*/analysisQueries/*}:start
הביצוע מתחיל בשאילתת ניתוח שמורה.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
הביצוע מתחיל בשאילתת ניתוח זמנית.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
מבצע בדיקות אימות סטטיות בשאילתת הניתוח שסופקה.

משאב REST: v1.customers.customBiddingAlgorithms

שיטות
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
מוסיפים מפרסם ב-DV360 למפרסמים באלגוריתם בהתאמה אישית של הצעות מחיר.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
יוצרת אלגוריתם של בידינג מותאם אישית המנוהל על ידי Ads Data Hub.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
למחוק את האלגוריתם הזה של בידינג מותאם אישית.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
חשיפות של 30 הימים האחרונים של חשיפות במודלים בהתאמה אישית של בידינג.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
מאחזר את האלגוריתם המותאם אישית של הצעות מחיר המנוהל על ידי Ads Data Hub.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
רשימה של האלגוריתמים המותאמים אישית לניהול שמנוהל על ידי הלקוח שצוין ב-Ads Data Hub.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
מתעדכן אלגוריתם הבקשה המותאם אישית המנוהל על ידי Ads Data Hub.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
מסירים מפרסם מ-DV360 מהאלגוריתם של הצעות מחיר מותאמות אישית מהמפרסמים.

משאב REST: v1.customers.tables

שיטות
get GET /v1/{name=customers/*/tables/*}
אחזור של טבלת Ads Data Hub המבוקשת.
list GET /v1/{parent=customers/*}/tables
מפרטת את הטבלאות ב-Ads Data Hub שיש ללקוח הזה גישה אליהן.

משאב REST: v1.customers.tempTables

שיטות
get GET /v1/{name=customers/*/tempTables/*}
מאחזר את טבלת הטמפרטורה המבוקשת של Ads Data Hub.
list GET /v1/{parent=customers/*}/tempTables
מפרט את טבלאות הטמפרטורות שהלקוח יצר ב-Ads Data Hub.

משאב REST: v1.customers.userListQuery

שיטות
create POST /v1/{parent=customers/*}/userListQueries
יוצרת שאילתה ברשימת משתמשים לביצוע מאוחר יותר.
delete DELETE /v1/{name=customers/*/userListQueries/*}
המחיקה של שאילתת רשימת משתמשים.
get GET /v1/{name=customers/*/userListQueries/*}
מאחזר את השאילתה של רשימת המשתמשים המבוקשת.
list GET /v1/{parent=customers/*}/userListQueries
רשימה של שאילתות רשימות המשתמשים שבבעלות הלקוח שצוין.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
עדכון שאילתה קיימת של רשימת משתמשים.
start POST /v1/{name=customers/*/userListQueries/*}:start
הביצוע מתחיל בשאילתה עם רשימת המשתמשים השמורה.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
הביצוע מתחיל בתגובה לשאילתה של רשימת משתמשים זמנית.
validate POST /v1/{parent=customers/*}/userListQueries:validate
מבצע בדיקות אימות סטטיות בשאילתה של רשימת המשתמשים שצוינה.

משאב REST: v1.customers.userLists

שיטות
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
מוסיף התאמת אירועים לרשימת משתמשים מבוססת תדירות.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
מוסיפים ישויות לנמענים של רשימת משתמשים המנוהלת על ידי Ads Data Hub.
create POST /v1/{parent=customers/*}/userLists
תיצור רשימת משתמשים המנוהלת על ידי Ads Data Hub.
delete DELETE /v1/{name=customers/*/userLists/*}
מוחקים את רשימת המשתמשים המבוקשת של Ads Data Hub.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
אפשר ליצור מועדון חברים עבור רשימת המשתמשים.
get GET /v1/{name=customers/*/userLists/*}
מאחזר את רשימת המשתמשים המנוהלת של Ads Data Hub.
list GET /v1/{parent=customers/*}/userLists
מפרטת את רשימות המשתמשים שמנוהלות על ידי הלקוח שצוין ב-Ads Data Hub.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
יתבצע עדכון ברשימת המשתמשים המנוהלת על ידי Ads Data Hub.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
מתבצעת הסרה של ישויות מהנמענים של רשימת משתמשים המנוהלת על ידי Ads Data Hub.

משאב REST: v1.operations

שיטות
cancel POST /v1/{name=operations/**}:cancel
מתחיל ביטול אסינכרוני בפעולה ממושכת.
delete DELETE /v1/{name=operations/**}
מחיקת פעולה ממושכת.
get GET /v1/{name=operations/**}
מקבל את המצב העדכני של פעולה ממושכת.
list GET /v1/{name}
רשימה של פעולות שתואמות למסנן שצוין בבקשה.
wait POST /v1/{name=operations/**}:wait
מחכה עד לסיום הפעולה המתמשכת או עד לסיום הזמן הקצוב לתפוגה, ומחזיר את המצב העדכני.

משאב REST: v1.outages

שיטות
list GET /v1/outages
רשימה של הפסקות הזמניות בסדר יורד של חותמת הזמן של ההפסקה, וחלון המבט לאחור הוא 130 ימים.