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ố có người dùng đã kích hoạt sự kiệ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ần 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ần 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ần Phương diện 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, name có thể là bất kỳ chuỗi nào bạn muốn trong tập 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_]$.

Phương diện được tham chiếu bằng 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 một công thức có 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 
{

  // 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 hợp nhất 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 giá trị sau:
lowerCase

object (CaseExpression)

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

object (CaseExpression)

Dùng để chuyển đổi 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ố).

CaseExpression

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

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. Tên phải tham chiếu lại 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ự khác 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".