Method: properties.checkCompatibility

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

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

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

คำขอ HTTP

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

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

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

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

string

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

ตัวอย่าง: property/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)

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