@@ -61,7 +61,7 @@
6161 "id": "PivotHeader"
6262 },
6363 "Metric": {
64− "description": "A metric in the request.",
64+ "description": "[Metrics](https://support.google.com/analytics/answer/1033861)\nare the quantitative measurements. For example, the metric `ga:users`\nindicates the total number of users for the requested time period.",
6565 "type": "object",
6666 "properties": {
6767 "alias": {
@@ -308,11 +308,11 @@
308308 "type": "object",
309309 "properties": {
310310 "cohortGroup": {
311− "description": "Cohort group associated with this request. If there is a cohort group\nin the request the `ga:cohort` dimension must be present. All requests\nshould have the same cohort definitions.",
311+ "description": "Cohort group associated with this request. If there is a cohort group\nin the request the `ga:cohort` dimension must be present.\nEvery [ReportRequest](#ReportRequest) within a `batchGet` method must\ncontain the same `cohortGroup` definition.",
312312 "$ref": "CohortGroup"
313313 },
314314 "dimensions": {
315− "description": "Dimensions requested in the request.",
315+ "description": "The dimensions requested.\nRequests can have a total of 7 dimensions.",
316316 "type": "array",
317317 "items": {
318318 "$ref": "Dimension"
@@ -341,28 +341,28 @@
341341 }
342342 },
343343 "pivots": {
344− "description": "The pivot definitions.",
344+ "description": "The pivot definitions. Requests can have a maximum of 2 pivots.",
345345 "type": "array",
346346 "items": {
347347 "$ref": "Pivot"
348348 }
349349 },
350350 "dateRanges": {
351− "description": "Date ranges in the request. The request can have a maximum of 2 date\nranges. The response will contain a set of metric values for each\ncombination of the dimensions for each date range in the request. So, if\nthere are two date ranges, there will be two set of metric values, one for\nthe original date range and one for the second date range.\nThe `reportRequest.dateRanges` field should not be specified for cohorts\nor Lifetime value requests.\nIf a date range is not provided, the default date range is (startDate:\ncurrent date - 7 days, endDate: current date - 1 day)",
351+ "description": "Date ranges in the request. The request can have a maximum of 2 date\nranges. The response will contain a set of metric values for each\ncombination of the dimensions for each date range in the request. So, if\nthere are two date ranges, there will be two set of metric values, one for\nthe original date range and one for the second date range.\nThe `reportRequest.dateRanges` field should not be specified for cohorts\nor Lifetime value requests.\nIf a date range is not provided, the default date range is (startDate:\ncurrent date - 7 days, endDate: current date - 1 day). Every\n[ReportRequest](#ReportRequest) within a `batchGet` method must\ncontain the same `dateRanges` definition.",
352352 "type": "array",
353353 "items": {
354354 "$ref": "DateRange"
355355 }
356356 },
357357 "segments": {
358− "description": "Segment the data returned for the request. A segment definition helps look\nat a subset of the segment request. A request can contain up to four\nsegments. All requests should have the same segment definitions. Requests\nwith segments must have the `ga:segment` dimension.",
358+ "description": "Segment the data returned for the request. A segment definition helps look\nat a subset of the segment request. A request can contain up to four\nsegments. Every [ReportRequest](#ReportRequest) within a\n`batchGet` method must contain the same `segments` definition. Requests\nwith segments must have the `ga:segment` dimension.",
359359 "type": "array",
360360 "items": {
361361 "$ref": "Segment"
362362 }
363363 },
364364 "samplingLevel": {
365− "description": "The desired sampling level. If the sampling level is not specified the\nDEFAULT sampling level will be used. All requests should have same\n`samplingLevel`.",
365+ "description": "The desired report\n[sample](https://support.google.com/analytics/answer/2637192) size.\nIf the the `samplingLevel` field is unspecified the `DEFAULT` sampling\nlevel is used. Every [ReportRequest](#ReportRequest) within a\n`batchGet` method must contain the same `samplingLevel` definition. See\n[developer guide](/analytics/devguides/reporting/core/v4/basics#sampling)\n for details.",
366366 "enum": [
367367 "SAMPLING_UNSPECIFIED",
368368 "DEFAULT",
@@ -370,7 +370,7 @@
370370 "LARGE"
371371 ],
372372 "enumDescriptions": [
373− "If sampling level is unspecified the default sampling level is used.",
373+ "If the `samplingLevel` field is unspecified the `DEFAULT` sampling level\nis used.",
374374 "Returns response with a sample size that balances speed and\naccuracy.",
375375 "It returns a fast response with a smaller sampling size.",
376376 "Returns a more accurate response using a large sampling size. But this\nmay result in response being slower."
@@ -378,7 +378,7 @@
378378 "type": "string"
379379 },
380380 "metrics": {
381− "description": "Metrics, the quantitative measurements, requested in the request.\nRequests must specify at least one metric.",
381+ "description": "The metrics requested.\nRequests must specify at least one metric. Requests can have a\ntotal of 10 metrics.",
382382 "type": "array",
383383 "items": {
384384 "$ref": "Metric"
@@ -405,7 +405,7 @@
405405 "type": "boolean"
406406 },
407407 "viewId": {
408− "description": "Unique View Id for retrieving Analytics data.",
408+ "description": "The Analytics\n[view ID](https://support.google.com/analytics/answer/1009618)\nfrom which to retrieve data. Every [ReportRequest](#ReportRequest)\nwithin a `batchGet` method must contain the same `viewId`.",
409409 "type": "string"
410410 },
411411 "pageToken": {
@@ -508,7 +508,7 @@
508508 "format": "int32"
509509 },
510510 "samplingSpaceSizes": {
511− "description": "If sampling was enabled, this returns the total number of samples\npresent, one entry per date range.",
511+ "description": "If the results are\n[sampled](https://support.google.com/analytics/answer/2637192),\nthis returns the total number of\nsamples present, one entry per date range. If the results are not sampled\nthis field will not be defined. See\n[developer guide](/analytics/devguides/reporting/core/v4/basics#sampling)\nfor details.",
512512 "type": "array",
513513 "items": {
514514 "type": "string",
@@ -523,7 +523,7 @@
523523 }
524524 },
525525 "samplesReadCounts": {
526− "description": "If sampling was enabled, this returns the total number of samples\nread, one entry per date range",
526+ "description": "If the results are\n[sampled](https://support.google.com/analytics/answer/2637192),\nthis returns the total number of samples read, one entry per date range.\nIf the results are not sampled this field will not be defined. See\n[developer guide](/analytics/devguides/reporting/core/v4/basics#sampling)\nfor details.",
527527 "type": "array",
528528 "items": {
529529 "type": "string",
@@ -563,7 +563,7 @@
563563 "type": "object",
564564 "properties": {
565565 "reportRequests": {
566− "description": "Requests, each request will have a separate response.\nThere can be a maximum of 5 requests. All requests should have the same\n`dateRange`, `viewId`, `segments`, `samplingLevel`, and `cohortGroup`.",
566+ "description": "Requests, each request will have a separate response.\nThere can be a maximum of 5 requests. All requests should have the same\n`dateRanges`, `viewId`, `segments`, `samplingLevel`, and `cohortGroup`.",
567567 "type": "array",
568568 "items": {
569569 "$ref": "ReportRequest"
@@ -602,7 +602,7 @@
602602 ],
603603 "enumDescriptions": [
604604 "Unspecified order type will be treated as sort based on value.",
605− "The sort order is based on the value of the chosen column; looks only at\nthe first date range",
605+ "The sort order is based on the value of the chosen column; looks only at\nthe first date range.",
606606 "The sort order is based on the difference of the values of the chosen\ncolumn between the first two date ranges. Usable only if there are\nexactly two date ranges.",
607607 "The sort order is based on weighted value of the chosen column. If\ncolumn has n/d format, then weighted value of this ratio will\nbe `(n + totals.n)/(d + totals.d)` Usable only for metrics that\nrepresent ratios.",
608608 "Histogram order type is applicable only to dimension columns with\nnon-empty histogram-buckets.",
@@ -700,7 +700,7 @@
700700 "type": "object",
701701 "properties": {
702702 "dimensionNames": {
703− "description": "The name of the dimensions in the pivotDimensionValues field in the\nresponse.",
703+ "description": "The name of the dimensions in the pivot response.",
704704 "type": "array",
705705 "items": {
706706 "type": "string"
@@ -781,14 +781,14 @@
781781 "type": "object",
782782 "properties": {
783783 "dimensions": {
784− "description": "A list of dimensions to show as pivot columns.",
784+ "description": "A list of dimensions to show as pivot columns. A Pivot can have a maximum\nof 4 dimensions. Pivot dimensions are part of the restriction on the\ntotal number of dimensions allowed in the request.",
785785 "type": "array",
786786 "items": {
787787 "$ref": "Dimension"
788788 }
789789 },
790790 "metrics": {
791− "description": "Metrics to aggregate and return.",
791+ "description": "The pivot metrics. Pivot metrics are part of the\nrestriction on total number of metrics allowed in the request.",
792792 "type": "array",
793793 "items": {
794794 "$ref": "Metric"
@@ -905,7 +905,7 @@
905905 }
906906 },
907907 "metrics": {
908− "description": "List of metrics for each requested DateRange",
908+ "description": "List of metrics for each requested DateRange.",
909909 "type": "array",
910910 "items": {
911911 "$ref": "DateRangeValues"
@@ -915,7 +915,7 @@
915915 "id": "ReportRow"
916916 },
917917 "CohortGroup": {
918− "description": "Defines a cohort group.\nFor example:\n\n \"cohortGroup\": {\n \"cohorts\": [{\n \"name\": \"cohort 1\",\n \"type\": \"FIRST_VISIT_DATE\",\n \"dateRange\": { \"startDate\": \"2015-08-01\", \"endDate\": \"2015-08-01\" }\n },{\n \"name\": \"cohort 2\"\n \"type\": \"FIRST_VISIT_DATE\"\n \"dateRange\": { \"startDate\": \"2015-07-01\", \"endDate\": \"2015-07-01\" }\n }]\n }\n",
918+ "description": "Defines a cohort group.\nFor example:\n\n \"cohortGroup\": {\n \"cohorts\": [{\n \"name\": \"cohort 1\",\n \"type\": \"FIRST_VISIT_DATE\",\n \"dateRange\": { \"startDate\": \"2015-08-01\", \"endDate\": \"2015-08-01\" }\n },{\n \"name\": \"cohort 2\"\n \"type\": \"FIRST_VISIT_DATE\"\n \"dateRange\": { \"startDate\": \"2015-07-01\", \"endDate\": \"2015-07-01\" }\n }]\n }",
919919 "type": "object",
920920 "properties": {
921921 "lifetimeValue": {
@@ -1015,7 +1015,7 @@
10151015 "id": "MetricFilter"
10161016 },
10171017 "Dimension": {
1018− "description": "A dimension in the request.",
1018+ "description": "[Dimensions](https://support.google.com/analytics/answer/1033861)\nare attributes of your data. For example, the dimension `ga:city`\nindicates the city, for example, \"Paris\" or \"New York\", from which\na session originates.",
10191019 "type": "object",
10201020 "properties": {
10211021 "histogramBuckets": {
@@ -1048,7 +1048,7 @@
10481048 "id": "PivotValueRegion"
10491049 }
10501050 },
1051− "revision": "20160512",
1051+ "revision": "20160809",
10521052 "basePath": "",
10531053 "icons": {
10541054 "x32": "http://www.google.com/images/icons/product/search-32.gif",