Method: batchRunPivotReports

แสดงผลรายงาน Pivot หลายรายการเป็นกลุ่ม รายงานทั้งหมดต้องเป็นรายงานสำหรับเอนทิตีเดียวกัน

คำขอ HTTP

POST https://analyticsdata.googleapis.com/v1alpha:batchRunPivotReports

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

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

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

การแสดง JSON
{
  "entity": {
    object (Entity)
  },
  "requests": [
    {
      object (RunPivotReportRequest)
    }
  ]
}
ช่อง
entity

object (Entity)

พร็อพเพอร์ตี้ที่มีการติดตามเหตุการณ์ ต้องระบุเอนทิตีนี้สำหรับแบตช์ เอนทิตีภายใน RunPivotReportRequest อาจไม่ได้ระบุหรือสอดคล้องกับเอนทิตีนี้

requests[]

object (RunPivotReportRequest)

คำขอแต่ละรายการ แต่ละคำขอจะมีการตอบกลับจากรายงาน Pivot ที่แยกจากกัน คำขอแบบกลุ่มแต่ละรายการอนุญาตให้มีได้สูงสุด 5 รายการ

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การตอบกลับเป็นกลุ่มที่มีรายงาน Pivot หลายรายการ

การแสดง JSON
{
  "pivotReports": [
    {
      object (RunPivotReportResponse)
    }
  ]
}
ช่อง
pivotReports[]

object (RunPivotReportResponse)

คำตอบแต่ละรายการ แต่ละคำตอบจะมีคำขอรายงาน Pivot แยกจากกัน

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

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

RunPivotReportRequest

คำขอสร้างรายงาน Pivot

การแสดง JSON
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
ช่อง
entity

object (Entity)

พร็อพเพอร์ตี้ที่มีการติดตามเหตุการณ์ ภายในคำขอแบบกลุ่ม เอนทิตีนี้ไม่ควรระบุหรือสอดคล้องกับเอนทิตีระดับกลุ่ม

dimensions[]

object (Dimension)

มิติข้อมูลที่ขอ มิติข้อมูลที่กําหนดทั้งหมดต้องใช้โดยค่าใดค่าหนึ่งต่อไปนี้ ลักษณะเฉพาะ (Expression), มิติข้อมูลตัวกรอง, Pivots, orderBys (orderBys)

metrics[]

object (Metric)

เมตริกที่ขอ ต้องระบุเมตริกอย่างน้อย 1 รายการ เมตริกที่กำหนดไว้ทั้งหมดจะต้องใช้เมตริกใดค่าหนึ่งต่อไปนี้Metric_expression, MetricFilter, orderBys

dimensionFilter

object (FilterExpression)

อนุประโยคของตัวกรองขนาด ต้องขอมิติข้อมูลในตัวกรองนี้ เมตริกใช้ในตัวกรองนี้ไม่ได้

metricFilter

object (FilterExpression)

เงื่อนไขตัวกรองของเมตริก ใช้ในขั้นตอนการรวมโพสต์ คล้ายกับคำสั่งที่มีใน SQL ต้องมีการขอเมตริกเพื่อใช้ในตัวกรองนี้ ใช้มิติข้อมูลในตัวกรองนี้ไม่ได้

pivots[]

object (Pivot)

อธิบายรูปแบบภาพของมิติข้อมูลของรายงานในคอลัมน์หรือแถว การรวมชื่อฟิลด์ (ชื่อมิติข้อมูล) ใน Pivot ทั้งหมดต้องเป็นชุดย่อยของชื่อมิติข้อมูลที่กำหนดไว้ในมิติข้อมูล จุดเปลี่ยน 2 รายการที่แชร์มิติข้อมูลได้ มิติข้อมูลจะแสดงเมื่อปรากฏใน Pivot เท่านั้น

dateRanges[]

object (DateRange)

ช่วงวันที่ที่จะดึงข้อมูลเหตุการณ์สำหรับรายงาน หากระบุช่วงวันที่หลายช่วง ระบบจะใช้ข้อมูลเหตุการณ์จากแต่ละช่วงวันที่ในรายงาน มิติข้อมูลพิเศษที่มีชื่อช่อง "dateRange" สามารถรวมอยู่ในชื่อช่องของ Pivot หากมี รายงานจะเปรียบเทียบระหว่างช่วงวันที่ ต้องไม่ได้ระบุ dateRanges นี้ในคำขอกลุ่มประชากรตามรุ่น

currencyCode

string

รหัสสกุลเงินในรูปแบบ ISO4217 เช่น "AED", "USD", "JPY" หากช่องนี้ว่างเปล่า รายงานจะใช้สกุลเงินเริ่มต้นของเอนทิตี

cohortSpec

object (CohortSpec)

กลุ่มประชากรตามรุ่นที่เชื่อมโยงกับคำขอนี้ หากมีกลุ่มประชากรตามรุ่นในคำขอ จะต้องมีมิติข้อมูล "กลุ่มประชากรตามรุ่น" ด้วย

keepEmptyRows

boolean

หากเป็น "เท็จ" หรือ "ไม่ได้ระบุ" ระบบจะไม่แสดงผลแต่ละแถวที่มีเมตริกทั้งหมดเท่ากับ 0 หากเป็นค่าจริง ระบบจะแสดงผลแถวเหล่านี้หากไม่มีการนําออกแยกกันโดยตัวกรอง

returnPropertyQuota

boolean

สลับว่าจะให้แสดงสถานะปัจจุบันของโควต้าพร็อพเพอร์ตี้ Analytics นี้หรือไม่ ระบบจะส่งโควต้ากลับมาใน PropertyQuota