Method: runPivotReport

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

คำขอ HTTP

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

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

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

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

การแสดง 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)

มิติข้อมูลที่ขอ ต้องใช้มิติข้อมูลที่กำหนดทั้งหมดโดยค่าใดค่าหนึ่งต่อไปนี้ ได้แก่dimensionExpression, dimensionFilter, Pivot, orderBys

metrics[]

object (Metric)

เมตริกที่ขอ ต้องระบุเมตริกอย่างน้อย 1 รายการ ต้องใช้เมตริกที่กำหนดทั้งหมดโดยรายการใดรายการหนึ่งต่อไปนี้ ได้แก่metric_expression, contactsFilter, orderBys

dimensionFilter

object (FilterExpression)

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

metricFilter

object (FilterExpression)

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

pivots[]

object (Pivot)

อธิบายรูปแบบภาพของมิติข้อมูลของรายงานในคอลัมน์หรือแถว การรวมค่าfieldNames (ชื่อมิติข้อมูล) ใน 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

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

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

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

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

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