این روش سازگاری ابعاد و معیارهایی را فهرست میکند که میتوانند به درخواست گزارش اضافه شوند و سازگاری را حفظ کنند. اگر ابعاد و معیارهای درخواست ناسازگار باشند، این روش با شکست مواجه میشود.
در Google Analytics، گزارشها در صورت درخواست ابعاد و/یا معیارهای ناسازگار با شکست مواجه میشوند. در آن صورت، باید ابعاد و/یا معیارها را از گزارش ناسازگار حذف کنید تا زمانی که گزارش سازگار باشد.
گزارشهای Realtime و Core قوانین سازگاری متفاوتی دارند. این روش سازگاری را برای گزارش های Core بررسی می کند.
درخواست HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:checkCompatibility
یک شناسه دارایی Google Analytics که رویدادهای آن ردیابی می شوند. برای کسب اطلاعات بیشتر، ببینید شناسه ملک خود را از کجا پیدا کنید . property باید همان مقدار درخواست runReport شما باشد.
ابعاد و معیارها را در پاسخ به این سازگاری فیلتر می کند. معمولاً بهعنوان ”compatibilityFilter”: “COMPATIBLE” فقط برای برگرداندن ابعاد و معیارهای سازگار.
بدن پاسخگو
پاسخ سازگاری با سازگاری هر بعد و متریک.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis compatibility method verifies if the requested dimensions and metrics can be combined in a report without causing errors.\u003c/p\u003e\n"],["\u003cp\u003eThe method helps identify incompatible elements in your report requests and suggests removing them to ensure report generation.\u003c/p\u003e\n"],["\u003cp\u003eThe Realtime and Core reports have different compatibility rules, and this method specifically checks compatibility for Core reports.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter results to only receive compatible dimensions and metrics for easier integration into reports.\u003c/p\u003e\n"],["\u003cp\u003eThe compatibility response provides detailed information on the compatibility of each individual dimension and metric within your request.\u003c/p\u003e\n"]]],["This document details how to use the `checkCompatibility` method in Google Analytics to verify if dimensions and metrics are compatible for Core reports. It involves a POST request to a specific URL using gRPC Transcoding syntax, with a `property` path parameter. The request body includes `dimensions`, `metrics`, `dimensionFilter`, `metricFilter`, and a `compatibilityFilter`. The response indicates the compatibility status (`COMPATIBLE` or `INCOMPATIBLE`) of each dimension and metric via `dimensionCompatibilities` and `metricCompatibilities` fields, each containing metadata and the compatibility enum. OAuth scopes are required for authorization.\n"],null,[]]