Method: properties.getMetadata

แสดงผลข้อมูลเมตาสําหรับมิติข้อมูลและเมตริกที่ใช้ได้กับวิธีการรายงาน ใช้เพื่อสํารวจมิติข้อมูลและเมตริก ในวิธีการนี้ ระบบจะระบุตัวระบุพร็อพเพอร์ตี้ Google Analytics ในคําขอ และคําตอบเกี่ยวกับข้อมูลเมตาจะรวมมิติข้อมูลและเมตริกที่กําหนดเอง รวมถึงข้อมูลเมตา Universal

เช่น หากมีการลงทะเบียนเมตริกที่กําหนดเองซึ่งมีชื่อพารามิเตอร์ levels_unlocked กับพร็อพเพอร์ตี้ การตอบกลับข้อมูลเมตาจะมี customEvent:levels_unlocked ข้อมูลเมตาสากลคือมิติข้อมูลและเมตริกที่ใช้กับพร็อพเพอร์ตี้ใดก็ได้ เช่น country และ totalUsers

คำขอ HTTP

GET https://analyticsdata.googleapis.com/v1beta/{name=properties/*/metadata}

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

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

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

string

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

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

กําหนดรหัสพร็อพเพอร์ตี้เป็น 0 สําหรับมิติข้อมูลและเมตริกที่ใช้ร่วมกันในพร็อพเพอร์ตี้ทั้งหมด ในโหมดพิเศษนี้ เมธอดนี้จะไม่แสดงผลมิติข้อมูลและเมตริกที่กําหนดเอง

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

เนื้อหาของคำขอต้องว่างเปล่า

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

มิติข้อมูล เมตริก และการเปรียบเทียบที่ยอมรับในปัจจุบันในวิธีการรายงาน

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

การแสดง JSON 
{
  "name": string,
  "dimensions": [
    {
      object (DimensionMetadata)
    }
  ],
  "metrics": [
    {
      object (MetricMetadata)
    }
  ],
  "comparisons": [
    {
      object (ComparisonMetadata)
    }
  ]
}
ช่อง
name

string

ชื่อแหล่งข้อมูลของข้อมูลเมตานี้
dimensions[]

object (DimensionMetadata)

คำอธิบายมิติข้อมูล
metrics[]

object (MetricMetadata)

คำอธิบายเมตริก
comparisons[]

object (ComparisonMetadata)

คำอธิบายการเปรียบเทียบ

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

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

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

ComparisonMetadata

ข้อมูลเมตาสําหรับการเปรียบเทียบรายการเดียว

การแสดง JSON 
{
  "apiName": string,
  "uiName": string,
  "description": string
}
ช่อง
apiName

string

ชื่อทรัพยากรของการเปรียบเทียบนี้ ใช้ได้ในช่อง comparison ของการเปรียบเทียบ เช่น "comparisons/1234"
uiName

string

ชื่อการเปรียบเทียบนี้ในอินเทอร์เฟซผู้ใช้ Google Analytics
description

string

คำอธิบายของการเปรียบเทียบนี้