Method: properties.batchRunPivotReports

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

แสดงผลรายงาน Pivot หลายรายการเป็นกลุ่ม รายงานทั้งหมดต้องเป็นของพร็อพเพอร์ตี้ GA4 เดียวกัน

คำขอ HTTP

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunPivotReports

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

ตัวระบุพร็อพเพอร์ตี้ GA4 ของ Google Analytics ที่มีการติดตามเหตุการณ์ ระบุไว้ในเส้นทางของ URL ไม่ใช่เนื้อหา ดูข้อมูลเพิ่มเติมได้ที่วิธีค้นหารหัสพร็อพเพอร์ตี้ ต้องระบุพร็อพเพอร์ตี้นี้สําหรับกลุ่ม พร็อพเพอร์ตี้ภายใน RunPivotReportRequest อาจไม่ระบุไว้หรือสอดคล้องกับพร็อพเพอร์ตี้นี้

ตัวอย่าง: พร็อพเพอร์ตี้/1234

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

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

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

object (RunPivotReportRequest)

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

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

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

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

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

object (RunPivotReportResponse)

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

string

ระบุประเภทของข้อความนี้ kind นี้เป็นสตริงคงที่ "analyticsData#batchRunPivotReports" มีประโยชน์ในการแยกแยะระหว่างการตอบกลับประเภทต่างๆ ใน JSON

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

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

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

RunPivotReportRequest

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

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

string

ตัวระบุพร็อพเพอร์ตี้ GA4 ของ Google Analytics ที่มีการติดตามเหตุการณ์ ระบุไว้ในเส้นทางของ URL ไม่ใช่เนื้อหา ดูข้อมูลเพิ่มเติมได้ที่วิธีค้นหารหัสพร็อพเพอร์ตี้ ภายในคําขอแบบกลุ่ม พร็อพเพอร์ตี้นี้ไม่ควรระบุหรือสอดคล้องกับพร็อพเพอร์ตี้ระดับกลุ่ม

ตัวอย่าง: พร็อพเพอร์ตี้/1234
dimensions[]

object (Dimension)

มิติข้อมูลที่ขอ มิติข้อมูลที่กําหนดไว้ทั้งหมดต้องใช้รายการใดรายการหนึ่งต่อไปนี้มิติข้อมูล Expressมิติข้อมูล, ตัวกรองตัวกรอง, Pivot, OrderBys
metrics[]

object (Metric)

เมตริกที่ขอ ต้องระบุเมตริกอย่างน้อย 1 รายการ เมตริกที่กําหนดทั้งหมดจะต้องใช้เมตริกใดเมตริกหนึ่งต่อไปนี้ ได้แก่เมตริก_นิพจน์, ตัวกรองเมตริก, orderBys
dateRanges[]

object (DateRange)

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

object (Pivot)

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

object (FilterExpression)

ตัวกรองตัวกรองของมิติข้อมูล ต้องส่งคําขอใช้มิติข้อมูลในตัวกรองนี้ ใช้เมตริกในตัวกรองนี้ไม่ได้
metricFilter

object (FilterExpression)

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

string

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

object (CohortSpec)

กลุ่มกลุ่มประชากรตามรุ่นที่เชื่อมโยงกับคําขอนี้ หากมีกลุ่มประชากรตามรุ่นในคําขอ มิติข้อมูล 'กลุ่มประชากรตามรุ่น&#39 จะต้องมีมิติข้อมูล
keepEmptyRows

boolean

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

boolean

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