class Google::Apis::AnalyticsreportingV4::ReportRequest

The main request class which specifies the Reporting API request.

Attributes

cohort_group[RW]

Defines a cohort group. For example: “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” ` `] ` Corresponds to the JSON property `cohortGroup` @return [Google::Apis::AnalyticsreportingV4::CohortGroup]

date_ranges[RW]

Date ranges in the request. The request can have a maximum of 2 date ranges. The response will contain a set of metric values for each combination of the dimensions for each date range in the request. So, if there are two date ranges, there will be two set of metric values, one for the original date range and one for the second date range. The `reportRequest.dateRanges` field should not be specified for cohorts or Lifetime value requests. If a date range is not provided, the default date range is (startDate: current date - 7 days, endDate: current date - 1 day). Every [ReportRequest](#ReportRequest) within a `batchGet` method must contain the same `dateRanges` definition. Corresponds to the JSON property `dateRanges` @return [Array<Google::Apis::AnalyticsreportingV4::DateRange>]

dimension_filter_clauses[RW]

The dimension filter clauses for filtering Dimension Values. They are logically combined with the `AND` operator. Note that filtering occurs before any dimensions are aggregated, so that the returned metrics represent the total for only the relevant dimensions. Corresponds to the JSON property `dimensionFilterClauses` @return [Array<Google::Apis::AnalyticsreportingV4::DimensionFilterClause>]

dimensions[RW]

The dimensions requested. Requests can have a total of 9 dimensions. Corresponds to the JSON property `dimensions` @return [Array<Google::Apis::AnalyticsreportingV4::Dimension>]

filters_expression[RW]

Dimension or metric filters that restrict the data returned for your request. To use the `filtersExpression`, supply a dimension or metric on which to filter, followed by the filter expression. For example, the following expression selects `ga:browser` dimension which starts with Firefox; `ga: browser=~^Firefox`. For more information on dimensions and metric filters, see [Filters reference](developers.google.com/analytics/devguides/ reporting/core/v3/reference#filters). Corresponds to the JSON property `filtersExpression` @return [String]

hide_totals[RW]

If set to true, hides the total of all metrics for all the matching rows, for every date range. The default false and will return the totals. Corresponds to the JSON property `hideTotals` @return [Boolean]

hide_totals?[RW]

If set to true, hides the total of all metrics for all the matching rows, for every date range. The default false and will return the totals. Corresponds to the JSON property `hideTotals` @return [Boolean]

hide_value_ranges[RW]

If set to true, hides the minimum and maximum across all matching rows. The default is false and the value ranges are returned. Corresponds to the JSON property `hideValueRanges` @return [Boolean]

hide_value_ranges?[RW]

If set to true, hides the minimum and maximum across all matching rows. The default is false and the value ranges are returned. Corresponds to the JSON property `hideValueRanges` @return [Boolean]

include_empty_rows[RW]

If set to false, the response does not include rows if all the retrieved metrics are equal to zero. The default is false which will exclude these rows. Corresponds to the JSON property `includeEmptyRows` @return [Boolean]

include_empty_rows?[RW]

If set to false, the response does not include rows if all the retrieved metrics are equal to zero. The default is false which will exclude these rows. Corresponds to the JSON property `includeEmptyRows` @return [Boolean]

metric_filter_clauses[RW]

The metric filter clauses. They are logically combined with the `AND` operator. Metric filters look at only the first date range and not the comparing date range. Note that filtering on metrics occurs after the metrics are aggregated. Corresponds to the JSON property `metricFilterClauses` @return [Array<Google::Apis::AnalyticsreportingV4::MetricFilterClause>]

metrics[RW]

The metrics requested. Requests must specify at least one metric. Requests can have a total of 10 metrics. Corresponds to the JSON property `metrics` @return [Array<Google::Apis::AnalyticsreportingV4::Metric>]

order_bys[RW]

Sort order on output rows. To compare two rows, the elements of the following are applied in order until a difference is found. All date ranges in the output get the same row order. Corresponds to the JSON property `orderBys` @return [Array<Google::Apis::AnalyticsreportingV4::OrderBy>]

page_size[RW]

Page size is for paging and specifies the maximum number of returned rows. Page size should be >= 0. A query returns the default of 1,000 rows. The Analytics Core Reporting API returns a maximum of 100,000 rows per request, no matter how many you ask for. It can also return fewer rows than requested, if there aren't as many dimension segments as you expect. For instance, there are fewer than 300 possible values for `ga:country`, so when segmenting only by country, you can't get more than 300 rows, even if you set `pageSize` to a higher value. Corresponds to the JSON property `pageSize` @return [Fixnum]

page_token[RW]

A continuation token to get the next page of the results. Adding this to the request will return the rows after the pageToken. The pageToken should be the value returned in the nextPageToken parameter in the response to the GetReports request. Corresponds to the JSON property `pageToken` @return [String]

pivots[RW]

The pivot definitions. Requests can have a maximum of 2 pivots. Corresponds to the JSON property `pivots` @return [Array<Google::Apis::AnalyticsreportingV4::Pivot>]

sampling_level[RW]

The desired report [sample](support.google.com/analytics/answer/ 2637192) size. If the the `samplingLevel` field is unspecified the `DEFAULT` sampling level is used. Every [ReportRequest](#ReportRequest) within a ` batchGet` method must contain the same `samplingLevel` definition. See [ developer guide](/analytics/devguides/reporting/core/v4/basics#sampling) for details. Corresponds to the JSON property `samplingLevel` @return [String]

segments[RW]

Segment the data returned for the request. A segment definition helps look at a subset of the segment request. A request can contain up to four segments. Every [ReportRequest](#ReportRequest) within a `batchGet` method must contain the same `segments` definition. Requests with segments must have the `ga: segment` dimension. Corresponds to the JSON property `segments` @return [Array<Google::Apis::AnalyticsreportingV4::Segment>]

view_id[RW]

The Analytics [view ID](support.google.com/analytics/answer/1009618) from which to retrieve data. Every [ReportRequest](#ReportRequest) within a ` batchGet` method must contain the same `viewId`. Corresponds to the JSON property `viewId` @return [String]

Public Class Methods

new(**args) click to toggle source
# File lib/google/apis/analyticsreporting_v4/classes.rb, line 1406
def initialize(**args)
   update!(**args)
end

Public Instance Methods

update!(**args) click to toggle source

Update properties of this object

# File lib/google/apis/analyticsreporting_v4/classes.rb, line 1411
def update!(**args)
  @cohort_group = args[:cohort_group] if args.key?(:cohort_group)
  @date_ranges = args[:date_ranges] if args.key?(:date_ranges)
  @dimension_filter_clauses = args[:dimension_filter_clauses] if args.key?(:dimension_filter_clauses)
  @dimensions = args[:dimensions] if args.key?(:dimensions)
  @filters_expression = args[:filters_expression] if args.key?(:filters_expression)
  @hide_totals = args[:hide_totals] if args.key?(:hide_totals)
  @hide_value_ranges = args[:hide_value_ranges] if args.key?(:hide_value_ranges)
  @include_empty_rows = args[:include_empty_rows] if args.key?(:include_empty_rows)
  @metric_filter_clauses = args[:metric_filter_clauses] if args.key?(:metric_filter_clauses)
  @metrics = args[:metrics] if args.key?(:metrics)
  @order_bys = args[:order_bys] if args.key?(:order_bys)
  @page_size = args[:page_size] if args.key?(:page_size)
  @page_token = args[:page_token] if args.key?(:page_token)
  @pivots = args[:pivots] if args.key?(:pivots)
  @sampling_level = args[:sampling_level] if args.key?(:sampling_level)
  @segments = args[:segments] if args.key?(:segments)
  @view_id = args[:view_id] if args.key?(:view_id)
end