Method: properties.getMetadata

傳回報表方法中可用的維度和指標的中繼資料。用於探索維度和指標。在這種方法中，要求會指定 Google Analytics 資源 ID，中繼資料回應則包含自訂維度和指標，以及通用中繼資料。

舉例來說，如果以參數名稱 levels_unlocked 註冊自訂指標至資源，中繼資料回應就會包含 customEvent:levels_unlocked。通用中繼資料是可套用至任何資源 (例如 country 和 totalUsers) 的維度和指標。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。要擷取的中繼資料資源名稱。這個名稱欄位是在網址路徑中指定，而不是在網址參數中指定。資源是 Google Analytics 資源的數字 ID。詳情請參閱「如何查看資源 ID」。

範例：properties/1234/metadata

將資源 ID 設為 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

此比較項目的說明。