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) LowCase(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".