แสดงรายงาน Pivot ที่กำหนดเองของข้อมูลเหตุการณ์ Google Analytics รายงาน Pivot เป็นรูปแบบที่มีความซับซ้อนและชัดเจนมากกว่ารายงานปกติ ในรายงาน Pivot มิติข้อมูลจะปรากฏก็ต่อเมื่อรวมอยู่ใน Pivot เท่านั้น สามารถระบุจุด Pivot ได้หลายรายการเพื่อแยกข้อมูลของคุณเพิ่มเติม
คำขอ HTTP
POST https://analyticsdata.googleapis.com/v1alpha:runPivotReport
URL ใช้ไวยากรณ์การแปลง gRPC
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้
การแสดง JSON | |
---|---|
{ "entity": { object ( |
ช่อง | |
---|---|
entity |
พร็อพเพอร์ตี้ที่มีการติดตามเหตุการณ์ ภายในคำขอแบบกลุ่ม เอนทิตีนี้ไม่ควรระบุหรือสอดคล้องกับเอนทิตีระดับกลุ่ม |
dimensions[] |
มิติข้อมูลที่ขอ มิติข้อมูลที่กําหนดทั้งหมดต้องใช้โดยค่าใดค่าหนึ่งต่อไปนี้ ลักษณะเฉพาะ (Expression), มิติข้อมูลตัวกรอง, Pivots, orderBys (orderBys) |
metrics[] |
เมตริกที่ขอ ต้องระบุเมตริกอย่างน้อย 1 รายการ เมตริกที่กำหนดไว้ทั้งหมดจะต้องใช้เมตริกใดค่าหนึ่งต่อไปนี้Metric_expression, MetricFilter, orderBys |
dimensionFilter |
อนุประโยคของตัวกรองขนาด ต้องขอมิติข้อมูลในตัวกรองนี้ เมตริกใช้ในตัวกรองนี้ไม่ได้ |
metricFilter |
เงื่อนไขตัวกรองของเมตริก ใช้ในขั้นตอนการรวมโพสต์ คล้ายกับคำสั่งที่มีใน SQL ต้องมีการขอเมตริกเพื่อใช้ในตัวกรองนี้ ใช้มิติข้อมูลในตัวกรองนี้ไม่ได้ |
pivots[] |
อธิบายรูปแบบภาพของมิติข้อมูลของรายงานในคอลัมน์หรือแถว การรวมชื่อฟิลด์ (ชื่อมิติข้อมูล) ใน Pivot ทั้งหมดต้องเป็นชุดย่อยของชื่อมิติข้อมูลที่กำหนดไว้ในมิติข้อมูล จุดเปลี่ยน 2 รายการที่แชร์มิติข้อมูลได้ มิติข้อมูลจะแสดงเมื่อปรากฏใน Pivot เท่านั้น |
dateRanges[] |
ช่วงวันที่ที่จะดึงข้อมูลเหตุการณ์สำหรับรายงาน หากระบุช่วงวันที่หลายช่วง ระบบจะใช้ข้อมูลเหตุการณ์จากแต่ละช่วงวันที่ในรายงาน มิติข้อมูลพิเศษที่มีชื่อช่อง "dateRange" สามารถรวมอยู่ในชื่อช่องของ Pivot หากมี รายงานจะเปรียบเทียบระหว่างช่วงวันที่ ต้องไม่ได้ระบุ |
currencyCode |
รหัสสกุลเงินในรูปแบบ ISO4217 เช่น "AED", "USD", "JPY" หากช่องนี้ว่างเปล่า รายงานจะใช้สกุลเงินเริ่มต้นของเอนทิตี |
cohortSpec |
กลุ่มประชากรตามรุ่นที่เชื่อมโยงกับคำขอนี้ หากมีกลุ่มประชากรตามรุ่นในคำขอ จะต้องมีมิติข้อมูล "กลุ่มประชากรตามรุ่น" ด้วย |
keepEmptyRows |
หากเป็น "เท็จ" หรือ "ไม่ได้ระบุ" ระบบจะไม่แสดงผลแต่ละแถวที่มีเมตริกทั้งหมดเท่ากับ 0 หากเป็นค่าจริง ระบบจะแสดงผลแถวเหล่านี้หากไม่มีการนําออกแยกกันโดยตัวกรอง |
returnPropertyQuota |
สลับว่าจะให้แสดงสถานะปัจจุบันของโควต้าพร็อพเพอร์ตี้ Analytics นี้หรือไม่ ระบบจะส่งโควต้ากลับมาใน PropertyQuota |
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ RunPivotReportResponse
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics