Dimension

Thứ nguyên là thuộc tính dữ liệu của bạn. Ví dụ: thành phố của phương diện 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 của báo cáo là chuỗi; ví dụ: thành phố có thể là "Paris" hoặc "New York". Hệ thống cho phép yêu cầu 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 phương diện. Xem phần Phương diện API để biết danh sách tên phương diện được các phương pháp báo cáo chính hỗ trợ (chẳng hạn như runReport và batchRunReports). Hãy xem mục Phương diện theo thời gian thực để biết danh sách các tên phương diện mà phương thức runRealtimeReport hỗ trợ. Xem mục Phương diện phễu để biết danh sách các tên phương diện mà phương thức runFunnelReport hỗ trợ.

Nếu bạn chỉ định dimensionExpression, name có thể là chuỗi bất kỳ mà bạn muốn trong bộ ký tự cho 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 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 name tham chiếu 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 của nhiều phương diện. Ví dụ: phương diện "country, city": concatenate(country, ", ", city).

DimensionExpression

Được dùng để thể hiện một phương diện là kết quả của công thức của nhiều phương diện. Ví dụ về cách sử dụng: 1) lowerCase(dimension) 2) concatenate(dimension1, character, dimension2).

Biểu diễn dưới dạng JSON 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Trường
Trường hợp one_expression. Chỉ định một loại biểu thức phương diện cho DimensionExpression. one_expression chỉ có thể là một trong những trạng thái sau:
lowerCase

object (CaseExpression)

Được dùng để chuyển đổi giá trị thứ nguyên thành chữ thường.
upperCase

object (CaseExpression)

Được dùng để chuyển đổi giá trị thứ nguyê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 "country, city": concatenate(country, ", ", city).

CaseExpression

Được dùng để chuyển đổi một giá trị thứ nguyên sang 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 đến 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 phương diện. Các tên này phải tham chiếu đến tên trong trường phương diện của yêu cầu.
delimiter

string

Dấu phân cách 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ó thể là các chuỗi dài hơn. Nếu một giá trị kích thước chứa dấu phân cách, cả hai sẽ xuất hiện trong phản hồi mà không có sự khác biệt. Ví dụ: nếu giá trị của phương diện 1 = "US,FR", giá trị của phương diện 2 = "JP" và dấu phân cách = ", thì nội dung phản hồi sẽ chứa "US,FR,JP".