Api-roll 37: 2016-06-06

discovery/googleapis/analyticsreporting__v4.json

Index: discovery/googleapis/analyticsreporting__v4.json
diff --git a/discovery/googleapis/analyticsreporting__v4.json b/discovery/googleapis/analyticsreporting__v4.json
index da901b3603f3159818d9f0d255dbbf0f52733db6..6a4c882bed1b073434137c5d27b1e14f31886032 100644
--- a/discovery/googleapis/analyticsreporting__v4.json
+++ b/discovery/googleapis/analyticsreporting__v4.json
@@ -140,7 +140,7 @@
             }
         }
     },
-    "revision": "20160512",
+    "revision": "20160601",
     "rootUrl": "https://analyticsreporting.googleapis.com/",
     "schemas": {
         "PivotHeader": {
@@ -411,7 +411,7 @@
             "properties": {
                 "cohortGroup": {
                     "$ref": "CohortGroup",
-                    "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."
+                    "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."
                 },
                 "dimensions": {
                     "description": "Dimensions requested in the request.",
@@ -450,21 +450,21 @@
                     "type": "array"
                 },
                 "dateRanges": {
-                    "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)",
+                    "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.",
                     "items": {
                         "$ref": "DateRange"
                     },
                     "type": "array"
                 },
                 "segments": {
-                    "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.",
+                    "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.",
                     "items": {
                         "$ref": "Segment"
                     },
                     "type": "array"
                 },
                 "samplingLevel": {
-                    "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`.",
+                    "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.",
                     "enum": [
                         "SAMPLING_UNSPECIFIED",
                         "DEFAULT",
@@ -472,7 +472,7 @@
                         "LARGE"
                     ],
                     "enumDescriptions": [
-                        "If sampling level is unspecified the default sampling level is used.",
+                        "If the `samplingLevel` field is unspecified the `DEFAULT` sampling level\nis used.",
                         "Returns response with a sample size that balances speed and\naccuracy.",
                         "It returns a fast response with a smaller sampling size.",
                         "Returns a more accurate response using a large sampling size. But this\nmay result in response being slower."
@@ -507,7 +507,7 @@
                     "type": "boolean"
                 },
                 "viewId": {
-                    "description": "Unique View Id for retrieving Analytics data.",
+                    "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`.",
                     "type": "string"
                 },
                 "pageToken": {
@@ -610,7 +610,7 @@
                     "type": "integer"
                 },
                 "samplingSpaceSizes": {
-                    "description": "If sampling was enabled, this returns the total number of samples\npresent, one entry per date range.",
+                    "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.",
                     "items": {
                         "format": "int64",
                         "type": "string"
@@ -625,7 +625,7 @@
                     "type": "array"
                 },
                 "samplesReadCounts": {
-                    "description": "If sampling was enabled, this returns the total number of samples\nread, one entry per date range",
+                    "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.",
                     "items": {
                         "format": "int64",
                         "type": "string"
@@ -665,7 +665,7 @@
             "id": "GetReportsRequest",
             "properties": {
                 "reportRequests": {
-                    "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`.",
+                    "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`.",
                     "items": {
                         "$ref": "ReportRequest"
                     },
@@ -704,7 +704,7 @@
                     ],
                     "enumDescriptions": [
                         "Unspecified order type will be treated as sort based on value.",
-                        "The sort order is based on the value of the chosen column; looks only at\nthe first date range",
+                        "The sort order is based on the value of the chosen column; looks only at\nthe first date range.",
                         "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.",
                         "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.",
                         "Histogram order type is applicable only to dimension columns with\nnon-empty histogram-buckets.",
@@ -802,7 +802,7 @@
             "id": "PivotHeaderEntry",
             "properties": {
                 "dimensionNames": {
-                    "description": "The name of the dimensions in the pivotDimensionValues field in the\nresponse.",
+                    "description": "The name of the dimensions in the pivot response.",
                     "items": {
                         "type": "string"
                     },
@@ -1007,7 +1007,7 @@
                     "type": "array"
                 },
                 "metrics": {
-                    "description": "List of metrics for each requested DateRange",
+                    "description": "List of metrics for each requested DateRange.",
                     "items": {
                         "$ref": "DateRangeValues"
                     },