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(البلد, ", ", المدينة).

DimensionExpression

تُستخدَم للتعبير عن سمة هي نتيجة صيغة تتضمّن سمات متعددة. أمثلة على الاستخدامات: 1) lowerCase(السمة) 2) concatenate(السمة1, الرمز, السمة2).

تمثيل 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.
}
الحقول
حقل الربط one_expression حدِّد نوعًا واحدًا من تعبيرات السمات لسمة DimensionExpression. يمكن أن يكون one_expression واحدًا فقط مما يلي:
lowerCase

object (CaseExpression)

تُستخدَم لتحويل قيمة سمة إلى أحرف لاتينية صغيرة.
upperCase

object (CaseExpression)

تُستخدَم لتحويل قيمة سمة إلى أحرف كبيرة.
concatenate

object (ConcatenateExpression)

تُستخدَم هذه الدالة لدمج قيم السمات في سمة واحدة. على سبيل المثال، السمة "البلد، المدينة": concatenate(البلد, ", ", المدينة).

CaseExpression

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

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

string

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

ConcatenateExpression

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

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

string

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

string

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

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