Method: exchanges.generateReport

สร้างและแสดงผลรหัสรายงาน รายงานยังคงอยู่ การเรียกใช้ที่มีคำขอเดียวกันจะสร้างรายงานใหม่

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
exchange

string

ต้องระบุ ชื่อของ Exchange ที่รายงานว่าเป็นของ Exchange ตัวอย่างเช่น "Exchanges/123" ต้องระบุ

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
ช่อง
startDate

string

ต้องระบุ วันที่เริ่มต้นของรายงานในรูปแบบ ISO_8601 ปปปป-ดด-วว ต้องระบุเป็นอินพุต
endDate

string

ต้องระบุ วันที่สิ้นสุดของรายงานในรูปแบบ ISO_8601 YYYY-MM-DD ต้องระบุเป็นอินพุต
reportType

enum (ReportType)

ต้องระบุ หากไม่ได้ระบุ ประเภทรายงานจะแสดงข้อผิดพลาด
dimensionIds[]

enum (DimensionId)

ไม่บังคับ รายการมิติข้อมูลตามรายงานที่จะสร้างขึ้น หากเป็นค่าว่าง ให้ใส่เฉพาะรหัสผู้เผยแพร่โฆษณา หากรายงานบางประเภทไม่รองรับมิติข้อมูล ระบบก็จะไม่สนใจมิติข้อมูลเหล่านั้น

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Report

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/doubleclickbidmanager

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ReportType

ประเภทรายงาน

Enum
REPORT_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทรายงาน ค่าที่ป้อนไม่ถูกต้อง
HOURLY ประเภทรายงานรายชั่วโมง
DAILY ประเภทรายงานแบบรายวัน
WEEKLY รายงานรายสัปดาห์
MONTHLY ประเภทรายงานรายเดือน

DimensionId

รายงาน DimensionId enum

Enum
DIMENSION_ID_UNSPECIFIED ไม่ได้ระบุมิติข้อมูลในรายงาน ค่าอินพุตไม่ถูกต้อง
PARTNER_ID รหัสพาร์ทเนอร์ รองรับเฉพาะในรายงานรายวัน
DEVICE_TYPE ประเภทอุปกรณ์ รองรับเฉพาะในรายงานรายวัน
CREATIVE_ID รหัสครีเอทีฟโฆษณารองรับเฉพาะในรายงานรายวันเท่านั้น โปรดทราบว่ามิติข้อมูลนี้อาจส่งผลต่อขนาดไฟล์ของรายงานอย่างมาก และรายงานที่มีมิติข้อมูลนี้อาจใช้เวลาหลายชั่วโมงในการเรียกใช้ ในอนาคต เราจะจำกัดการจัดประเภทในฟิลด์ที่มีภาระงานหนักเหล่านี้
CREATIVE_TYPE ประเภทโฆษณาที่รองรับในรายงานรายวันเท่านั้น โปรดทราบว่ามิติข้อมูลนี้อาจส่งผลต่อขนาดไฟล์ของรายงานอย่างมาก และรายงานที่มีมิติข้อมูลนี้อาจใช้เวลาหลายชั่วโมงในการเรียกใช้ ในอนาคต เราจะจำกัดการจัดประเภทในฟิลด์ที่มีภาระงานหนักเหล่านี้
REGION_CODE รหัสประเทศ/ภูมิภาคใช้ได้เฉพาะในรายงานรายวันเท่านั้น
DEAL_ID รหัสดีลซึ่งแมปกับแหล่งที่มาของพื้นที่โฆษณา ซึ่งใช้ได้ในรายงานรายวันเท่านั้น
PUBLISHER_ID รหัสผู้เผยแพร่โฆษณา หากรายการรหัสมิติข้อมูลอินพุตเป็นค่าว่าง จะเป็นมิติข้อมูลเริ่มต้น