- HTTP 请求
- 请求正文
- 响应正文
- 授权作用域
- ReportRequest
- 采样
- 维度
- DimensionFilterClause
- FilterLogicalOperator
- DimensionFilter
- 运算符
- 指标
- MetricType
- MetricFilterClause
- MetricFilter
- 运算符
- OrderBy
- OrderType
- SortOrder
- 细分
- DynamicSegment
- SegmentDefinition
- SegmentFilter
- SimpleSegmentSimpleSegment
- OrFiltersForSegment
- SegmentFilterClause
- SegmentDimensionFilter
- 运算符
- SegmentMetricFilter
- 镜
- 运算符
- SequenceSegment
- SegmentSequenceStep
- MatchType
- 数据透视
- CohortGroup
- 同类群组
- 类型
- 报告
- ColumnHeader
- MetricHeader
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- ReportData
- ReportRow
- DateRangeValues
- PivotValueRegion
- ResourceQuotasRemaining
- 试试看!
返回 Google Analytics(分析)数据。
HTTP 请求
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 | |
---|---|
{
"reportRequests": [
{
object( |
字段 | |
---|---|
reportRequests[] |
请求,每个请求都会有单独的响应。最多可有 5 个请求。所有请求都应具有相同的 |
useResourceQuotas |
启用基于资源的配额(默认为 |
响应正文
如果成功,响应正文将包含结构如下的数据:
包含来自 Reporting API batchGet
调用的报告的主响应类。
JSON 表示法 | |
---|---|
{ "reports": [ { object( |
字段 | |
---|---|
reports[] |
对应于每个请求的响应。 |
queryCost |
执行查询时扣减的资源配额令牌数量。包括所有回复。 |
resourceQuotasRemaining |
媒体资源的剩余资源配额量。 |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ReportRequest
指定 Reporting API 请求的主请求类。
JSON 表示法 | |
---|---|
{ "viewId": string, "dateRanges": [ { object( |
字段 | |
---|---|
viewId |
从中提取数据的 Google Analytics(分析)数据视图 ID。 |
dateRanges[] |
请求中的日期范围。请求最多可以包含 2 个日期范围。对于请求中每个日期范围的维度的每个组合,响应都会包含一组指标值。因此,如果有两个日期范围,就会有两组指标值:一组针对原始日期范围,另一组针对第二个日期范围。对于同类群组或生命周期价值请求,不应指定 |
samplingLevel |
所需的报告样本大小。如果未指定 |
dimensions[] |
请求的维度。请求总共可有 9 个维度。 |
dimensionFilterClauses[] |
过滤维度值的维度过滤子句。它们与 |
metrics[] |
请求的指标。请求必须指定至少一个指标。请求总共可有 10 个指标。 |
metricFilterClauses[] |
指标过滤子句。它们与 |
filtersExpression |
限制针对您的请求返回的数据的维度或指标过滤条件。如需使用 |
orderBys[] |
输出行的排序顺序。要对两行进行比较,会按顺序应用以下元素,直到找到差异。输出中的所有日期范围将获得相同的行顺序。 |
segments[] |
细分针对请求返回的数据。细分定义有助于查看细分请求的子集。一个请求最多可以包含四个细分。 |
pivots[] |
数据透视定义。请求最多可以有 2 个数据透视。 |
cohortGroup |
与此请求相关联的同类群组。如果请求中包含同类群组,则必须提供“ |
pageToken |
获得下一页结果的延续令牌。将此令牌添至请求将返回 pageToken 后的行。pageToken 应是响应 reports.batchGet 请求而在 nextPageToken 参数中返回的值。 |
pageSize |
页面大小用于分页,并指定返回行的最大数目。页面大小应 >= 0。查询默认返回 1000 行。无论您请求返回多少行,对于每个请求,Analytics Core Reporting API 最多只能返回 100,000 行。如果维度细分数量达不到您的预期,API 返回的行数也可能小于请求的数量。例如,如果 |
includeEmptyRows |
如果设置为 false,响应不包括获取的所有指标都等于零的行。默认值为 false,将排除这些行。 |
hideTotals |
如果设置为 true,则对于每一个日期范围隐藏所有匹配行的所有指标总计。默认值为 false,将返回总计值。 |
hideValueRanges |
如果设置为 true,隐藏所有匹配行的最小值和最大值。默认值为 false,返回值范围。 |
采样
抽样级别的值。
枚举 | |
---|---|
SAMPLING_UNSPECIFIED |
如果未指定 samplingLevel 字段,系统会使用 DEFAULT 抽样级别。 |
DEFAULT |
返回的响应采用默认抽样规模,速度和准确度相平衡。 |
SMALL |
返回的响应采用较小抽样规模,但响应速度更快。 |
LARGE |
返回的响应采用较大抽样规模,准确度更高,但是响应速度可能较慢。 |
维度
维度是指数据的属性。举例来说,ga:city
维度表示的是发起会话的城市,例如“巴黎”或“纽约”。
JSON 表示法 | |
---|---|
{ "name": string, "histogramBuckets": [ string ] } |
字段 | |
---|---|
name |
要获取的维度的名称,例如 |
histogramBuckets[] |
如果非空,在将字符串转为 int64 后,将维度值置入范围。如果维度值不是字符串表示的整数值,将被转换为零。范围值必须采用递增顺序。每个范围在低端封闭,在高端开放。“第一个”范围包括小于第一个边界值的所有值,“最后一个”范围包括至无穷大的所有值。落入某个范围的维度值被转换为新的维度值。例如,如果给出一个列表“0, 1, 3, 4, 7”,那么我们将返回以下范围:
注意:如果您要对任何维度应用直方图转变,并在排序中使用该维度,您可以使用排序类型 "<50", "1001+", "121-1000", "50-120"
"<50", "50-120", "121-1000", "1001+" 客户端必须明确请求 |
DimensionFilterClause
一组维度过滤条件。设置运算符值来指定过滤条件的逻辑合并方式。
JSON 表示法 | |
---|---|
{ "operator": enum( |
字段 | |
---|---|
operator |
合并多个维度过滤条件的运算符。如果未指定,则被视为 |
filters[] |
重复的过滤条件组。它们基于指定的运算符进行逻辑组合。 |
FilterLogicalOperator
过滤条件的逻辑合并方式。
枚举 | |
---|---|
OPERATOR_UNSPECIFIED |
未指定运算符。被视为 OR 。 |
OR |
逻辑 OR 运算符。 |
AND |
逻辑 AND 运算符。 |
DimensionFilter
维度过滤条件指定对维度的过滤选项。
JSON 表示法 | |
---|---|
{
"dimensionName": string,
"not": boolean,
"operator": enum( |
字段 | |
---|---|
dimensionName |
作为过滤条件依据的维度。DimensionFilter 必须包含维度。 |
not |
逻辑 |
operator |
如何将维度与表达式进行匹配。默认值为 REGEXP。 |
expressions[] |
要匹配的字符串或正则表达式。除非运算符为 |
caseSensitive |
匹配是否区分大小写?默认值为 false。 |
运算符
支持不同的匹配类型。
枚举 | |
---|---|
OPERATOR_UNSPECIFIED |
如果未指定匹配类型,将被视为 REGEXP 。 |
REGEXP |
匹配表达式被视为正则表达式。所有的匹配类型被视为不是正则表达式。 |
BEGINS_WITH |
所匹配的值起始于所提供的匹配表达式。 |
ENDS_WITH |
所匹配的值结束于所提供的匹配表达式。 |
PARTIAL |
子字符串匹配。 |
EXACT |
该值应该与匹配表达式完全匹配。 |
NUMERIC_EQUAL |
整数比较过滤条件。对这些不区分大小写,且假定表达式是代表整数的字符串。失败的情况:
|
NUMERIC_GREATER_THAN |
检查该维度从数值上是否大于匹配表达式。阅读 NUMERIC_EQUALS 的说明,了解其限制。 |
NUMERIC_LESS_THAN |
检查该维度从数值上是否小于匹配表达式。阅读 NUMERIC_EQUALS 的说明,了解其限制。 |
IN_LIST |
使用该选项可以指定这样一类维度过滤条件:其表达式可从所选的一列值中提取任何值。对于对每一个响应行都采用了 OR 连接的多个完全匹配维度过滤条件,这有助于避免对其进行求值。例如:
其维度值为 A、B 或 C 的任何响应行匹配此 DimensionFilter。 |
指标
指标是定量测量。例如,ga:users
指标表示所请求时间段内的用户总数。
JSON 表示法 | |
---|---|
{
"expression": string,
"alias": string,
"formattingType": enum( |
字段 | |
---|---|
expression |
请求中的指标表达式。表达式由一个或多个指标和数字构成。接受的运算符包括:加号 (+)、减号 (-)、否定(一元 -)、除号 (/)、乘号 (*)、英文括号、正基数数字 (0-9),可以包含小数,且仅限于 1024 个字符。例如 |
alias |
指标表达式的别名是表达式的替代名称。别名可用于过滤和排序。此字段是可选的,如果表达式不是单个指标,而是一个复杂的表达式,无法用在过滤和排序中,此字段就是有用的。别名也用在响应列标题中。 |
formattingType |
指定指标表达式的格式设置方式,例如 |
MetricType
指标的类型。
枚举 | |
---|---|
METRIC_TYPE_UNSPECIFIED |
指标类型未指定。 |
INTEGER |
整数指标。 |
FLOAT |
浮点数指标。 |
CURRENCY |
币种指标。 |
PERCENT |
百分数指标。 |
TIME |
时间指标,采用 HH:MM:SS 格式。 |
MetricFilterClause
代表一组指标过滤条件。设置运算符值来指定过滤条件的逻辑合并方式。
JSON 表示法 | |
---|---|
{ "operator": enum( |
字段 | |
---|---|
operator |
合并多个指标过滤条件的运算符。如果未指定,则被视为 |
filters[] |
重复的过滤条件组。它们基于指定的运算符进行逻辑组合。 |
MetricFilter
MetricFilter 指定对指标的过滤条件。
JSON 表示法 | |
---|---|
{
"metricName": string,
"not": boolean,
"operator": enum( |
字段 | |
---|---|
metricName |
将作为过滤依据的指标。metricFilter 必须包含指标名。指标名称可以是之前定义为指标的别名,也可以是指标表达式。 |
not |
逻辑 |
operator |
指标 |
comparisonValue |
要比较的值。 |
运算符
不同的比较类型选项。
枚举 | |
---|---|
OPERATOR_UNSPECIFIED |
如果未指定运算符,将被视为 EQUAL 。 |
EQUAL |
指标值是否应恰好等于比较值。 |
LESS_THAN |
指标值是否应小于比较值。 |
GREATER_THAN |
指标值是否应大于比较值。 |
IS_MISSING |
验证指标是否缺失。不考虑 comparisonValue。 |
OrderBy
指定排序选项。
JSON 表示法 | |
---|---|
{ "fieldName": string, "orderType": enum( |
字段 | |
---|---|
fieldName |
要排序的字段。默认的排序顺序是升序。示例: |
orderType |
排序类型。默认的 orderType 是 |
sortOrder |
字段的排序顺序。 |
OrderType
OrderType 控制排序顺序的确定方式。
枚举 | |
---|---|
ORDER_TYPE_UNSPECIFIED |
未指定的顺序类型将视为根据值进行排序。 |
VALUE |
排序顺序依据所选列的值;仅考察第一个日期范围。 |
DELTA |
排序顺序依据前两个日期范围之间所选列的值差。仅当恰好有两个日期范围时可用。 |
SMART |
排序顺序依据所选列的加权值。如果列的格式是“n/d”,则此比率的加权值将为 (n + totals.n)/(d + totals.d) 。仅适用于表示比率的指标。 |
HISTOGRAM_BUCKET |
直方图顺序类型仅适用于直方图范围非空的维度列。 |
DIMENSION_AS_INTEGER |
如果维度是固定长度的数字,普通排序完全能正常操作。如果维度是可变长度的数字,可以使用 DIMENSION_AS_INTEGER 。 |
SortOrder
此排序的排序顺序。
枚举 | |
---|---|
SORT_ORDER_UNSPECIFIED |
如果未指定排序顺序,默认是升序。 |
ASCENDING |
升序排序。该字段采用升序方式进行排序。 |
DESCENDING |
降序排序。该字段采用降序方式进行排序。 |
分割部分
是否需要对该报告进行细分的细分定义。细分是指 Google Analytics(分析)数据的一个子集。例如,在整个用户群中,可使用一个细分指定来自特定国家/地区或城市的用户。
JSON 表示法 | |
---|---|
{ // Union field |
字段 | ||
---|---|---|
联合字段 dynamicOrById 。可以使用 DynamicSegment 或通过内置或自定义细分的 ID 动态定义细分。dynamicOrById 只能是下列其中一项: |
||
dynamicSegment |
请求中的动态细分定义。 |
|
segmentId |
内置或自定义细分的细分 ID,例如 |
DynamicSegment
动态细分定义,用于定义请求中的细分。一个细分可以选择用户和/或会话。
JSON 表示法 | |
---|---|
{ "name": string, "userSegment": { object( |
字段 | |
---|---|
name |
动态细分的名称。 |
userSegment |
用于选择要包含在细分中的用户的用户细分。 |
sessionSegment |
用于选择要包含在细分中的会话的会话细分。 |
SegmentDefinition
SegmentDefinition 将细分定义为一组使用逻辑 AND
操作合并起来的 SegmentFilters。
JSON 表示法 | |
---|---|
{
"segmentFilters": [
{
object( |
字段 | |
---|---|
segmentFilters[] |
将细分定义为一组使用逻辑 |
SegmentFilter
SegmentFilter 将细分定义为简单细分或顺序细分。简单细分条件包含选择会话或用户的维度和指标条件。顺序细分条件可用于基于顺序条件选择用户或会话。
JSON 表示法 | |
---|---|
{ "not": boolean, // Union field |
字段 | ||
---|---|---|
not |
如果为 true,匹配简单细分或顺序细分的补集。例如,为了匹配不是来自“New York”的所有访问,我们可以如下定义细分:
|
|
联合字段 simpleOrSequence 。是简单细分还是顺序细分定义。simpleOrSequence 只能是下列其中一项: |
||
simpleSegment |
简单细分条件由一个或多个可以合并的维度/指标条件组成 |
|
sequenceSegment |
顺序条件由一个或多个步骤组成,其中每个步骤都由一个或多个维度/指标条件定义。可以使用特殊序列运算符合并多个步骤。 |
SimpleSegment
简单细分条件由可以合并的一个或多个维度/指标条件组成。
JSON 表示法 | |
---|---|
{
"orFiltersForSegment": [
{
object( |
字段 | |
---|---|
orFiltersForSegment[] |
一列使用逻辑 |
OrFiltersForSegment
OR
组中的一列细分过滤条件使用逻辑 OR 运算符合并。
JSON 表示法 | |
---|---|
{
"segmentFilterClauses": [
{
object( |
字段 | |
---|---|
segmentFilterClauses[] |
使用 |
SegmentFilterClause
细分定义中所用的过滤条件子句,可以采用指标或维度过滤条件。
JSON 表示法 | |
---|---|
{ "not": boolean, // Union field |
字段 | ||
---|---|---|
not |
匹配过滤条件的补集 ( |
|
联合字段 dimensionOrMetricFilter 。维度或指标过滤条件。dimensionOrMetricFilter 只能是下列其中一项: |
||
dimensionFilter |
细分定义的维度过滤条件。 |
|
metricFilter |
细分定义的指标过滤条件。 |
SegmentDimensionFilter
维度过滤条件指定对维度的过滤选项。
JSON 表示法 | |
---|---|
{
"dimensionName": string,
"operator": enum( |
字段 | |
---|---|
dimensionName |
应用过滤条件的维度的名称。 |
operator |
用于将维度与表达式进行匹配的运算符。 |
caseSensitive |
匹配是否应区分大小写,对于 |
expressions[] |
表达式列表,只有第一个元素用于所有运算符 |
minComparisonValue |
|
maxComparisonValue |
|
运算符
支持不同的匹配类型。
枚举 | |
---|---|
OPERATOR_UNSPECIFIED |
如果未指定匹配类型,将被视为 REGEXP。 |
REGEXP |
匹配表达式被视为正则表达式。所有其他匹配类型都不会被视为正则表达式。 |
BEGINS_WITH |
所匹配的值起始于所提供的匹配表达式。 |
ENDS_WITH |
所匹配的值结束于所提供的匹配表达式。 |
PARTIAL |
子字符串匹配。 |
EXACT |
该值应该与匹配表达式完全匹配。 |
IN_LIST |
使用该选项可以指定这样一类维度过滤条件:其表达式可从所选的一列值中提取任何值。对于对每一个响应行都采用了 OR 连接的多个完全匹配维度过滤条件,这有助于避免对其进行求值。例如:
其维度值为 A、B 或 C 的任何响应行匹配此 DimensionFilter。 |
NUMERIC_LESS_THAN |
整数比较过滤条件。对这些不区分大小写,且假定表达式是代表整数的字符串。失败的情况:
检查该维度从数值上是否小于匹配表达式。 |
NUMERIC_GREATER_THAN |
检查该维度从数值上是否大于匹配表达式。 |
NUMERIC_BETWEEN |
检查该维度从数值上是否落在匹配表达式的最小值和最大值之间,不含边界值。 |
SegmentMetricFilter
细分过滤条件子句中所用的指标过滤条件。
JSON 表示法 | |
---|---|
{ "scope": enum( |
字段 | |
---|---|
scope |
指标范围可以界定指标定义的级别。指定的指标范围必须等于或大于其主要范围(根据数据模型中的定义)。主要范围是由相应细分是否选择用户或会话来定义。 |
metricName |
将作为过滤依据的指标。 |
operator |
指定对指标进行比较所执行的操作。默认值为 |
comparisonValue |
要比较的值。如果运算符为 |
maxComparisonValue |
只对 |
范围
指标范围定义了指标定义的级别 - PRODUCT
、HIT
、SESSION
或 USER
。报告指标值的范围也可以大于其主要范围。例如,只需将 ga:pageviews
和 ga:transactions
这两个会话中发生的每次命中或这些用户的命中数相加,便可在 SESSION
和 USER
层级进行报告。
枚举 | |
---|---|
UNSPECIFIED_SCOPE |
如果未指定范围,则取决于细分是要选择用户还是会话,将默认为条件范围 USER 或 SESSION 。 |
PRODUCT |
产品范围。 |
HIT |
匹配范围。 |
SESSION |
会话范围。 |
USER |
用户范围。 |
运算符
不同的比较类型选项。
枚举 | |
---|---|
UNSPECIFIED_OPERATOR |
未指定的运算符将被视为 LESS_THAN 运算符。 |
LESS_THAN |
检查该指标值是否小于比较值。 |
GREATER_THAN |
检查该指标值是否大于比较值。 |
EQUAL |
等于运算符。 |
BETWEEN |
对于“之间”运算符,最小值和最大值都是被排除的。我们使用 LT 和 GT 进行比较。 |
SequenceSegment
顺序条件由一个或多个步骤组成,其中每个步骤都由一个或多个维度/指标条件定义。利用特殊的顺序运算符可以将多个步骤合并在一起。
JSON 表示法 | |
---|---|
{
"segmentSequenceSteps": [
{
object( |
字段 | |
---|---|
segmentSequenceSteps[] |
序列中的步骤列表。 |
firstStepShouldMatchFirstHit |
如果设置,第一步条件必须与(日期范围内)访问者的第一次命中相匹配。 |
SegmentSequenceStep
细分顺序定义。
JSON 表示法 | |
---|---|
{ "orFiltersForSegment": [ { object( |
字段 | |
---|---|
orFiltersForSegment[] |
顺序被指定为使用 |
matchType |
指定下一步骤是紧随此步骤还是可以发生在下一步骤之前的任何时间。 |
MatchType
此顺序的匹配类型。
枚举 | |
---|---|
UNSPECIFIED_MATCH_TYPE |
未指定匹配类型被视为“precedes”(先于)。 |
PRECEDES |
运算符表示,前一个步骤先于后一个步骤发生。 |
IMMEDIATELY_PRECEDES |
运算符表示,后一个步骤紧接着前一个步骤发生。 |
数据透视
数据透视描述请求中的数据透视部分。数据透视可通过透视第二个维度的数据,帮助您重新排列特定报告的表格中的信息。
JSON 表示法 | |
---|---|
{ "dimensions": [ { object( |
字段 | |
---|---|
dimensions[] |
显示为数据透视列的维度列表。数据透视最多可以有 4 个维度。数据透视维度属于对请求中所允许维度总数的限制。 |
dimensionFilterClauses[] |
DimensionFilterClauses 以 |
metrics[] |
数据透视指标。数据透视指标属于对请求中所允许指标总数的限制。 |
startGroup |
如果请求 k 个指标,则响应将在报告中包含 k 列的某个与数据相关的倍数。例如,如果您根据维度 以下内容供您选择在响应中加入 k 列的哪些组合。 |
maxGroupCount |
指定返回的最大组数。默认值为 10,最大值为 1,000。 |
CohortGroup
定义同类群组的组。例如:
"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( |
字段 | |
---|---|
cohorts[] |
同类群组的定义。 |
lifetimeValue |
启用生命周期价值 (LTV)。LTV 衡量通过不同渠道获得的用户的生命周期价值。如果 LifeValue 的值为 false,请参阅同类群组分析和生命周期价值:
如果 lifetimeValue 为 true:
|
同类群组
定义同类群组。同类群组是具有共同特征的一组用户。例如,流量获取日期相同的所有用户属于同一个同类群组。
JSON 表示法 | |
---|---|
{ "name": string, "type": enum( |
字段 | |
---|---|
name |
同类群组的唯一的名称。如果未指定,系统将使用值同类群组_[1234...]自动生成名称。 |
type |
同类群组的类型。截至目前,唯一支持的类型为 |
dateRange |
用于 |
类型
同类群组的类型。
枚举 | |
---|---|
UNSPECIFIED_COHORT_TYPE |
如果未指定,则被视为 FIRST_VISIT_DATE 。 |
FIRST_VISIT_DATE |
根据首次访问日期选择的同类群组。 |
举报
对应于请求的数据响应。
JSON 表示法 | |
---|---|
{ "columnHeader": { object( |
字段 | |
---|---|
columnHeader |
列标题。 |
data |
响应数据。 |
nextPageToken |
用于检索列表中下一页结果的页面令牌。 |
ColumnHeader
列标题。
JSON 表示法 | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
字段 | |
---|---|
dimensions[] |
响应中的维度名称。 |
metricHeader |
响应中指标的指标标头。 |
MetricHeader
指标的标头。
JSON 表示法 | |
---|---|
{ "metricHeaderEntries": [ { object( |
字段 | |
---|---|
metricHeaderEntries[] |
响应中指标的标头。 |
pivotHeaders[] |
响应中数据透视的标题。 |
MetricHeaderEntry
指标的标头。
JSON 表示法 | |
---|---|
{
"name": string,
"type": enum( |
字段 | |
---|---|
name |
标头的名称。 |
type |
指标的类型,例如 |
PivotHeader
请求中定义的每个数据透视部分的标头。
JSON 表示法 | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
字段 | |
---|---|
pivotHeaderEntries[] |
单个数据透视部分标题。 |
totalPivotGroupsCount |
此数据透视的总组数。 |
PivotHeaderEntry
与响应的数据透视部分所请求的指标相对应的每个指标列的标题。
JSON 表示法 | |
---|---|
{
"dimensionNames": [
string
],
"dimensionValues": [
string
],
"metric": {
object( |
字段 | |
---|---|
dimensionNames[] |
数据透视响应中维度的名称。 |
dimensionValues[] |
数据透视中维度的值。 |
metric |
数据透视中指标的指标标头。 |
ReportData
报告的数据部分。
JSON 表示法 | |
---|---|
{ "rows": [ { object( |
字段 | |
---|---|
rows[] |
维度的每个唯一组合都有一个 ReportRow。 |
totals[] |
对于每一个请求的日期范围,对于与查询匹配的所有行组,每一个请求的值格式将得到一个总计。值格式总计的计算方式是,首先加总值格式中提到的指标,然后将值格式作为标量表达式求值。例如,我们计算出 |
rowCount |
此查询的匹配行总数。 |
minimums[] |
所有匹配行的最小值和最大值。当请求中的 |
maximums[] |
所有匹配行的最小值和最大值。当请求中的 |
samplesReadCounts[] |
如果对结果进行抽样,将返回所读取样本的总数,每个日期范围一个条目。如果未对结果进行抽样,则不会定义此字段。如需了解详情,请参阅开发者指南。 |
samplingSpaceSizes[] |
如果对结果进行抽样,将返回所提供样本的总数,每个日期范围一个条目。如果未对结果进行抽样,则不会定义此字段。如需了解详情,请参阅开发者指南。 |
isDataGolden |
表示对这一请求的响应是否是黄金响应。如果在稍后的某个时间点发出完全相同的请求,而不会产生任何新结果,那么数据就是黄金数据。 |
dataLastRefreshed |
报告中的数据上次刷新的时间。在此时间戳之前收到的所有命中都包含在报告的计算中。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒。示例: |
ReportRow
报告中的一行。
JSON 表示法 | |
---|---|
{
"dimensions": [
string
],
"metrics": [
{
object( |
字段 | |
---|---|
dimensions[] |
所请求维度的列表。 |
metrics[] |
每个请求的 DateRange 的指标列表。 |
DateRangeValues
用于针对单个 DateRange/维度组合返回一列指标
JSON 表示法 | |
---|---|
{
"values": [
string
],
"pivotValueRegions": [
{
object( |
字段 | |
---|---|
values[] |
每个值对应于请求中的每个指标。 |
pivotValueRegions[] |
每个数据透视区域的值。 |
PivotValueRegion
数据透视区域中的指标值。
JSON 表示法 | |
---|---|
{ "values": [ string ] } |
字段 | |
---|---|
values[] |
每个数据透视区域中指标的值。 |
ResourceQuotasRemaining
请求完成后,媒体资源剩余的资源配额令牌。
JSON 表示法 | |
---|---|
{ "dailyQuotaTokensRemaining": number, "hourlyQuotaTokensRemaining": number } |
字段 | |
---|---|
dailyQuotaTokensRemaining |
剩余的每日资源配额。 |
hourlyQuotaTokensRemaining |
剩余的每小时资源配额令牌。 |