Method: properties.checkCompatibility

تُدرِج طريقة التوافق هذه السمات والمقاييس التي يمكن إضافتها إلى طلب تقرير والحفاظ على التوافق. تفشل هذه الطريقة إذا كانت سمات الطلب ومقاييسه غير متوافقة.

في "إحصاءات Google"، يتعذّر عرض التقارير إذا طلبت سمات و/أو مقاييس غير متوافقة. في هذه الحالة، عليك إزالة السمات و/أو المقاييس من التقرير غير المتوافق إلى أن يصبح التقرير متوافقًا.

تتضمّن تقارير "الوقت الفعلي" و"التقارير الأساسية" قواعد توافق مختلفة. تتحقّق هذه الطريقة من التوافق مع التقارير الأساسية.

طلب HTTP

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:checkCompatibility

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
property

string

معرّف موقع على "إحصاءات Google" يتمّ تتبُّع أحداثه. لمزيد من المعلومات، اطّلِع على مقالة أماكن العثور على رقم تعريف موقعك. يجب أن تكون قيمة property هي نفسها القيمة الواردة في طلب runReport.

مثال: properties/1234

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "compatibilityFilter": enum (Compatibility)
}
الحقول
dimensions[]

object (Dimension)

السمات الواردة في هذا التقرير يجب أن تكون قيمة dimensions هي نفسها القيمة الواردة في طلب runReport.
metrics[]

object (Metric)

المقاييس الواردة في هذا التقرير يجب أن تكون قيمة metrics هي نفسها القيمة الواردة في طلب runReport.
dimensionFilter

object (FilterExpression)

عبارة الفلتر الخاصة بالسمات يجب أن تكون قيمة dimensionFilter هي نفسها القيمة الواردة في طلب runReport.
metricFilter

object (FilterExpression)

عبارة الفلتر الخاصة بالمقاييس. يجب أن تكون قيمة metricFilter هي نفسها القيمة المستخدَمة في طلب runReport.
compatibilityFilter

enum (Compatibility)

تتم فلترة السمات والمقاييس في الردّ لتشمل هذا التوافق فقط. يُستخدَم عادةً كـ ”compatibilityFilter”: “COMPATIBLE” لعرض السمات والمقاييس المتوافقة فقط.

نص الاستجابة

تعرض استجابة التوافق مدى توافق كل سمة ومقياس.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "dimensionCompatibilities": [
    {
      object (DimensionCompatibility)
    }
  ],
  "metricCompatibilities": [
    {
      object (MetricCompatibility)
    }
  ]
}
الحقول
dimensionCompatibilities[]

object (DimensionCompatibility)

توافُق كل سمة
metricCompatibilities[]

object (MetricCompatibility)

توافُق كل مقياس

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

التوافق

أنواع التوافق لسمة أو مقياس واحد

عمليات التعداد
COMPATIBILITY_UNSPECIFIED التوافق غير محدّد.
COMPATIBLE السمة أو المقياس متوافقان. يمكن إضافة هذه السمة أو المقياس بنجاح إلى تقرير.
INCOMPATIBLE السمة أو المقياس غير متوافقَين. لا يمكن إضافة هذه السمة أو المقياس بنجاح إلى تقرير.

DimensionCompatibility

تمثّل هذه السمة مستوى التوافق مع سمة واحدة.

تمثيل JSON 
{
  "dimensionMetadata": {
    object (DimensionMetadata)
  },
  "compatibility": enum (Compatibility)
}
الحقول
dimensionMetadata

object (DimensionMetadata)

تحتوي البيانات الوصفية للسمة على اسم واجهة برمجة التطبيقات الخاص بمعلومات التوافق هذه. تحتوي البيانات الوصفية للسمة أيضًا على معلومات مفيدة أخرى، مثل اسم واجهة المستخدم ووصفها.
compatibility

enum (Compatibility)

تشير إلى مدى توافق هذه السمة. إذا كانت حالة التوافق هي COMPATIBLE، يمكن إضافة هذه السمة بنجاح إلى التقرير.

MetricCompatibility

التوافق مع مقياس واحد

تمثيل JSON 
{
  "metricMetadata": {
    object (MetricMetadata)
  },
  "compatibility": enum (Compatibility)
}
الحقول
metricMetadata

object (MetricMetadata)

تحتوي البيانات الوصفية للمقياس على اسم واجهة برمجة التطبيقات الخاص بمعلومات التوافق هذه. تحتوي البيانات الوصفية للمقياس أيضًا على معلومات مفيدة أخرى، مثل اسم واجهة المستخدم ووصفها.
compatibility

enum (Compatibility)

تحدّد هذه السمة مدى توافق المقياس. إذا كانت حالة التوافق هي COMPATIBLE، يمكن إضافة هذا المقياس بنجاح إلى التقرير.