Method: properties.checkCompatibility

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

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

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

طلب HTTP

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

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

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

المعلمات
property

string

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

مثال: المواقع الإلكترونية/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)

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