Method: runPivotReport

گزارش محوری سفارشی داده‌های رویداد Google Analytics شما را برمی‌گرداند. گزارش‌های محوری، فرمت‌های پیشرفته‌تر و گویاتر از گزارش‌های معمولی هستند. در گزارش محوری، ابعاد تنها در صورتی قابل مشاهده هستند که در یک محور قرار گیرند. برای تجزیه و تحلیل بیشتر داده‌های شما، می‌توان چند محور مشخص کرد.

درخواست HTTP

POST https://analyticsdata.googleapis.com/v1alpha:runPivotReport

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
زمینه های
entity

object ( Entity )

ملکی که وقایع آن پیگیری می شود. در یک درخواست دسته ای، این موجودیت باید یا نامشخص باشد یا با موجودیت در سطح دسته ای سازگار باشد.

dimensions[]

object ( Dimension )

ابعاد درخواستی همه ابعاد تعریف شده باید توسط یکی از موارد زیر استفاده شوند: dimensionExpression، dimensionFilter، pivots، orderBys.

metrics[]

object ( Metric )

معیارهای درخواستی، حداقل یک معیار باید مشخص شود. همه معیارهای تعریف شده باید توسط یکی از موارد زیر استفاده شوند: metric_expression، metricFilter، orderBys.

dimensionFilter

object ( FilterExpression )

بند فیلتر ابعاد. برای استفاده در این فیلتر باید ابعاد درخواست شود. معیارها را نمی توان در این فیلتر استفاده کرد.

metricFilter

object ( FilterExpression )

بند فیلتر معیارها. در مرحله پس از تجمع، مشابه SQL دارای بند اعمال می شود. برای استفاده در این فیلتر باید معیارها را درخواست کرد. در این فیلتر نمی توان از ابعاد استفاده کرد.

pivots[]

object ( Pivot )

قالب بصری ابعاد گزارش را در ستون یا ردیف توضیح می دهد. اتحاد فیلدNames (نام ابعاد) در همه محورها باید زیرمجموعه ای از نام ابعاد تعریف شده در Dimensions باشد. هیچ دو محوری نمی تواند یک بعد را به اشتراک بگذارد. یک بعد فقط زمانی قابل مشاهده است که در یک محور ظاهر شود.

dateRanges[]

object ( DateRange )

محدوده تاریخ برای بازیابی اطلاعات رویداد برای گزارش. اگر چندین محدوده تاریخ مشخص شده باشد، داده های رویداد از هر محدوده تاریخ در گزارش استفاده می شود. یک بعد خاص با نام فیلد "DateRange" را می توان در نام فیلدهای Pivot گنجاند. اگر شامل شود، گزارش بین محدوده تاریخ مقایسه می شود. در یک درخواست گروهی، این dateRanges باید نامشخص باشد.

currencyCode

string

یک کد ارز در قالب ISO4217، مانند "AED"، "USD"، "JPY". اگر فیلد خالی باشد، گزارش از واحد پول پیش‌فرض موجودیت استفاده می‌کند.

cohortSpec

object ( CohortSpec )

گروه کوهورت مرتبط با این درخواست. اگر یک گروه کوهورت در درخواست وجود دارد، بعد "همگروهی" باید وجود داشته باشد.

keepEmptyRows

boolean

اگر نادرست یا نامشخص باشد، هر ردیف با تمام معیارهای برابر با 0 برگردانده نخواهد شد. اگر درست باشد، اگر این ردیف‌ها به‌طور جداگانه توسط فیلتر حذف نشوند، برگردانده می‌شوند.

returnPropertyQuota

boolean

وضعیت فعلی سهمیه این Analytics Property را تغییر می‌دهد یا خیر. سهمیه در PropertyQuota برگردانده می شود.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از RunPivotReportResponse است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics