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.
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 מייצג את השם המוצג של האתר (דומיין אינטרנט או שם אפליקציה), נתמך רק בדוח היומי.