Method: exchanges.generateReport

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
exchange

string

חובה. שם פלטפורמת ה-Exchange שאליה שייכת הדוחות. דוגמה: "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.

ReportType

סוג הדוח.

טיפוסים בני מנייה (enum)
REPORT_TYPE_UNSPECIFIED לא צוין סוג דוח, ערך קלט לא חוקי
HOURLY סוג הדוח שעתי.
DAILY סוג דוח יומי.
WEEKLY סוג הדוח – שבועי.
MONTHLY סוג הדוח חודשי.

DimensionId

דיווח על AttributeId 'טיפוסים בני מנייה (enum)'.

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