יוצרת ומחזירה את מזהה הדוח. הדוח לא נשמר. הפעלות עם אותה בקשה ייצרו מחדש את הדוח.
בקשת HTTP
POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של הנתיב
| פרמטרים | |
|---|---|
exchange |
חובה. שם הבורסה שהדוח שייך לה. דוגמה: "exchanges/123" (חובה). |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
|---|
{ "startDate": string, "endDate": string, "reportType": enum ( |
| שדות | |
|---|---|
startDate |
חובה. תאריך ההתחלה של הדוחות בפורמט ISO_8601 (YYYY-MM-DD), כולל. נדרש כקלט. |
endDate |
חובה. תאריך הסיום של הדוחות בפורמט ISO_8601 (YYYY-MM-DD), כולל. נדרש כקלט. |
reportType |
חובה. אם לא תציינו את סוג הדוח, המערכת תחזיר שגיאות. |
dimensionIds[] |
זה שינוי אופציונלי. רשימת המאפיינים שעל פיהם הדוח ייווצר. אם הערך הוא null, צריך לכלול רק את מזהה בעל האפליקציה. אם המאפיינים לא נתמכים בסוג מסוים של דוח, המערכת תתעלם מהם. |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Report.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/doubleclickbidmanager
ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.
ReportType
סוג הדוח.
| טיפוסים בני מנייה (enum) | |
|---|---|
REPORT_TYPE_UNSPECIFIED |
סוג הדוח לא צוין, ערך הקלט לא חוקי. |
HOURLY |
סוג דוח שעתי. |
DAILY |
סוג דוח יומי. |
WEEKLY |
סוג דוח שבועי. |
MONTHLY |
סוג דוח חודשי. |
AWBID_DAILY |
סוג דוח יומי של AwBid. |
AWBID_WEEKLY |
סוג דוח שבועי של AwBid. |
AWBID_MONTHLY |
סוג דוח חודשי של AwBid. |
AWBID_OUT_OF_MONTH_IVT |
סוג דוח IVT של AwBid מחוץ לחודש. |
DimensionId
Report DimensionId enum.
| טיפוסים בני מנייה (enum) | |
|---|---|
DIMENSION_ID_UNSPECIFIED |
מאפיין הדוח לא צוין, ערך הקלט לא חוקי. |
PARTNER_ID |
מזהה שותף, נתמך רק בדוח היומי. |
DEVICE_TYPE |
סוג המכשיר, נתמך רק בדוח היומי. |
CREATIVE_ID |
מזהה הקריאייטיב, נתמך רק בדוח היומי. חשוב לשים לב שהמאפיין הזה יכול להגדיל באופן משמעותי את גודל הקובץ של הדוחות. יכול להיות שייקח כמה שעות להריץ את הדוחות שכוללים את המאפיין הזה. בעתיד נגביל את הדירוג בשדות האלה שגורמים לעומס. |
CREATIVE_TYPE |
סוג הקריאייטיב, נתמך רק בדוח היומי. חשוב לשים לב שהמאפיין הזה יכול להגדיל באופן משמעותי את גודל הקובץ של הדוחות. יכול להיות שייקח כמה שעות להריץ את הדוחות שכוללים את המאפיין הזה. בעתיד נגביל את הדירוג בשדות האלה שגורמים לעומס. |
REGION_CODE |
קוד מדינה/אזור, נתמך רק בדוח היומי. |
DEAL_ID |
מספר עסקה, מיפוי למקור מלאי שטחי פרסום, נתמך רק בדוח היומי. |
PUBLISHER_ID |
מזהה בעל האפליקציה. אם רשימת מזהי המאפיינים של הקלט היא null, זהו מאפיין ברירת המחדל. |
SITE_ID |
מייצג את מזהה האתר (דומיין אינטרנט או מזהה חבילת אפליקציה), נתמך רק בדוח היומי. |
SITE_DISPLAY_NAME |
מייצג את השם המוצג של האתר (דומיין אינטרנט או שם אפליקציה), נתמך רק בדוח היומי. |