Method: exchanges.generateReport

יוצר ומחזיר את מזהה הדוח. הדוח לא נשמר. הפעלות עם אותה בקשה ייצרו מחדש את הדוח.

בקשת HTTP

POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
exchange

string

חובה. השם של הבורסה שהדוח שייך אליה. דוגמה: 'exchanges/123'. חובה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
שדות
startDate

string

חובה. תאריך ההתחלה של הדוחות בפורמט ISO_8601‏ YYYY-MM-DD, כולל. נדרש כקלט.
endDate

string

חובה. תאריך הסיום של הדוחות בפורמט ISO_8601 ‏YYYY-MM-DD, כולל. נדרש כקלט.
reportType

enum (ReportType)

חובה. אם לא מציינים את סוג הדוח, המערכת מחזירה שגיאות.
dimensionIds[]

enum (DimensionId)

אופציונלי. רשימת מאפיינים שלפיהם ייווצר הדוח. אם הערך הוא 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 Daily.
AWBID_WEEKLY סוג דוח שבועי של AwBid.
AWBID_MONTHLY סוג דוח חודשי של AwBid.
AWBID_OUT_OF_MONTH_IVT סוג הדוח AwBid out of month IVT.

DimensionId

ספירת הערכים של מאפיין הדוח DimensionId.

טיפוסים בני מנייה (enum)
DIMENSION_ID_UNSPECIFIED מאפיין הדיווח לא צוין, ערך הקלט לא תקין.
PARTNER_ID מזהה שותף, נתמך רק בדוח יומי.
DEVICE_TYPE סוג המכשיר, נתמך רק בדוח היומי.
CREATIVE_ID מזהה קריאייטיב, נתמך רק בדוח יומי. שימו לב שהמאפיין הזה יכול לתרום באופן משמעותי לגודל הקובץ של הדוחות. הפעלת הדוחות שכוללים את המאפיין הזה יכולה להימשך שעות. בעתיד נגביל את הדירוג בשדות האלה שדורשים טעינה כבדה.
CREATIVE_TYPE סוג הקריאייטיב, נתמך רק בדוח יומי. חשוב לשים לב שהמאפיין הזה יכול להגדיל באופן משמעותי את גודל הקובץ של הדוחות. הדוחות כוללים את המאפיין הזה, והרצתם עשויה להימשך שעות. בעתיד נגביל את הדירוג בשדות האלה שדורשים טעינה כבדה.
REGION_CODE קוד המדינה או האזור, נתמך רק בדוח היומי.
DEAL_ID מספר עסקה, מיפוי למקור מלאי שטחי הפרסום, נתמך רק בדוח יומי.
PUBLISHER_ID מזהה בעל האפליקציה, אם רשימת מזהי המאפיינים של הקלט היא null, זהו מאפיין ברירת המחדל.