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(السمة) 2) concatenate(dimension1, icon, feature2).

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