- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- التوافق
- DimensionCompatibility
- MetricCompatibility
- جرِّبه الآن
وتسرد طريقة التوافق هذه السمات والمقاييس التي يمكن إضافتها إلى طلب تقرير مع الحفاظ على التوافق. يتعذّر تنفيذ هذه الطريقة إذا كانت سمات ومقاييس الطلب غير متوافقة.
وفي "إحصاءات Google"، يتعذّر على التقارير طلب سمات و/أو مقاييس غير متوافقة. وفي هذه الحالة، عليك إزالة السمات و/أو المقاييس من التقرير غير المتوافق إلى أن يصبح التقرير متوافقًا.
تختلف قواعد التوافق بين تقريرَي "الوقت الفعلي" و"الأساسية". تتحقّق هذه الطريقة من التوافق مع التقارير الأساسية.
طلب HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:checkCompatibility
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
property |
معرّف موقع على "إحصاءات Google 4" يتم تتبُّع أحداثه. للمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. يجب أن تكون القيمة مثال: Property/1234 |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "dimensions": [ { object ( |
الحقول | |
---|---|
dimensions[] |
السمات في هذا التقرير. يجب أن تكون القيمة |
metrics[] |
المقاييس في هذا التقرير يجب أن تكون القيمة |
dimensionFilter |
عبارة الفلتر للسمات. يجب أن تكون القيمة |
metricFilter |
عبارة فلتر المقاييس يجب أن تكون القيمة |
compatibilityFilter |
تعمل هذه السياسة على فلترة السمات والمقاييس في الردّ وفقًا لهذا التوافق فقط. يتم عادةً استخدام هذه السمة كـ |
نص الاستجابة
استجابة التوافق مع توافق كل سمة ومقياس.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "dimensionCompatibilities": [ { object ( |
الحقول | |
---|---|
dimensionCompatibilities[] |
مدى توافق كل سمة |
metricCompatibilities[] |
مدى توافق كل مقياس |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
التوافق
أنواع التوافق لسمة واحدة أو مقياس واحد.
عمليات التعداد | |
---|---|
COMPATIBILITY_UNSPECIFIED |
التوافق غير محدَّد. |
COMPATIBLE |
السمة أو المقياس متوافقان. يمكن إضافة هذه السمة أو المقياس إلى التقرير بنجاح. |
INCOMPATIBLE |
السمة أو المقياس غير متوافقَين. تتعذّر إضافة هذه السمة أو المقياس إلى التقرير بنجاح. |
DimensionCompatibility
التوافق مع سمة واحدة
تمثيل JSON |
---|
{ "dimensionMetadata": { object ( |
الحقول | |
---|---|
dimensionMetadata |
تحتوي البيانات الوصفية للسمات على اسم واجهة برمجة التطبيقات لمعلومات التوافق هذه. تحتوي البيانات الوصفية للسمات أيضًا على معلومات مفيدة أخرى، مثل اسم واجهة المستخدم ووصفها. |
compatibility |
توافق هذه السمة. إذا كان التوافق "متوافق"، يمكن إضافة هذه السمة إلى التقرير بنجاح. |
MetricCompatibility
تمثّل هذه السمة التوافق لمقياس واحد.
تمثيل JSON |
---|
{ "metricMetadata": { object ( |
الحقول | |
---|---|
metricMetadata |
تحتوي البيانات الوصفية للمقياس على اسم واجهة برمجة التطبيقات لمعلومات التوافق هذه. تحتوي البيانات الوصفية للمقياس أيضًا على معلومات مفيدة أخرى، مثل اسم واجهة المستخدم والوصف. |
compatibility |
توافق هذا المقياس. إذا كان التوافق "متوافق"، يمكن إضافة هذا المقياس إلى التقرير بنجاح. |