Dimension

تمثِّل هذه السمات بياناتك. على سبيل المثال، تشير سمة "المدينة" إلى المدينة التي نشأ منها حدث. قيم السمات في ردود التقارير هي سلاسل، على سبيل المثال، يمكن أن تكون المدينة "القاهرة" أو "دبي". يُسمح بتقديم طلبات تصل إلى 9 سمات.

تمثيل JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
الحقول
name

string

اسم السمة اطّلِع على سمات واجهة برمجة التطبيقات للحصول على قائمة بأسماء السمات المتوافقة مع طرق إعداد التقارير الأساسية، مثل runReport وbatchRunReports. اطّلِع على السمات في الوقت الفعلي للحصول على قائمة بأسماء السمات المتوافقة مع الطريقة runRealtimeReport. اطّلِع على سمات المسار الإحالي الناجح للحصول على قائمة بأسماء السمات المتوافقة مع الطريقة runFunnelReport.

في حال تحديد dimensionExpression، يمكن أن تكون name أي سلسلة تريدها ضمن مجموعة الأحرف المسموح بها. على سبيل المثال، إذا كانت dimensionExpression تجمع بين country وcity، يمكنك تسمية هذه السمة countryAndCity. يجب أن تتطابق أسماء السمات التي تختارها مع التعبير العادي ^[a-zA-Z0-9_]$.

يتم الرجوع إلى السمات من خلال name في dimensionFilter وorderBys وdimensionExpression وpivots.
dimensionExpression

object (DimensionExpression)

يمكن أن تكون إحدى السمات نتيجة تعبير عن سمات متعددة. على سبيل المثال، السمة "البلد، المدينة": concatenate(country, ", ", city).

DimensionExpression

يُستخدَم للتعبير عن سمة ناتجة عن صيغة تتضمّن سمات متعددة. أمثلة على الاستخدام: 1) lowerCase(dimension) 2) 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).
نهاية الحقول التي يستبعد كلّ منها الآخر

CaseExpression

تُستخدَم لتحويل قيمة سمة إلى حالة واحدة.

تمثيل JSON 
{
  "dimensionName": string
}
الحقول
dimensionName

string

اسم إحدى السمات يجب أن يشير الاسم إلى اسم في حقل السمات الخاص بالطلب.

ConcatenateExpression

تُستخدَم لدمج قيم السمات في سمة واحدة.

تمثيل JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
الحقول
dimensionNames[]

string

أسماء السمات يجب أن تشير الأسماء إلى الأسماء الواردة في حقل السمات في الطلب.
delimiter

string

الفاصل الذي يتم وضعه بين أسماء السمات.

غالبًا ما تكون المحددات أحرفًا مفردة مثل "|" أو ","، ولكن يمكن أن تكون سلاسل أطول. إذا كانت قيمة السمة تحتوي على أداة الفصل، سيتم عرض كلتيهما في الرد بدون تمييز. على سبيل المثال، إذا كانت قيمة السمة 1 = "US,FR"، وقيمة السمة 2 = "JP"، والمحدّد = ","، سيتضمّن الردّ "US,FR,JP".