طرحواره دسترسی به داده ها

ابعاد و معیارهای پشتیبانی شده در پرسش‌های مربوط به روش گزارش‌های دسترسی به داده API Admin Analytics.

ابعاد

ابعاد زیر را می توان در گزارش های دسترسی به داده ها درخواست کرد. "نام API" را در قسمت name بعد منبع AccessDimension برای ستونی از بعد در پاسخ گزارش مشخص کنید.

نام API	نام رابط کاربری	ویژگی های مجاز	توضیحات
accessDateHour	ساعت تاریخ دسترسی	تمام ویژگی های Google Analytics	ساعت تاریخ کاربر GA که به داده های گزارش GA دسترسی پیدا کرده است. قالب بندی شده به عنوان YYYYMMDDHH.
accessMechanism	مکانیزم دسترسی	ویژگی های Google Analytics 360	مکانیزمی که از طریق آن یک کاربر GA به داده های گزارش GA دسترسی پیدا کرد. مقادیر ممکن عبارتند از "Google Analytics User Interface"، "Google Analytics API"، "Firebase"، "Google Ads" و موارد دیگر.
accessedPropertyId	شناسه اموال قابل دسترسی	تمام ویژگی های Google Analytics	شناسه دارایی که در آن به داده های گزارش GA دسترسی داشت. بیشتر گزارش‌های دسترسی به داده فقط دارای یک ویژگی هستند، اما اگر ویژگی درخواستی دارای یک ویژگی فرعی باشد، گزارش‌های دسترسی به داده‌ها شامل دسترسی‌هایی به ویژگی منبع و ویژگی فرعی است. برای کسب اطلاعات بیشتر، به ویژگی‌های فرعی مراجعه کنید.
accessedPropertyName	دسترسی به نام ملک	تمام ویژگی های Google Analytics	نام نمایشی دارایی که در آن به داده های گزارش GA دسترسی داشت. بیشتر گزارش‌های دسترسی به داده فقط دارای یک ویژگی هستند، اما اگر ویژگی درخواستی دارای یک ویژگی فرعی باشد، گزارش‌های دسترسی به داده‌ها شامل دسترسی‌هایی به ویژگی منبع و ویژگی فرعی است. برای کسب اطلاعات بیشتر، به ویژگی‌های فرعی مراجعه کنید.
accessorAppName	نام برنامه Accessor	تمام ویژگی های Google Analytics	نام برنامه‌ای که به داده‌های گزارش Google Analytics دسترسی داشته است. به برنامه‌ها و سرویس‌های شخص ثالث اجازه دسترسی می‌دهید تا داده‌های گزارش Google Analytics خود را ببینند. برای کسب اطلاعات بیشتر، مدیریت ارتباطات بین حساب Google خود و اشخاص ثالث را ببینید.
costDataReturned	داده های هزینه برگردانده شده است	ویژگی های Google Analytics 360	اگر داده‌های هزینه در این گزارش برگردانده شده باشد، true برمی‌گردد. در غیر این صورت، این بعد false برمی گردد. کاربران GA با محدودیت «بدون سنجه هزینه» نمی‌توانند معیارهای هزینه را ببینند. تا زمانی که آن محدودیت فعال است، این بعد همیشه false خواهد بود. برای کسب اطلاعات بیشتر، دسترسی و مدیریت محدودیت داده را ببینید.
dataApiQuotaCategory	دسته سهمیه Data API	تمام ویژگی های Google Analytics	دسته سهمیه برای درخواست Data API. مقادیر ممکن عبارتند از: "Core"، "Realtime" و "Funnel".
epochTimeMicros	میکرو زمان دوران	ویژگی های Google Analytics 360	یونیکس میکروثانیه از دورانی که کاربر GA به داده های گزارش GA دسترسی داشت. برای مثال، یک میکروثانیه یونیکس از '1655220215027371' 2022-06-14 11:23:35 در آمریکا/نیویورک است.
mostRecentAccessEpochTimeMicros	جدیدترین میکروزهای زمان عصر دسترسی	ویژگی های Google Analytics 360	آخرین مهر زمان دسترسی برای این ردیف. در یونیکس میکروثانیه از دوران بازگشت. معمولاً با 'userEmail' و ابعاد مشابه برای تعیین آخرین زمان دسترسی کاربران GA استفاده می شود.
reportType	نوع گزارش	ویژگی های Google Analytics 360	نوع داده های گزارشی که کاربر GA به آن دسترسی داشته است. مقادیر ممکن عبارتند از «گزارش»، «زمان واقعی»، «کاوش فرم رایگان»، «کاوش قیف» و موارد دیگر.
revenueDataReturned	داده های درآمد برگردانده شد	ویژگی های Google Analytics 360	اگر داده‌های درآمدی در این گزارش برگردانده شده باشد، true است. در غیر این صورت، این بعد false برمی گردد. کاربران GA با محدودیت «بدون میزان درآمد» نمی‌توانند معیارهای درآمد را ببینند. تا زمانی که آن محدودیت فعال است، این بعد همیشه false خواهد بود. برای کسب اطلاعات بیشتر، دسترسی و مدیریت محدودیت داده را ببینید.
userCountry	کشور کاربر	ویژگی های Google Analytics 360	کشور کاربر GA که به داده های گزارش GA دسترسی داشته است.
userCountryId	شناسه کشور کاربر	ویژگی های Google Analytics 360	شناسه کشور کاربر GA که به داده های گزارش GA دسترسی داشته است. فرمت شده بر اساس استاندارد ISO 3166-1 alpha-2.
userEmail	ایمیل کاربر	تمام ویژگی های Google Analytics	ایمیل کاربر GA که به داده های گزارش GA دسترسی داشته است. برخی از ادغام‌ها به کاربران اجازه می‌دهند تا از طریق ادغام به داده‌های گزارش GA دسترسی داشته باشند، بدون اینکه کاربر دسترسی مستقیم به دارایی داشته باشد. در آن صورت، 'userEmail' بسته به ادغام، به عنوان مثال 'Google Ads Linked User' برمی گردد.
userIP	IP کاربر	ویژگی های Google Analytics 360	IP کاربر GA که به داده های گزارش GA دسترسی داشته است.

معیارها

معیارهای زیر را می توان در گزارش های دسترسی به داده ها درخواست کرد. "نام API" را در قسمت name متریک منبع AccessMetric برای ستونی از متریک در پاسخ گزارش مشخص کنید.

نام API	نام رابط کاربری	ویژگی های مجاز	توضیحات
accessCount	تعداد دسترسی	ویژگی های Google Analytics 360	تعداد دفعاتی که به داده های گزارش GA دسترسی پیدا کرده است. هنگام استفاده از رابط کاربری Google Analytics، هر کارت گزارش می تواند منجر به یک یا چند رویداد دسترسی به داده شود. در نتیجه، پیمایش در رابط کاربری Google Analytics می‌تواند منجر به رویدادهای دسترسی بیشتر از تعداد گزارش‌های مشاهده‌شده شود.
dataApiQuotaPropertyTokensConsumed	توکن های دارای سهمیه API داده مصرف شده است	تمام ویژگی های Google Analytics	کل توکن های سهمیه دارایی مصرف شده برای درخواست های Data API را برمی گرداند.