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)

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

MetricCompatibility

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

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

object (MetricMetadata)

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

enum (Compatibility)

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