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) lessCase(dimension) 2) concatenate(dimension1, icon, dimension2).

تمثيل 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(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".