Method: properties.checkCompatibility

วิธีการเข้ากันได้นี้จะแสดงมิติข้อมูลและเมตริกที่เพิ่มลงในคําขอรายงานได้และยังคงเข้ากันได้ วิธีนี้จะดำเนินการไม่สําเร็จหากมิติข้อมูลและเมตริกของคําขอใช้ร่วมกันไม่ได้

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

รายงานแบบเรียลไทม์และรายงานหลักมีกฎความเข้ากันได้ที่แตกต่างกัน วิธีนี้จะตรวจสอบความเข้ากันได้ของรายงาน Core

คำขอ HTTP

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

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

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

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

string

ตัวระบุพร็อพเพอร์ตี้ Google Analytics ที่ระบบติดตามเหตุการณ์ ดูข้อมูลเพิ่มเติมได้ที่วิธีค้นหารหัสพร็อพเพอร์ตี้ property ควรเป็นค่าเดียวกับในคำขอ runReport

ตัวอย่าง: properties/1234

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

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

การแสดง JSON 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "compatibilityFilter": enum (Compatibility)
}
ช่อง
dimensions[]

object (Dimension)

มิติข้อมูลในรายงานนี้ dimensions ควรเป็นค่าเดียวกับในคำขอ runReport
metrics[]

object (Metric)

เมตริกในรายงานนี้ metrics ควรเป็นค่าเดียวกับในคำขอ runReport
dimensionFilter

object (FilterExpression)

ข้อความตัวกรองของมิติข้อมูล dimensionFilter ควรเป็นค่าเดียวกับในคำขอ runReport
metricFilter

object (FilterExpression)

ข้อความตัวกรองของเมตริก metricFilter ควรเป็นค่าเดียวกับในคําขอ runReport
compatibilityFilter

enum (Compatibility)

กรองมิติข้อมูลและเมตริกในการตอบกลับให้เหลือเฉพาะความเข้ากันได้นี้ มักใช้ในรูปแบบ ”compatibilityFilter”: “COMPATIBLE” เพื่อแสดงเฉพาะมิติข้อมูลและเมตริกที่เข้ากันได้

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

การตอบสนองความเข้ากันได้กับความเข้ากันได้ของมิติข้อมูลและเมตริกแต่ละรายการ

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

การแสดง JSON 
{
  "dimensionCompatibilities": [
    {
      object (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
ช่อง
dimensionCompatibilities[]

object (DimensionCompatibility)

ความเข้ากันได้ของมิติข้อมูลแต่ละรายการ
metricCompatibilities[]

object (MetricCompatibility)

ความเข้ากันได้ของเมตริกแต่ละรายการ

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ความเข้ากันได้

ประเภทความเข้ากันได้สําหรับมิติข้อมูลหรือเมตริกเดียว

Enum
COMPATIBILITY_UNSPECIFIED เข้ากันได้หรือไม่เข้ากันได้
COMPATIBLE มิติข้อมูลหรือเมตริกใช้ร่วมกันได้ มิติข้อมูลหรือเมตริกนี้เพิ่มลงในรายงานได้สําเร็จ
INCOMPATIBLE มิติข้อมูลหรือเมตริกใช้ร่วมกันไม่ได้ เพิ่มมิติข้อมูลหรือเมตริกนี้ลงในรายงานไม่สําเร็จ

DimensionCompatibility

ความเข้ากันได้ของมิติข้อมูลเดียว

การแสดง JSON 
{
  "dimensionMetadata": {
    object (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
ช่อง
dimensionMetadata

object (DimensionMetadata)

ข้อมูลเมตาของมิติข้อมูลจะมีชื่อ API สําหรับข้อมูลความเข้ากันได้นี้ ข้อมูลเมตาของมิติข้อมูลยังมีข้อมูลที่เป็นประโยชน์อื่นๆ ด้วย เช่น ชื่อและคำอธิบาย UI
compatibility

enum (Compatibility)

ความเข้ากันได้ของมิติข้อมูลนี้ หากความเข้ากันได้คือ "เข้ากันได้" คุณจะเพิ่มมิติข้อมูลนี้ลงในรายงานได้สําเร็จ

MetricCompatibility

ความเข้ากันได้ของเมตริกเดียว

การแสดง JSON 
{
  "metricMetadata": {
    object (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
ช่อง
metricMetadata

object (MetricMetadata)

โดยข้อมูลเมตาของเมตริกจะมีชื่อ API สําหรับข้อมูลความเข้ากันได้นี้ ข้อมูลเมตาของเมตริกยังมีข้อมูลที่เป็นประโยชน์อื่นๆ ด้วย เช่น ชื่อและคำอธิบาย UI
compatibility

enum (Compatibility)

ความเข้ากันได้ของเมตริกนี้ หากความเข้ากันได้คือ "เข้ากันได้" คุณจะเพิ่มเมตริกนี้ลงในรายงานได้สําเร็จ