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 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

Enum DimensionId ของรายงาน

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