Method: properties.checkCompatibility

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

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

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

طلب HTTP

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

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

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

المَعلمات
property

string

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

مثال: Property/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)

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