Dimension

ابعاد، ویژگی‌های داده‌های شما هستند. برای مثال، بُعد شهر، شهری را نشان می‌دهد که یک رویداد از آن سرچشمه می‌گیرد. مقادیر ابعاد در پاسخ‌های گزارش، رشته هستند؛ برای مثال، شهر می‌تواند "پاریس" یا "نیویورک" باشد. درخواست‌ها تا 9 بُعد مجاز هستند.

نمایش JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
فیلدها
name

string

نام بُعد. برای فهرست نام‌های بُعد پشتیبانی‌شده توسط روش‌های گزارش‌گیری اصلی مانند runReport و batchRunReports به API Dimensions مراجعه کنید. برای فهرست نام‌های بُعد پشتیبانی‌شده توسط روش runRealtimeReport به Realtime Dimensions مراجعه کنید. برای فهرست نام‌های بُعد پشتیبانی‌شده توسط روش runFunnelReport به Funnel Dimensions مراجعه کنید.

اگر dimensionExpression مشخص شده باشد، name می‌تواند هر رشته‌ای باشد که شما در مجموعه کاراکترهای مجاز می‌خواهید. برای مثال، اگر یک dimensionExpression country و city را به هم متصل کند، می‌توانید آن بُعد را countryAndCity بنامید. نام‌های بُعدی که انتخاب می‌کنید باید با عبارت منظم ^[a-zA-Z0-9_]$ مطابقت داشته باشند.

ابعاد با name در dimensionFilter ، orderBys ، dimensionExpression و pivots ارجاع داده می‌شوند.

dimensionExpression

object ( DimensionExpression )

یک بُعد می‌تواند حاصل عبارتی با چندین بُعد باشد. برای مثال، بُعد "کشور، شهر": concatenate(country, ", ", city).

بیان ابعاد

برای بیان بُعدی که نتیجه فرمولی با چندین بُعد است، استفاده می‌شود. مثال‌های کاربرد: ۱) lowerCase(dimension) ۲) concatenate(dimension1, symbol, dimension2).

نمایش JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
فیلدها
یک نوع عبارت بُعد برای DimensionExpression مشخص کنید. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
lowerCase

object ( CaseExpression )

برای تبدیل مقدار بُعد به حروف کوچک استفاده می‌شود.

upperCase

object ( CaseExpression )

برای تبدیل مقدار بُعد به حروف بزرگ استفاده می‌شود.

concatenate

object ( ConcatenateExpression )

برای ترکیب مقادیر بُعد در یک بُعد واحد استفاده می‌شود. برای مثال، بُعد "کشور، شهر": concatenate(country, ", ", city).

پایان میدان‌های ناسازگار.

عبارت موردی

برای تبدیل مقدار بُعد به یک مورد واحد استفاده می‌شود.

نمایش JSON 
{
  "dimensionName": string
}
فیلدها
dimensionName

string

نام یک بُعد. این نام باید به نامی در فیلد ابعاد درخواست اشاره کند.

عبارت الحاقی

برای ترکیب مقادیر بُعد در یک بُعد واحد استفاده می‌شود.

نمایش JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
فیلدها
dimensionNames[]

string

نام ابعاد. نام‌ها باید به نام‌های موجود در فیلد ابعاد درخواست اشاره داشته باشند.

delimiter

string

جداکننده‌ای که بین نام ابعاد قرار می‌گیرد.

جداکننده‌ها اغلب کاراکترهای تکی مانند "|" یا "," هستند، اما می‌توانند رشته‌های طولانی‌تری نیز باشند. اگر مقدار یک بُعد شامل جداکننده باشد، هر دو در پاسخ بدون هیچ تمایزی حضور خواهند داشت. برای مثال، اگر مقدار بُعد ۱ = "US,FR"، مقدار بُعد ۲ = "JP" و جداکننده = "," باشد، آنگاه پاسخ شامل "US,FR,JP" خواهد بود.