- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ความเข้ากันได้
- DimensionCompatibility
- MetricCompatibility
- ลองใช้งาน
วิธีความเข้ากันได้นี้จะแสดงรายการมิติข้อมูลและเมตริกที่สามารถเพิ่มลงในคำขอรายงานและรักษาความเข้ากันได้ วิธีนี้จะไม่สำเร็จหากมิติข้อมูลและเมตริกของคำขอใช้ร่วมกันไม่ได้
รายงานใน Google Analytics จะล้มเหลวหากขอมิติข้อมูลและ/หรือเมตริกที่ใช้ร่วมกันไม่ได้ ในกรณีนี้ คุณจะต้องนํามิติข้อมูลและ/หรือเมตริกออกจากรายงานที่ใช้ร่วมกันไม่ได้จนกว่ารายงานจะใช้งานร่วมกันได้
รายงานแบบเรียลไทม์และรายงานหลักมีกฎความเข้ากันได้แตกต่างกัน วิธีนี้จะตรวจสอบความเข้ากันได้ของรายงานหลัก
คำขอ HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:checkCompatibility
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
property |
ตัวระบุพร็อพเพอร์ตี้ GA4 ของ Google Analytics ที่มีการติดตามเหตุการณ์ ดูข้อมูลเพิ่มเติมได้ในวิธีค้นหารหัสพร็อพเพอร์ตี้ เช่น พร็อพเพอร์ตี้/1234 |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "dimensions": [ { object ( |
ช่อง | |
---|---|
dimensions[] |
มิติข้อมูลในรายงานนี้ |
metrics[] |
เมตริกในรายงานนี้ |
dimensionFilter |
ข้อความตัวกรองของมิติข้อมูล |
metricFilter |
ข้อความตัวกรองของเมตริก |
compatibilityFilter |
กรองมิติข้อมูลและเมตริกตามความเข้ากันได้นี้เท่านั้น โดยทั่วไปมักใช้ในฐานะ |
เนื้อหาการตอบกลับ
การตอบสนองเกี่ยวกับความเข้ากันได้ที่มีความเข้ากันได้ของแต่ละมิติข้อมูลและ เมตริก
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "dimensionCompatibilities": [ { object ( |
ช่อง | |
---|---|
dimensionCompatibilities[] |
ความเข้ากันได้ของมิติข้อมูลแต่ละรายการ |
metricCompatibilities[] |
ความเข้ากันได้ของเมตริกแต่ละรายการ |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ความเข้ากันได้
ประเภทความเข้ากันได้สำหรับมิติข้อมูลหรือเมตริกรายการเดียว
Enum | |
---|---|
COMPATIBILITY_UNSPECIFIED |
ความเข้ากันได้ที่ไม่ระบุ |
COMPATIBLE |
มิติข้อมูลหรือเมตริกใช้ร่วมกันได้ เพิ่มมิติข้อมูลหรือเมตริกนี้ลงในรายงานเรียบร้อยแล้ว |
INCOMPATIBLE |
มิติข้อมูลหรือเมตริกใช้ร่วมกันไม่ได้ เพิ่มมิติข้อมูลหรือเมตริกนี้ลงในรายงานไม่สำเร็จ |
DimensionCompatibility
ความเข้ากันได้สำหรับมิติข้อมูลเดียว
การแสดง JSON |
---|
{ "dimensionMetadata": { object ( |
ช่อง | |
---|---|
dimensionMetadata |
ข้อมูลเมตาของมิติข้อมูลมีชื่อ API สําหรับข้อมูลความเข้ากันได้นี้ นอกจากนี้ ข้อมูลเมตาของมิติข้อมูลยังมีข้อมูลที่เป็นประโยชน์อื่นๆ เช่น ชื่อและคำอธิบาย UI |
compatibility |
ความเข้ากันได้ของมิติข้อมูลนี้ หากความเข้ากันได้สามารถเข้ากันได้ คุณจะเพิ่มมิติข้อมูลนี้ลงในรายงานได้สำเร็จ |
MetricCompatibility
ความเข้ากันได้สำหรับเมตริกเดียว
การแสดง JSON |
---|
{ "metricMetadata": { object ( |
ช่อง | |
---|---|
metricMetadata |
ข้อมูลเมตาของเมตริกมีชื่อ API สำหรับข้อมูลความเข้ากันได้นี้ นอกจากนี้ ข้อมูลเมตาของเมตริกยังประกอบด้วยข้อมูลที่เป็นประโยชน์อื่นๆ เช่น ชื่อและคำอธิบาย UI |
compatibility |
ความเข้ากันได้ของเมตริกนี้ หากความเข้ากันได้สามารถเข้ากันได้ คุณจะเพิ่มเมตริกนี้ลงในรายงานได้สำเร็จ |