@@ -599,13 +599,14 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
599599 *  This is used for `FIRST_VISIT_DATE` cohort, the cohort selects users 
600600 *  whose first visit date is between start date and end date defined in the 
601601 *  DateRange. The date ranges should be aligned for cohort requests. If the 
602-  *  request contains cohort_nth_day  it should be exactly one day long, 
602+  *  request contains `ga:cohortNthDay`  it should be exactly one day long, 
603603 *  if `ga:cohortNthWeek` it should be aligned to the week boundary (starting 
604-  *  at Sunday and ending Saturday), and for cohort_nth_month  the date range 
604+  *  at Sunday and ending Saturday), and for `ga:cohortNthMonth`  the date range 
605605 *  should be aligned to the month (starting at the first and ending on the 
606606 *  last day of the month). 
607607 *  For LTV requests there are no such restrictions. 
608-  *  You do not need to supply a date range for the reportsRequest object. 
608+  *  You do not need to supply a date range for the 
609+  *  `reportsRequest.dateRanges` field. 
609610 */  
610611@property (strong , nullable ) GTLRAnalyticsReporting_DateRange *dateRange;
611612
@@ -677,6 +678,9 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
677678 *  increment. 
678679 *  - The cohort definition date ranges need not be aligned to the calendar 
679680 *  week and month boundaries. 
681+  *  - The `viewId` must be an 
682+  *  [app view 
683+  *  ID](https://support.google.com/analytics/answer/2649553#WebVersusAppViews) 
680684 * 
681685 *  Uses NSNumber of boolValue. 
682686 */  
@@ -915,15 +919,19 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
915919 */  
916920@interface  GTLRAnalyticsReporting_GetReportsRequest  : GTLRObject 
917921
918- /* * Requests, each request will have a separate response. */ 
922+ /* *
923+  *  Requests, each request will have a separate response. 
924+  *  There can be a maximum of 5 requests. All requests should have the same 
925+  *  `dateRange`, `viewId`, `segments`, `samplingLevel`, and `cohortGroup`. 
926+  */  
919927@property (strong , nullable ) NSArray <GTLRAnalyticsReporting_ReportRequest *> *reportRequests;
920928
921929@end 
922930
923931
924932/* *
925933 *  The main response class which holds the reports from the Reporting API 
926-  *  batchRequest  call. 
934+  *  `batchGet`  call. 
927935 */  
928936@interface  GTLRAnalyticsReporting_GetReportsResponse  : GTLRObject 
929937
@@ -954,6 +962,8 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
954962 *  Positive cardinal numbers (0-9), can include decimals and is limited to 
955963 *  1024 characters. Example `ga:totalRefunds/ga:users`, in most cases the 
956964 *  metric expression is just a single metric name like `ga:users`. 
965+  *  Adding mixed `MetricType` (E.g., `CURRENCY` + `PERCENTAGE`) metrics 
966+  *  will result in unexpected results. 
957967 */  
958968@property (copy , nullable ) NSString  *expression;
959969
@@ -1207,7 +1217,7 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
12071217
12081218/* *
12091219 *  Specifies the maximum number of groups to return. 
1210-  *  If set to -1, returns all groups. The default  value is 5 . 
1220+  *  The default value is 10, also the maximum  value is 1,000 . 
12111221 * 
12121222 *  Uses NSNumber of intValue. 
12131223 */  
@@ -1380,7 +1390,8 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
13801390
13811391/* *
13821392 *  Cohort group associated with this request. If there is a cohort group 
1383-  *  in the request the `ga:cohort` dimension must be present. 
1393+  *  in the request the `ga:cohort` dimension must be present. All requests 
1394+  *  should have the same cohort definitions. 
13841395 */  
13851396@property (strong , nullable ) GTLRAnalyticsReporting_CohortGroup *cohortGroup;
13861397
@@ -1390,8 +1401,10 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
13901401 *  combination of the dimensions for each date range in the request. So, if 
13911402 *  there are two date ranges, there will be two set of metric values, one for 
13921403 *  the original date range and one for the second date range. 
1393-  *  Date ranges should not be specified for cohorts or Lifetime value 
1394-  *  requests. 
1404+  *  The `reportRequest.dateRanges` field should not be specified for cohorts 
1405+  *  or Lifetime value requests. 
1406+  *  If a date range is not provided, the default date range is (startDate: 
1407+  *  current date - 7 days, endDate: current date - 1 day) 
13951408 */  
13961409@property (strong , nullable ) NSArray <GTLRAnalyticsReporting_DateRange *> *dateRanges;
13971410
@@ -1408,7 +1421,7 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
14081421
14091422/* *
14101423 *  Dimension or metric filters that restrict the data returned for your 
1411-  *  request. To use the filtersExpression, supply a dimension or metric on 
1424+  *  request. To use the ` filtersExpression` , supply a dimension or metric on 
14121425 *  which to filter, followed by the filter expression. For example, the 
14131426 *  following expression selects `ga:browser` dimension which starts with 
14141427 *  Firefox; `ga:browser=~^Firefox`. For more information on dimensions 
@@ -1451,20 +1464,22 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
14511464 */  
14521465@property (strong , nullable ) NSArray <GTLRAnalyticsReporting_MetricFilterClause *> *metricFilterClauses;
14531466
1454- /* * Metrics (numbers) requested in the request. */ 
1467+ /* *
1468+  *  Metrics, the quantitative measurements, requested in the request. 
1469+  *  Requests must specify at least one metric. 
1470+  */  
14551471@property (strong , nullable ) NSArray <GTLRAnalyticsReporting_Metric *> *metrics;
14561472
14571473/* *
14581474 *  Sort order on output rows. To compare two rows, the elements of the 
14591475 *  following are applied in order until a difference is found. All date 
1460-  *  ranges in the output get the same row order. The `order_by` field gets 
1461-  *  applied first followed by the sorts in the `additional_ordering` fields. 
1476+  *  ranges in the output get the same row order. 
14621477 */  
14631478@property (strong , nullable ) NSArray <GTLRAnalyticsReporting_OrderBy *> *orderBys;
14641479
14651480/* *
14661481 *  Page size is for paging and specifies the maximum number of returned rows. 
1467-  *  Page size should be >= 0. A query returns the default of 1000  rows. 
1482+  *  Page size should be >= 0. A query returns the default of 1,000  rows. 
14681483 *  The Analytics Core Reporting API returns a maximum of 10,000 rows per 
14691484 *  request, no matter how many you ask for. It can also return fewer rows 
14701485 *  than requested, if there aren't as many dimension segments as you expect. 
@@ -1489,7 +1504,8 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
14891504
14901505/* *
14911506 *  The desired sampling level. If the sampling level is not specified the 
1492-  *  DEFAULT sampling level will be used. 
1507+  *  DEFAULT sampling level will be used. All requests should have same 
1508+  *  `samplingLevel`. 
14931509 * 
14941510 *  Likely values: 
14951511 *    @arg @c kGTLRAnalyticsReporting_ReportRequest_SamplingLevel_Default 
@@ -1509,7 +1525,8 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
15091525/* *
15101526 *  Segment the data returned for the request. A segment definition helps look 
15111527 *  at a subset of the segment request. A request can contain up to four 
1512-  *  segments. 
1528+  *  segments. All requests should have the same segment definitions. Requests 
1529+  *  with segments must have the `ga:segment` dimension. 
15131530 */  
15141531@property (strong , nullable ) NSArray <GTLRAnalyticsReporting_Segment *> *segments;
15151532
@@ -1543,7 +1560,7 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
15431560/* * A dynamic segment definition in the request. */ 
15441561@property (strong , nullable ) GTLRAnalyticsReporting_DynamicSegment *dynamicSegment;
15451562
1546- /* * The segment ID of a built-in or custom segment, for example ' gaid::-3' . */ 
1563+ /* * The segment ID of a built-in or custom segment, for example ` gaid::-3` . */ 
15471564@property (copy , nullable ) NSString  *segmentId;
15481565
15491566@end 
@@ -1570,7 +1587,7 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
15701587@interface  GTLRAnalyticsReporting_SegmentDimensionFilter  : GTLRObject 
15711588
15721589/* *
1573-  *  Should the match be case sensitive, ignored for IN_LIST operator. 
1590+  *  Should the match be case sensitive, ignored for ` IN_LIST`  operator. 
15741591 * 
15751592 *  Uses NSNumber of boolValue. 
15761593 */  
@@ -1584,10 +1601,10 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
15841601 */  
15851602@property (strong , nullable ) NSArray <NSString *> *expressions;
15861603
1587- /* * Maximum comparison values for BETWEEN match type. */ 
1604+ /* * Maximum comparison values for ` BETWEEN`  match type. */ 
15881605@property (copy , nullable ) NSString  *maxComparisonValue;
15891606
1590- /* * Minimum comparison values for BETWEEN match type. */ 
1607+ /* * Minimum comparison values for ` BETWEEN`  match type. */ 
15911608@property (copy , nullable ) NSString  *minComparisonValue;
15921609
15931610/* *
@@ -1731,7 +1748,7 @@ GTLR_EXTERN NSString * const kGTLRAnalyticsReporting_SegmentSequenceStep_MatchTy
17311748 */  
17321749@property (copy , nullable ) NSString  *comparisonValue;
17331750
1734- /* * Max comparison value is only used for BETWEEN operator. */ 
1751+ /* * Max comparison value is only used for ` BETWEEN`  operator. */ 
17351752@property (copy , nullable ) NSString  *maxComparisonValue;
17361753
17371754/* *
0 commit comments