Method: reports.batchGet

داده های Analytics را برمی گرداند.

درخواست HTTP

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet

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

درخواست بدن

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

نمایندگی JSON
{
  "reportRequests": [
    {
      object(ReportRequest)
    }
  ],
  "useResourceQuotas": boolean
}
زمینه های
reportRequests[]

object( ReportRequest )

درخواست ها، هر درخواست پاسخ جداگانه ای خواهد داشت. حداکثر 5 درخواست وجود دارد. همه درخواست‌ها باید dateRanges ، viewId ، segments ، samplingLevel و cohortGroup یکسان داشته باشند.

useResourceQuotas

boolean

سهمیه‌های مبتنی بر منابع را فعال می‌کند، (پیش‌فرض به False ). اگر این فیلد روی True تنظیم شود، سهمیه‌های هر نمایش (نمایه) توسط هزینه محاسباتی درخواست کنترل می‌شود. توجه داشته باشید که استفاده از سهمیه های مبتنی بر هزینه، نرخ نمونه برداری را افزایش می دهد. (10 میلیون برای SMALL ، 100 میلیون برای LARGE . برای جزئیات به اسناد محدودیت ها و سهمیه ها مراجعه کنید.

بدن پاسخگو

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

کلاس پاسخگویی اصلی که گزارش های مربوط به تماس batchGet Reporting API را نگه می دارد.

نمایندگی JSON
{
  "reports": [
    {
      object(Report)
    }
  ],
  "queryCost": number,
  "resourceQuotasRemaining": {
    object(ResourceQuotasRemaining)
  }
}
زمینه های
reports[]

object( Report )

پاسخ های مربوط به هر یک از درخواست ها.

queryCost

number

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

resourceQuotasRemaining

object( ResourceQuotasRemaining )

میزان سهمیه منابع باقی مانده برای ملک.

محدوده مجوز

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

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

گزارش درخواست

کلاس درخواست اصلی که درخواست Reporting API را مشخص می کند.

نمایندگی JSON
{
  "viewId": string,
  "dateRanges": [
    {
      object(DateRange)
    }
  ],
  "samplingLevel": enum(Sampling),
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "metricFilterClauses": [
    {
      object(MetricFilterClause)
    }
  ],
  "filtersExpression": string,
  "orderBys": [
    {
      object(OrderBy)
    }
  ],
  "segments": [
    {
      object(Segment)
    }
  ],
  "pivots": [
    {
      object(Pivot)
    }
  ],
  "cohortGroup": {
    object(CohortGroup)
  },
  "pageToken": string,
  "pageSize": number,
  "includeEmptyRows": boolean,
  "hideTotals": boolean,
  "hideValueRanges": boolean
}
زمینه های
viewId

string

شناسه نمای Analytics که از آن داده ها بازیابی می شود. هر ReportRequest در متد batchGet باید دارای همان viewId باشد.

dateRanges[]

object( DateRange )

محدوده تاریخ در درخواست درخواست می تواند حداکثر 2 محدوده تاریخ داشته باشد. پاسخ شامل مجموعه ای از مقادیر متریک برای هر ترکیبی از ابعاد برای هر محدوده تاریخ در درخواست خواهد بود. بنابراین، اگر دو محدوده تاریخ وجود داشته باشد، دو مجموعه از مقادیر متریک وجود خواهد داشت، یکی برای محدوده تاریخ اصلی و دیگری برای محدوده تاریخ دوم. قسمت reportRequest.dateRanges نباید برای گروه‌ها یا درخواست‌های ارزش طول عمر مشخص شود. اگر محدوده تاریخ ارائه نشده باشد، محدوده تاریخ پیش‌فرض است (تاریخ شروع: تاریخ فعلی - 7 روز، تاریخ پایان: تاریخ فعلی - 1 روز). هر ReportRequest در متد batchGet باید دارای همان تعریف dateRanges باشد.

samplingLevel

enum( Sampling )

حجم نمونه گزارش مورد نظر اگر قسمت samplingLevel نامشخص باشد از سطح نمونه برداری DEFAULT استفاده می شود. هر ReportRequest در متد batchGet باید دارای همان تعریف samplingLevel باشد. برای جزئیات بیشتر به راهنمای توسعه دهنده مراجعه کنید.

dimensions[]

object( Dimension )

ابعاد درخواستی درخواست ها در مجموع می توانند 9 بعد داشته باشند.

dimensionFilterClauses[]

object( DimensionFilterClause )

بندهای فیلتر ابعاد برای فیلتر کردن مقادیر ابعاد. آنها به طور منطقی با عملگر AND ترکیب می شوند. توجه داشته باشید که فیلتر قبل از تجمیع هر یک از ابعاد انجام می شود، به طوری که معیارهای برگشتی کل را فقط برای ابعاد مربوطه نشان می دهد.

metrics[]

object( Metric )

معیارهای درخواستی درخواست ها باید حداقل یک معیار را مشخص کنند. درخواست ها در مجموع می توانند 10 معیار داشته باشند.

metricFilterClauses[]

object( MetricFilterClause )

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

filtersExpression

string

فیلترهای ابعاد یا متریک که داده های بازگردانده شده برای درخواست شما را محدود می کند. برای استفاده از filtersExpression ، یک بعد یا متریک برای فیلتر و به دنبال آن عبارت فیلتر ارائه دهید. به عنوان مثال، عبارت زیر بعد ga:browser را انتخاب می کند که با فایرفاکس شروع می شود. ga:browser=~^Firefox . برای اطلاعات بیشتر در مورد ابعاد و فیلترهای متریک، به مرجع فیلترها مراجعه کنید.

orderBys[]

object( OrderBy )

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

segments[]

object( Segment )

داده های بازگشتی برای درخواست را بخش بندی کنید. تعریف بخش به بررسی زیرمجموعه ای از درخواست بخش کمک می کند. یک درخواست می تواند تا چهار بخش داشته باشد. هر ReportRequest در متد batchGet باید شامل همان تعریف segments باشد. درخواست‌های دارای بخش باید دارای بعد ga:segment باشند.

pivots[]

object( Pivot )

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

cohortGroup

object( CohortGroup )

گروه کوهورت مرتبط با این درخواست. اگر یک گروه کوهورت در درخواست وجود دارد، بعد ga:cohort باید وجود داشته باشد. هر ReportRequest در متد batchGet باید دارای همان تعریف cohortGroup باشد.

pageToken

string

یک نشانه ادامه برای دریافت صفحه بعدی نتایج. با افزودن این مورد به درخواست، ردیف‌های بعد از pageToken برمی‌گردد. pageToken باید مقداری باشد که در پارامتر nextPageToken در پاسخ به درخواست report.batchGet برگردانده شده است.

pageSize

number

اندازه صفحه برای صفحه بندی است و حداکثر تعداد سطرهای برگشتی را مشخص می کند. اندازه صفحه باید >= 0 باشد. یک کوئری پیش فرض 1000 ردیف را برمی گرداند. Analytics Core Reporting API حداکثر 100000 ردیف را در هر درخواست برمی گرداند، مهم نیست که چقدر درخواست کنید. همچنین می‌تواند ردیف‌های کمتری را نسبت به درخواستی بازگرداند، اگر بخش‌های بعدی آن‌قدر که انتظار دارید وجود نداشته باشد. به عنوان مثال، کمتر از 300 مقدار ممکن برای ga:country وجود دارد، بنابراین هنگام تقسیم بندی تنها بر اساس کشور، نمی توانید بیش از 300 ردیف دریافت کنید، حتی اگر pageSize روی یک مقدار بالاتر تنظیم کنید.

includeEmptyRows

boolean

اگر روی نادرست تنظیم شود، اگر همه معیارهای بازیابی شده برابر با صفر باشند، پاسخ شامل ردیف‌ها نمی‌شود. پیش فرض false است که این ردیف ها را حذف می کند.

hideTotals

boolean

اگر روی درست تنظیم شود، مجموع تمام معیارها برای همه ردیف‌های منطبق، برای هر محدوده تاریخ پنهان می‌شود. پیش فرض نادرست است و مجموع را برمی گرداند.

hideValueRanges

boolean

اگر روی درست تنظیم شود، حداقل و حداکثر را در تمام ردیف‌های منطبق پنهان می‌کند. پیش فرض نادرست است و محدوده های مقدار برگردانده می شوند.

نمونه برداری

مقادیر برای سطح نمونه گیری

Enums
SAMPLING_UNSPECIFIED اگر فیلد samplingLevel نامشخص باشد، از سطح نمونه‌گیری DEFAULT استفاده می‌شود.
DEFAULT پاسخ را با اندازه نمونه برمی‌گرداند که سرعت و دقت را متعادل می‌کند.
SMALL پاسخ سریع با حجم نمونه کوچکتر را برمی گرداند.
LARGE با استفاده از اندازه نمونه بزرگ، پاسخ دقیق تری را برمی گرداند. اما این ممکن است منجر به کندتر شدن پاسخ شود.

بعد، ابعاد، اندازه

ابعاد ویژگی های داده های شما هستند. به عنوان مثال، بعد ga:city شهر را نشان می دهد، به عنوان مثال، "پاریس" یا "نیویورک"، که یک جلسه از آن شروع می شود.

نمایندگی JSON
{
  "name": string,
  "histogramBuckets": [
    string
  ]
}
زمینه های
name

string

نام بعد برای واکشی، به عنوان مثال ga:browser .

histogramBuckets[]

string ( int64 format)

اگر خالی نباشد، مقادیر ابعاد را بعد از رشته تا int64 در سطل ها قرار می دهیم. مقادیر ابعادی که نمایش رشته ای از یک مقدار انتگرال نیستند به صفر تبدیل می شوند. مقادیر سطل باید به ترتیب افزایشی باشند. هر سطل در انتهای پایین بسته و در انتهای بالایی باز است. سطل "اولین" شامل تمام مقادیر کمتر از مرز اول است، سطل "آخرین" شامل تمام مقادیر تا بی نهایت است. مقادیر ابعادی که در یک سطل قرار می گیرند به یک مقدار ابعاد جدید تبدیل می شوند. به عنوان مثال، اگر کسی لیستی از "0، 1، 3، 4، 7" ارائه دهد، سطل های زیر را برمی گردانیم:

  • سطل شماره 1: مقادیر < 0، مقدار ابعاد "<0"
  • سطل شماره 2: مقادیر در [0،1)، مقدار ابعاد "0"
  • سطل شماره 3: مقادیر در [1،3)، مقدار ابعاد "1-2"
  • سطل شماره 4: مقادیر در [3،4)، مقدار ابعاد "3"
  • سطل شماره 5: مقادیر در [4،7)، مقدار ابعاد "4-6"
  • سطل شماره 6: مقادیر >= 7، مقدار ابعاد "7+"

توجه: اگر جهش هیستوگرام را روی هر بعد اعمال می‌کنید و از آن بعد به صورت مرتب استفاده می‌کنید، می‌خواهید از نوع مرتب‌سازی HISTOGRAM_BUCKET برای این منظور استفاده کنید. بدون آن، مقادیر ابعاد بر اساس ترتیب فرهنگ لغت (لغت‌شناسی) مرتب می‌شوند. به عنوان مثال ترتیب صعودی فرهنگ لغت به این صورت است:

"<50"، "1001+"، "121-1000"، "50-120"

و ترتیب صعودی HISTOGRAM_BUCKET این است:

"<50"، "50-120"، "121-1000"، "1001+"

مشتری باید صریحاً "orderType": "HISTOGRAM_BUCKET" برای بعد هیستوگرام جهش یافته.

DimensionFilterClause

گروهی از فیلترهای ابعادی مقدار عملگر را برای تعیین نحوه ترکیب منطقی فیلترها تنظیم کنید.

نمایندگی JSON
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(DimensionFilter)
    }
  ]
}
زمینه های
operator

enum( FilterLogicalOperator )

عملگر برای ترکیب فیلترهای چند بعدی. اگر مشخص نباشد، به عنوان یک OR در نظر گرفته می شود.

filters[]

object( DimensionFilter )

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

FilterLogicalOperator

نحوه ترکیب منطقی فیلترها

Enums
OPERATOR_UNSPECIFIED اپراتور نامشخص به عنوان یک OR در نظر گرفته می شود.
OR عملگر منطقی OR .
AND عملگر AND منطقی.

DimensionFilter

Dimension filter گزینه های فیلتر را روی یک بعد مشخص می کند.

نمایندگی JSON
{
  "dimensionName": string,
  "not": boolean,
  "operator": enum(Operator),
  "expressions": [
    string
  ],
  "caseSensitive": boolean
}
زمینه های
dimensionName

string

بعد برای فیلتر کردن DimensionFilter باید دارای یک بعد باشد.

not

boolean

عملگر منطقی NOT . اگر این بولی روی true تنظیم شود، مقادیر ابعاد منطبق در گزارش حذف خواهند شد. حالت پیش فرض غلط است.

operator

enum( Operator )

نحوه تطبیق بعد با عبارت پیش فرض REGEXP است.

expressions[]

string

رشته ها یا عبارت منظم برای مطابقت با. فقط اولین مقدار لیست برای مقایسه استفاده می شود مگر اینکه عملگر IN_LIST باشد. اگر عملگر IN_LIST باشد، از کل لیست برای فیلتر کردن ابعاد استفاده می‌شود که در توضیح عملگر IN_LIST توضیح داده شده است.

caseSensitive

boolean

آیا مسابقه باید به حروف کوچک و بزرگ حساس باشد؟ پیش فرض نادرست است.

اپراتور

انواع بازی های مختلف پشتیبانی می شود.

Enums
OPERATOR_UNSPECIFIED اگر نوع مطابقت مشخص نشده باشد، به عنوان یک REGEXP در نظر گرفته می شود.
REGEXP عبارت مطابقت به عنوان یک عبارت منظم در نظر گرفته می شود. همه انواع تطابق به عنوان عبارات منظم در نظر گرفته نمی شوند.
BEGINS_WITH با مقداری مطابقت دارد که با عبارت مطابقت ارائه شده شروع می شود.
ENDS_WITH مقادیری را که با عبارت تطبیق ارائه شده به پایان می رسد مطابقت می دهد.
PARTIAL مطابقت رشته فرعی
EXACT مقدار باید کاملاً با عبارت مطابقت مطابقت داشته باشد.
NUMERIC_EQUAL

فیلترهای مقایسه اعداد صحیح حساسیت حروف کوچک برای این موارد نادیده گرفته می شود و عبارت به عنوان رشته ای است که یک عدد صحیح را نشان می دهد. شرایط شکست:

  • اگر عبارت int64 معتبر نباشد، کلاینت باید منتظر خطا باشد.
  • ابعاد ورودی که مقادیر int64 معتبر نیستند هرگز با فیلتر مطابقت ندارند.
NUMERIC_GREATER_THAN بررسی می کند که آیا بعد از نظر عددی بزرگتر از عبارت مطابقت است یا خیر. توضیحات NUMERIC_EQUALS را برای محدودیت بخوانید.
NUMERIC_LESS_THAN بررسی می کند که آیا بعد از نظر عددی کمتر از عبارت مطابقت است یا خیر. توضیحات NUMERIC_EQUALS را برای محدودیت بخوانید.
IN_LIST

این گزینه برای تعیین فیلتر ابعادی استفاده می شود که عبارت آن می تواند هر مقداری را از لیست انتخاب شده از مقادیر بگیرد. این کمک می کند تا از ارزیابی چندین فیلتر ابعاد تطابق دقیق که برای هر سطر پاسخ OR'd شده اند جلوگیری شود. مثلا:

expressions: ["A", "B", "C"]

هر ردیف پاسخی که بعد آن دارای مقدار A، B یا C باشد، با این DimensionFilter مطابقت دارد.

متریک

متریک ها اندازه گیری های کمی هستند. به عنوان مثال، متریک ga:users تعداد کل کاربران را برای دوره زمانی درخواستی نشان می دهد.

نمایندگی JSON
{
  "expression": string,
  "alias": string,
  "formattingType": enum(MetricType)
}
زمینه های
expression

string

یک عبارت متریک در درخواست. یک عبارت از یک یا چند متریک و اعداد ساخته می شود. عملگرهای پذیرفته شده عبارتند از: به علاوه (+)، منهای (-)، نفی (یکی -)، تقسیم بر (/)، ضرب در (*)، پرانتز، اعداد اصلی مثبت (0-9)، می تواند شامل اعشار باشد و محدود به 1024 کاراکتر. مثال ga:totalRefunds/ga:users ، در بیشتر موارد عبارت متریک فقط یک نام متریک واحد مانند ga:users است. افزودن معیارهای ترکیبی MetricType (به عنوان مثال، CURRENCY + PERCENTAGE ) به نتایج غیرمنتظره ای منجر می شود.

alias

string

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

formattingType

enum( MetricType )

نحوه قالب بندی عبارت متریک را مشخص می کند، برای مثال INTEGER .

نوع متریک

انواع معیارها

Enums
METRIC_TYPE_UNSPECIFIED نوع متریک مشخص نشده است.
INTEGER متریک عدد صحیح
FLOAT متریک شناور.
CURRENCY متریک ارز.
PERCENT متریک درصد
TIME متریک زمان در قالب HH:MM:SS .

MetricFilterClause

نشان دهنده گروهی از فیلترهای متریک است. مقدار عملگر را برای تعیین نحوه ترکیب منطقی فیلترها تنظیم کنید.

نمایندگی JSON
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(MetricFilter)
    }
  ]
}
زمینه های
operator

enum( FilterLogicalOperator )

عملگر برای ترکیب چند فیلتر متریک. اگر مشخص نباشد، به عنوان یک OR در نظر گرفته می شود.

filters[]

object( MetricFilter )

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

فیلتر متریک

MetricFilter فیلتر را روی یک متریک مشخص می کند.

نمایندگی JSON
{
  "metricName": string,
  "not": boolean,
  "operator": enum(Operator),
  "comparisonValue": string
}
زمینه های
metricName

string

معیاری که روی آن فیلتر خواهد شد. MetricFilter باید دارای یک نام متریک باشد. نام متریک می تواند نام مستعاری باشد که قبلاً به عنوان متریک تعریف شده بود یا همچنین می تواند یک عبارت متریک باشد.

not

boolean

عملگر منطقی NOT . اگر این بولی روی true تنظیم شود، مقادیر متریک منطبق در گزارش حذف خواهند شد. حالت پیش فرض غلط است.

operator

enum( Operator )

آیا متریک EQUAL ، LESS_THAN یا GREATER_THAN مقایسه ارزش است، پیش فرض EQUAL است. اگر اپراتور IS_MISSING باشد، بررسی می‌کند که آیا متریک وجود ندارد و مقدار مقایسه را نادیده می‌گیرد.

comparisonValue

string

ارزشی که باید با آن مقایسه کرد.

اپراتور

گزینه های مختلف نوع مقایسه

Enums
OPERATOR_UNSPECIFIED اگر اپراتور مشخص نشده باشد، به عنوان EQUAL تلقی می شود.
EQUAL آیا مقدار متریک باید دقیقاً برابر با مقدار مقایسه باشد.
LESS_THAN آیا مقدار متریک باید کمتر از مقدار مقایسه باشد.
GREATER_THAN آیا مقدار متریک باید بیشتر از مقدار مقایسه باشد.
IS_MISSING در صورت عدم وجود معیار، اعتبارسنجی می‌شود. ارزش مقایسه را در نظر نمی گیرد.

سفارش توسط

گزینه های مرتب سازی را مشخص می کند.

نمایندگی JSON
{
  "fieldName": string,
  "orderType": enum(OrderType),
  "sortOrder": enum(SortOrder)
}
زمینه های
fieldName

string

فیلدی که بر اساس آن مرتب می شود. ترتیب مرتب سازی پیش فرض صعودی است. مثال: ga:browser . توجه داشته باشید که در اینجا فقط می توانید یک فیلد را برای مرتب سازی مشخص کنید. به عنوان مثال، ga:browser, ga:city معتبر نیست.

orderType

enum( OrderType )

نوع سفارش orderType پیش‌فرض VALUE است.

sortOrder

enum( SortOrder )

ترتیب مرتب سازی برای فیلد.

نوع سفارش

OrderType نحوه تعیین ترتیب مرتب سازی را کنترل می کند.

Enums
ORDER_TYPE_UNSPECIFIED نوع سفارش نامشخص به عنوان مرتب سازی بر اساس مقدار تلقی می شود.
VALUE ترتیب مرتب سازی بر اساس مقدار ستون انتخاب شده است. فقط به اولین محدوده تاریخ نگاه می کند.
DELTA ترتیب مرتب سازی بر اساس تفاوت مقادیر ستون انتخابی بین دو محدوده تاریخ اول است. فقط در صورتی قابل استفاده است که دقیقاً دو محدوده تاریخ وجود داشته باشد.
SMART ترتیب مرتب سازی بر اساس مقدار وزنی ستون انتخابی است. اگر ستون دارای قالب n/d باشد، مقدار وزنی این نسبت (n + totals.n)/(d + totals.d) خواهد بود. فقط برای معیارهایی که نشان دهنده نسبت هستند قابل استفاده است.
HISTOGRAM_BUCKET نوع ترتیب هیستوگرام فقط برای ستون های ابعادی با سطل های هیستوگرام خالی قابل استفاده است.
DIMENSION_AS_INTEGER اگر ابعاد اعداد طول ثابت باشند، مرتب سازی معمولی به خوبی کار می کند. DIMENSION_AS_INTEGER می تواند استفاده شود اگر ابعاد اعداد طول متغیر باشند.

مرتب سازی

ترتیب مرتب سازی مرتب سازی.

Enums
SORT_ORDER_UNSPECIFIED اگر ترتیب مرتب سازی مشخص نشده باشد، پیش فرض صعودی است.
ASCENDING مرتب سازی صعودی فیلد به صورت صعودی مرتب می شود.
DESCENDING مرتب سازی نزولی فیلد به صورت نزولی مرتب خواهد شد.

بخش

تعریف بخش، اگر گزارش نیاز به تقسیم بندی داشته باشد. Segment زیرمجموعه ای از داده های Analytics است. برای مثال، از کل مجموعه کاربران، یک بخش ممکن است کاربران یک کشور یا شهر خاص باشد.

نمایندگی JSON
{

  // Union field dynamicOrById can be only one of the following:
  "dynamicSegment": {
    object(DynamicSegment)
  },
  "segmentId": string
  // End of list of possible types for union field dynamicOrById.
}
زمینه های
فیلد اتحادیه dynamicOrById . بخش را می توان به صورت پویا با استفاده از DynamicSegment یا با استفاده از شناسه یک بخش داخلی یا سفارشی تعریف کرد. dynamicOrById می تواند تنها یکی از موارد زیر باشد:
dynamicSegment

object( DynamicSegment )

تعریف بخش پویا در درخواست.

segmentId

string

شناسه بخش یک بخش داخلی یا سفارشی، به عنوان مثال gaid::-3 .

DynamicSegment

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

نمایندگی JSON
{
  "name": string,
  "userSegment": {
    object(SegmentDefinition)
  },
  "sessionSegment": {
    object(SegmentDefinition)
  }
}
زمینه های
name

string

نام بخش پویا.

userSegment

object( SegmentDefinition )

بخش کاربر برای انتخاب کاربران برای درج در بخش.

sessionSegment

object( SegmentDefinition )

Session Segment برای انتخاب جلسات برای درج در بخش.

تعریف بخش

SegmentDefinition بخش را به عنوان مجموعه ای از SegmentFilters تعریف می کند که با یک عملیات AND منطقی ترکیب می شوند.

نمایندگی JSON
{
  "segmentFilters": [
    {
      object(SegmentFilter)
    }
  ]
}
زمینه های
segmentFilters[]

object( SegmentFilter )

یک بخش با مجموعه ای از فیلترهای قطعه تعریف می شود که با یک عملیات AND منطقی ترکیب می شوند.

بخش فیلتر

SegmentFilter بخش را به صورت ساده یا یک قطعه دنباله ای تعریف می کند. یک شرط بخش ساده شامل شرایط ابعاد و متریک برای انتخاب جلسات یا کاربران است. یک شرط قطعه توالی می تواند برای انتخاب کاربران یا جلسات بر اساس شرایط متوالی استفاده شود.

نمایندگی JSON
{
  "not": boolean,

  // Union field simpleOrSequence can be only one of the following:
  "simpleSegment": {
    object(SimpleSegment)
  },
  "sequenceSegment": {
    object(SequenceSegment)
  }
  // End of list of possible types for union field simpleOrSequence.
}
زمینه های
not

boolean

اگر درست است، مکمل بخش ساده یا دنباله را مطابقت دهید. به عنوان مثال، برای مطابقت با تمام بازدیدهایی که از "نیویورک" نیستند، می توانیم بخش را به صورت زیر تعریف کنیم:

  "sessionSegment": {
    "segmentFilters": [{
      "simpleSegment" :{
        "orFiltersForSegment": [{
          "segmentFilterClauses":[{
            "dimensionFilter": {
              "dimensionName": "ga:city",
              "expressions": ["New York"]
            }
          }]
        }]
      },
      "not": "True"
    }]
  },

فیلد اتحادیه simpleOrSequence . آیا این یک قطعه ساده است یا یک تعریف قطعه دنباله ای. simpleOrSequence تنها می تواند یکی از موارد زیر باشد:
simpleSegment

object( SimpleSegment )

شرایط بخش ساده شامل یک یا چند شرط بعد/متریک است که می‌توانند با هم ترکیب شوند

sequenceSegment

object( SequenceSegment )

شرایط توالی شامل یک یا چند مرحله است که هر مرحله با یک یا چند بعد/شرایط متریک تعریف می شود. چند مرحله را می توان با عملگرهای توالی خاص ترکیب کرد.

SimpleSegment

شرایط بخش ساده شامل یک یا چند شرط بعد/متریک است که می‌توانند با هم ترکیب شوند.

نمایندگی JSON
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ]
}
زمینه های
orFiltersForSegment[]

object( OrFiltersForSegment )

لیستی از گروه های فیلتر بخش که با عملگر AND منطقی ترکیب شده اند.

OrFiltersForSegment

لیستی از فیلترهای بخش در گروه OR با عملگر منطقی OR ترکیب می شوند.

نمایندگی JSON
{
  "segmentFilterClauses": [
    {
      object(SegmentFilterClause)
    }
  ]
}
زمینه های
segmentFilterClauses[]

object( SegmentFilterClause )

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

SegmentFilterClause

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

نمایندگی JSON
{
  "not": boolean,

  // Union field dimensionOrMetricFilter can be only one of the following:
  "dimensionFilter": {
    object(SegmentDimensionFilter)
  },
  "metricFilter": {
    object(SegmentMetricFilter)
  }
  // End of list of possible types for union field dimensionOrMetricFilter.
}
زمینه های
not

boolean

با مکمل ( ! ) فیلتر مطابقت دارد.

dimensionOrMetricFilter فیلد اتحادیهOrMetricFilter. ابعاد یا فیلتر متریک. dimensionOrMetricFilter تنها می تواند یکی از موارد زیر باشد:
dimensionFilter

object( SegmentDimensionFilter )

فیلتر ابعاد برای تعریف بخش.

metricFilter

object( SegmentMetricFilter )

فیلتر متریک برای تعریف بخش.

SegmentDimensionFilter

Dimension filter گزینه های فیلتر را روی یک بعد مشخص می کند.

نمایندگی JSON
{
  "dimensionName": string,
  "operator": enum(Operator),
  "caseSensitive": boolean,
  "expressions": [
    string
  ],
  "minComparisonValue": string,
  "maxComparisonValue": string
}
زمینه های
dimensionName

string

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

operator

enum( Operator )

عملگر مورد استفاده برای تطبیق بعد با عبارات.

caseSensitive

boolean

اگر مطابقت به حروف کوچک و بزرگ حساس باشد، برای اپراتور IN_LIST نادیده گرفته شود.

expressions[]

string

لیست عبارات، تنها عنصر اول برای همه عملگرها استفاده می شود

minComparisonValue

string

حداقل مقادیر مقایسه برای نوع مطابقت BETWEEN .

maxComparisonValue

string

حداکثر مقادیر مقایسه برای نوع مطابقت BETWEEN .

اپراتور

انواع بازی های مختلف پشتیبانی می شود.

Enums
OPERATOR_UNSPECIFIED اگر نوع مطابقت نامشخص باشد، به عنوان یک REGEXP در نظر گرفته می شود.
REGEXP عبارت مطابقت به عنوان یک عبارت منظم در نظر گرفته می شود. همه انواع تطابق دیگر به عنوان عبارات منظم تلقی نمی شوند.
BEGINS_WITH مقادیری را که با عبارت تطبیق ارائه شده شروع می شوند مطابقت می دهد.
ENDS_WITH مقادیری را که با عبارت تطبیق ارائه شده به پایان می رسد مطابقت می دهد.
PARTIAL مطابقت رشته فرعی
EXACT مقدار باید کاملاً با عبارت مطابقت مطابقت داشته باشد.
IN_LIST

این گزینه برای تعیین فیلتر ابعادی استفاده می شود که عبارت آن می تواند هر مقداری را از لیست انتخاب شده از مقادیر بگیرد. این کمک می کند تا از ارزیابی چندین فیلتر ابعاد تطابق دقیق که برای هر سطر پاسخ OR'd شده اند جلوگیری شود. مثلا:

expressions: ["A", "B", "C"]

هر ردیف پاسخی که بعد آن دارای مقدار A، B یا C باشد، با این DimensionFilter مطابقت دارد.

NUMERIC_LESS_THAN

فیلترهای مقایسه اعداد صحیح حساسیت حروف کوچک برای این موارد نادیده گرفته می شود و عبارت به عنوان رشته ای است که یک عدد صحیح را نشان می دهد. شرایط شکست:

  • اگر عبارت int64 معتبر نباشد، مشتری باید منتظر خطا باشد.
  • ابعاد ورودی که مقادیر int64 معتبر نیستند هرگز با فیلتر مطابقت ندارند.

بررسی می کند که آیا بعد از نظر عددی کمتر از عبارت مطابقت است یا خیر.

NUMERIC_GREATER_THAN بررسی می کند که آیا بعد از نظر عددی بزرگتر از عبارت مطابقت است یا خیر.
NUMERIC_BETWEEN بررسی می‌کند که آیا بعد از نظر عددی بین حداقل و حداکثر عبارت تطبیق است، مرزها حذف می‌شوند.

SegmentMetricFilter

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

نمایندگی JSON
{
  "scope": enum(Scope),
  "metricName": string,
  "operator": enum(Operator),
  "comparisonValue": string,
  "maxComparisonValue": string
}
زمینه های
scope

enum( Scope )

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

metricName

string

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

operator

enum( Operator )

Specifyes عملیاتی است که برای مقایسه متریک باید انجام شود. پیش فرض EQUAL است.

comparisonValue

string

ارزشی که باید با آن مقایسه کرد. اگر عملگر BETWEEN باشد، این مقدار به عنوان حداقل مقدار مقایسه در نظر گرفته می شود.

maxComparisonValue

string

حداکثر مقدار مقایسه فقط برای عملگر BETWEEN استفاده می شود.

محدوده

یک محدوده برای یک متریک سطحی را که آن معیار در آن تعریف شده است - PRODUCT ، HIT ، SESSION ، یا USER را مشخص می کند. مقادیر متریک را می‌توان در محدوده‌های بزرگ‌تر از محدوده اصلی آن نیز گزارش کرد. به عنوان مثال، ga:pageviews و ga:transactions می توان در سطح SESSION و USER فقط با جمع کردن آنها برای هر بازدیدی که در آن جلسات یا برای آن کاربران رخ می دهد، گزارش کرد.

Enums
UNSPECIFIED_SCOPE اگر scope مشخص نشده باشد، بسته به اینکه آیا بخش سعی می‌کند کاربران یا جلسات را انتخاب کند، به‌طور پیش‌فرض روی محدوده شرط، USER یا SESSION تنظیم می‌شود.
PRODUCT محدوده محصول.
HIT دامنه ضربه.
SESSION محدوده جلسه
USER محدوده کاربری

اپراتور

گزینه های مختلف نوع مقایسه

Enums
UNSPECIFIED_OPERATOR عملگر نامشخص به عنوان عملگر LESS_THAN در نظر گرفته می شود.
LESS_THAN بررسی می کند که آیا مقدار متریک کمتر از مقدار مقایسه است.
GREATER_THAN بررسی می کند که آیا مقدار متریک بیشتر از مقدار مقایسه است.
EQUAL برابر با اپراتور
BETWEEN برای بین اپراتور، هر دو حداقل و حداکثر منحصر به فرد هستند. برای مقایسه LT و GT استفاده خواهیم کرد.

SequenceSegment

شرایط توالی شامل یک یا چند مرحله است که هر مرحله با یک یا چند بعد/شرایط متریک تعریف می شود. چند مرحله را می توان با عملگرهای توالی خاص ترکیب کرد.

نمایندگی JSON
{
  "segmentSequenceSteps": [
    {
      object(SegmentSequenceStep)
    }
  ],
  "firstStepShouldMatchFirstHit": boolean
}
زمینه های
segmentSequenceSteps[]

object( SegmentSequenceStep )

لیست مراحل در دنباله.

firstStepShouldMatchFirstHit

boolean

در صورت تنظیم، شرط مرحله اول باید با اولین ضربه بازدیدکننده (در محدوده تاریخ) مطابقت داشته باشد.

SegmentSequenceStep

تعریف دنباله قطعه

نمایندگی JSON
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ],
  "matchType": enum(MatchType)
}
زمینه های
orFiltersForSegment[]

object( OrFiltersForSegment )

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

matchType

enum( MatchType )

مشخص می کند که آیا مرحله بلافاصله قبل از مرحله بعدی است یا می تواند هر زمانی قبل از مرحله بعدی باشد.

MatchType

نوع تطبیق برای دنباله.

Enums
UNSPECIFIED_MATCH_TYPE نوع تطابق نامشخص به عنوان موارد قبلی در نظر گرفته می شود.
PRECEDES عملگر نشان می دهد که مرحله قبل قبل از مرحله بعدی است.
IMMEDIATELY_PRECEDES اپراتور نشان می دهد که مرحله قبل بلافاصله قبل از مرحله بعدی است.

محوری

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

نمایندگی JSON
{
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "startGroup": number,
  "maxGroupCount": number
}
زمینه های
dimensions[]

object( Dimension )

فهرستی از ابعاد برای نمایش به عنوان ستون محوری. یک Pivot می تواند حداکثر 4 بعد داشته باشد. ابعاد محوری بخشی از محدودیت در تعداد کل ابعاد مجاز در درخواست است.

dimensionFilterClauses[]

object( DimensionFilterClause )

DimensionFilterClauses به طور منطقی با یک عملگر AND ترکیب می‌شوند: فقط داده‌هایی که توسط همه این DimensionFilterClauses گنجانده شده‌اند به مقادیر در این ناحیه محوری کمک می‌کنند. از فیلترهای ابعاد می توان برای محدود کردن ستون های نشان داده شده در ناحیه محوری استفاده کرد. به عنوان مثال، اگر ga:browser به عنوان بعد درخواستی در ناحیه محوری داشته باشید، و فیلترهای کلیدی را برای محدود کردن ga:browser به "IE" یا "Firefox" مشخص کنید، آنگاه فقط آن دو مرورگر به عنوان ستون نشان داده می شوند.

metrics[]

object( Metric )

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

startGroup

number

اگر k معیار درخواست شده باشد، آنگاه پاسخ حاوی چند ضرب وابسته به داده از k ستون در گزارش خواهد بود. به عنوان مثال، اگر شما بر روی بعد ga:browser قرار دهید، k ستون برای "Firefox"، k ستون برای "IE"، k ستون برای "Chrome" و غیره دریافت خواهید کرد. ترتیب گروه‌های ستون‌ها با نزول تعیین می‌شود. ترتیب "کل" برای اولین مقدار k. پیوندها با ترتیب واژگانی بعد محوری اول، سپس ترتیب واژگانی بعد محوری دوم و غیره شکسته می شوند. به عنوان مثال، اگر مجموع مقدار اول برای فایرفاکس، IE، و کروم به ترتیب 8، 2، 8 باشد، ترتیب ستون ها کروم، فایرفاکس، IE خواهد بود.

موارد زیر به شما امکان می دهد انتخاب کنید کدام یک از گروه های k ستون در پاسخ گنجانده شود.

maxGroupCount

number

حداکثر تعداد گروه ها را برای بازگشت مشخص می کند. مقدار پیش فرض 10 است، همچنین مقدار حداکثر 1000 است.

گروه کوهورت

یک گروه کوهورت را تعریف می کند. مثلا:

"cohortGroup": {
  "cohorts": [{
    "name": "cohort 1",
    "type": "FIRST_VISIT_DATE",
    "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
  },{
    "name": "cohort 2"
     "type": "FIRST_VISIT_DATE"
     "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
  }]
}
نمایندگی JSON
{
  "cohorts": [
    {
      object(Cohort)
    }
  ],
  "lifetimeValue": boolean
}
زمینه های
cohorts[]

object( Cohort )

تعریف برای گروه

lifetimeValue

boolean

مقدار عمر زمان (LTV) را فعال کنید. LTV ارزش طول عمر کاربرانی را که از طریق کانال های مختلف به دست می آورند اندازه گیری می کند. لطفاً نگاه کنید به: تجزیه و تحلیل کوهورت و ارزش طول عمر اگر مقدار lifetimeValue نادرست است:

  • مقادیر متریک مشابه مقادیر موجود در گزارش همگروهی رابط وب است.
  • محدوده تاریخ تعریف همگروهی باید با هفته و ماه تقویم تراز شود. به عنوان مثال، هنگام درخواست ga:cohortNthWeek startDate در تعریف گروه باید یکشنبه و endDate باید شنبه بعد باشد، و برای ga:cohortNthMonth ، startDate باید اول ماه و endDate باید آخرین روز ماه باشد. .

وقتی lifetimeValue درست است:

  • مقادیر متریک با مقادیر موجود در گزارش ارزش LifeTime رابط وب مطابقت دارد.
  • گزارش ارزش مادام‌العمر به شما نشان می‌دهد که ارزش کاربر (درآمد) و تعامل (نمایش‌ها، تکمیل‌های هدف، جلسات و مدت جلسه) در طول ۹۰ روز پس از جذب کاربر چگونه رشد می‌کنند.
  • معیارها به عنوان میانگین تجمعی برای هر کاربر در هر افزایش زمان محاسبه می شود.
  • لازم نیست محدوده تاریخ تعریف همگروهی با مرزهای هفته و ماه تقویم تراز شود.
  • viewId باید شناسه نمای برنامه باشد

گروه

یک گروه را تعریف می کند. همگروهی گروهی از کاربران است که یک ویژگی مشترک دارند. به عنوان مثال، همه کاربران با تاریخ جذب یکسان به یک گروه تعلق دارند.

نمایندگی JSON
{
  "name": string,
  "type": enum(Type),
  "dateRange": {
    object(DateRange)
  }
}
زمینه های
name

string

یک نام منحصر به فرد برای گروه اگر نام تعریف نشده باشد به صورت خودکار با مقادیر cohort_[1234...] تولید می شود.

type

enum( Type )

نوع گروه تنها نوع پشتیبانی شده در حال حاضر FIRST_VISIT_DATE است. اگر این فیلد نامشخص باشد، گروه به عنوان گروه از نوع FIRST_VISIT_DATE در نظر گرفته می شود.

dateRange

object( DateRange )

این برای گروه FIRST_VISIT_DATE استفاده می شود، گروه کاربرانی را انتخاب می کند که اولین تاریخ بازدید آنها بین تاریخ شروع و تاریخ پایان تعریف شده در محدوده تاریخ باشد. محدوده تاریخ باید برای درخواست‌های همگروهی تراز باشد. اگر درخواست حاوی ga:cohortNthDay باشد، باید دقیقاً یک روز باشد، اگر ga:cohortNthWeek باید با مرز هفته (از یکشنبه شروع می‌شود و شنبه پایان می‌یابد) و برای ga:cohortNthMonth محدوده تاریخ باید با ماه تراز شود. (از اول ماه شروع می شود و در آخرین روز ماه به پایان می رسد). برای درخواست های LTV چنین محدودیتی وجود ندارد. شما نیازی به ارائه محدوده تاریخ برای قسمت reportsRequest.dateRanges ندارید.

تایپ کنید

نوع کوهورت.

Enums
UNSPECIFIED_COHORT_TYPE اگر مشخص نشده باشد به عنوان FIRST_VISIT_DATE در نظر گرفته می شود.
FIRST_VISIT_DATE گروه هایی که بر اساس تاریخ اولین بازدید انتخاب می شوند.

گزارش

پاسخ داده مربوط به درخواست.

نمایندگی JSON
{
  "columnHeader": {
    object(ColumnHeader)
  },
  "data": {
    object(ReportData)
  },
  "nextPageToken": string
}
زمینه های
columnHeader

object( ColumnHeader )

سرصفحه های ستون.

data

object( ReportData )

داده های پاسخ

nextPageToken

string

نشانه صفحه برای بازیابی صفحه بعدی نتایج در لیست.

ColumnHeader

سرصفحه های ستون.

نمایندگی JSON
{
  "dimensions": [
    string
  ],
  "metricHeader": {
    object(MetricHeader)
  }
}
زمینه های
dimensions[]

string

نام ابعاد در پاسخ.

metricHeader

object( MetricHeader )

سرصفحه های متریک برای معیارهای موجود در پاسخ.

MetricHeader

سرصفحه های معیارها.

نمایندگی JSON
{
  "metricHeaderEntries": [
    {
      object(MetricHeaderEntry)
    }
  ],
  "pivotHeaders": [
    {
      object(PivotHeader)
    }
  ]
}
زمینه های
metricHeaderEntries[]

object( MetricHeaderEntry )

سرصفحه های معیارهای موجود در پاسخ.

pivotHeaders[]

object( PivotHeader )

سرصفحه های محوری در پاسخ.

MetricHeaderEntry

سربرگ برای معیارها.

نمایندگی JSON
{
  "name": string,
  "type": enum(MetricType)
}
زمینه های
name

string

نام سربرگ.

type

enum( MetricType )

نوع متریک، برای مثال INTEGER .

PivotHeader

سرصفحه های هر یک از بخش های محوری تعریف شده در درخواست.

نمایندگی JSON
{
  "pivotHeaderEntries": [
    {
      object(PivotHeaderEntry)
    }
  ],
  "totalPivotGroupsCount": number
}
زمینه های
pivotHeaderEntries[]

object( PivotHeaderEntry )

سرصفحه بخش محوری واحد.

totalPivotGroupsCount

number

تعداد کل گروه‌ها برای این محور.

PivotHeaderEntry

سرصفحه های هر یک از ستون های متریک مربوط به معیارهای درخواست شده در بخش محوری پاسخ.

نمایندگی JSON
{
  "dimensionNames": [
    string
  ],
  "dimensionValues": [
    string
  ],
  "metric": {
    object(MetricHeaderEntry)
  }
}
زمینه های
dimensionNames[]

string

نام ابعاد در پاسخ محوری.

dimensionValues[]

string

مقادیر برای ابعاد در محور.

metric

object( MetricHeaderEntry )

هدر متریک برای متریک در محور.

گزارش داده

بخش داده گزارش

نمایندگی JSON
{
  "rows": [
    {
      object(ReportRow)
    }
  ],
  "totals": [
    {
      object(DateRangeValues)
    }
  ],
  "rowCount": number,
  "minimums": [
    {
      object(DateRangeValues)
    }
  ],
  "maximums": [
    {
      object(DateRangeValues)
    }
  ],
  "samplesReadCounts": [
    string
  ],
  "samplingSpaceSizes": [
    string
  ],
  "isDataGolden": boolean,
  "dataLastRefreshed": string
}
زمینه های
rows[]

object( ReportRow )

برای هر ترکیب منحصر به فرد ابعاد، یک ReportRow وجود دارد.

totals[]

object( DateRangeValues )

برای هر محدوده تاریخ درخواستی، برای مجموعه تمام ردیف هایی که با پرس و جو مطابقت دارند، هر قالب مقدار درخواستی یک مجموع دریافت می کند. مجموع برای یک قالب ارزش ابتدا با مجموع معیارهای ذکر شده در قالب ارزش و سپس ارزیابی قالب ارزش به عنوان یک عبارت اسکالر محاسبه می شود. به عنوان مثال، "مجموع" برای 3 / (ga:sessions + 2) ما 3 / ((sum of all relevant ga:sessions) + 2) را محاسبه می کنیم. مجموع ها قبل از صفحه بندی محاسبه می شوند.

rowCount

number

تعداد کل ردیف های منطبق برای این پرس و جو.

minimums[]

object( DateRangeValues )

حداقل و حداکثر مقادیر در تمام ردیف‌های منطبق مشاهده می‌شود. وقتی hideValueRanges در درخواست نادرست است، یا زمانی که rowCount صفر است، هر دو خالی هستند.

maximums[]

object( DateRangeValues )

حداقل و حداکثر مقادیر در تمام ردیف‌های منطبق مشاهده می‌شود. وقتی hideValueRanges در درخواست نادرست است، یا زمانی که rowCount صفر است، هر دو خالی هستند.

samplesReadCounts[]

string ( int64 format)

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

samplingSpaceSizes[]

string ( int64 format)

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

isDataGolden

boolean

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

dataLastRefreshed

string ( Timestamp format)

آخرین باری که داده های گزارش به روز شد. تمام بازدیدهای دریافت شده قبل از این مهر زمانی در محاسبه گزارش لحاظ می شود.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با دقت نانوثانیه. مثال: "2014-10-02T15:01:23.045123456Z" .

ReportRow

یک ردیف در گزارش

نمایندگی JSON
{
  "dimensions": [
    string
  ],
  "metrics": [
    {
      object(DateRangeValues)
    }
  ]
}
زمینه های
dimensions[]

string

لیست ابعاد درخواستی

metrics[]

object( DateRangeValues )

فهرست سنجه‌ها برای هر محدوده تاریخ درخواستی.

DateRangeValues

برای برگرداندن فهرستی از معیارها برای یک ترکیب DateRange / بعد استفاده می شود

نمایندگی JSON
{
  "values": [
    string
  ],
  "pivotValueRegions": [
    {
      object(PivotValueRegion)
    }
  ]
}
زمینه های
values[]

string

هر مقدار مربوط به هر متریک در درخواست است.

pivotValueRegions[]

object( PivotValueRegion )

مقادیر هر ناحیه محوری

PivotValueRegion

مقادیر متریک در ناحیه محوری.

نمایندگی JSON
{
  "values": [
    string
  ]
}
زمینه های
values[]

string

مقادیر معیارها در هر یک از مناطق محوری.

ResourceQuotasRemaining

توکن های سهمیه منابع باقی مانده برای ملک پس از تکمیل درخواست.

نمایندگی JSON
{
  "dailyQuotaTokensRemaining": number,
  "hourlyQuotaTokensRemaining": number
}
زمینه های
dailyQuotaTokensRemaining

number

سهمیه منابع روزانه باقی مانده است.

hourlyQuotaTokensRemaining

number

نمادهای سهمیه منابع ساعتی باقی مانده است.

آن را امتحان کنید!