Dimension

Thứ nguyên là thuộc tính dữ liệu của bạn. Ví dụ: phương diện thành phố cho biết thành phố nơi một sự kiện bắt nguồn. Giá trị phương diện trong phản hồi báo cáo là chuỗi; ví dụ: thành phố có thể là "Paris" hoặc "New York". Yêu cầu được phép có tối đa 9 phương diện.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Trường
name

string

Tên của phương diện. Hãy xem Phương diện API để biết danh sách tên phương diện được các phương thức báo cáo chính hỗ trợ, chẳng hạn như runReport và batchRunReports. Hãy xem Phương diện theo thời gian thực để biết danh sách tên phương diện mà phương thức runRealtimeReport hỗ trợ. Hãy xem Phương diện trong phễu để biết danh sách tên phương diện mà phương thức runFunnelReport hỗ trợ.

Nếu bạn chỉ định dimensionExpression, thì name có thể là bất kỳ chuỗi nào bạn muốn trong bộ ký tự được phép. Ví dụ: nếu dimensionExpression nối country và city, bạn có thể gọi phương diện đó là countryAndCity. Tên phương diện mà bạn chọn phải khớp với biểu thức chính quy ^[a-zA-Z0-9_]$.

Các phương diện được tham chiếu theo name trong dimensionFilter, orderBys, dimensionExpression và pivots.
dimensionExpression

object (DimensionExpression)

Một phương diện có thể là kết quả của một biểu thức gồm nhiều phương diện. Ví dụ: phương diện "quốc gia, thành phố": concatenate(quốc gia, ", ", thành phố).

DimensionExpression

Dùng để biểu thị một phương diện là kết quả của công thức gồm nhiều phương diện. Ví dụ về cách sử dụng: 1) lowerCase(phương diện) 2) concatenate(phương diện1, ký hiệu, phương diện2).

Biểu diễn dưới dạng 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.
}
Trường
Chỉ định một loại biểu thức phương diện cho DimensionExpression. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
lowerCase

object (CaseExpression)

Dùng để chuyển đổi một giá trị phương diện thành chữ thường.
upperCase

object (CaseExpression)

Dùng để chuyển đổi một giá trị phương diện thành chữ hoa.
concatenate

object (ConcatenateExpression)

Dùng để kết hợp các giá trị phương diện thành một phương diện duy nhất. Ví dụ: phương diện "quốc gia, thành phố": concatenate(quốc gia, ", ", thành phố).
Kết thúc các trường xung khắc.

CaseExpression

Được dùng để chuyển đổi một giá trị phương diện thành một trường hợp duy nhất.

Biểu diễn dưới dạng JSON 
{
  "dimensionName": string
}
Trường
dimensionName

string

Tên của một phương diện. Tên này phải tham chiếu lại đến một tên trong trường phương diện của yêu cầu.

ConcatenateExpression

Dùng để kết hợp các giá trị phương diện thành một phương diện duy nhất.

Biểu diễn dưới dạng JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Trường
dimensionNames[]

string

Tên của phương diện. Các tên này phải tham chiếu lại đến tên trong trường phương diện của yêu cầu.
delimiter

string

Dấu phân cách được đặt giữa các tên phương diện.

Dấu phân cách thường là các ký tự đơn như "|" hoặc ",", nhưng cũng có thể là các chuỗi dài hơn. Nếu một giá trị phương diện chứa dấu phân cách, thì cả hai sẽ xuất hiện trong phản hồi mà không có sự phân biệt. Ví dụ: nếu giá trị phương diện 1 = "US,FR", giá trị phương diện 2 = "JP" và dấu phân cách = ",", thì phản hồi sẽ chứa "US,FR,JP".