google-api-client 0.42.2 → 0.45.0

data/generated/google/apis/analyticsdata_v1alpha/service.rb

@@ -0,0 +1,220 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module AnalyticsdataV1alpha
+      # Google Analytics Data API
+      #
+      # Accesses report data in Google Analytics.
+      #
+      # @example
+      #    require 'google/apis/analyticsdata_v1alpha'
+      #
+      #    Analyticsdata = Google::Apis::AnalyticsdataV1alpha # Alias the module
+      #    service = Analyticsdata::AnalyticsDataService.new
+      #
+      # @see https://developers.google.com/analytics/trusted-testing/analytics-data/
+      class AnalyticsDataService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  Available to use for quota purposes for server-side applications. Can be any
+        #  arbitrary string assigned to a user, but should not exceed 40 characters.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://analyticsdata.googleapis.com/', '')
+          @batch_path = 'batch'
+        end
+        
+        # Returns multiple pivot reports in a batch. All reports must be for the same
+        # Entity.
+        # @param [Google::Apis::AnalyticsdataV1alpha::BatchRunPivotReportsRequest] batch_run_pivot_reports_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsdataV1alpha::BatchRunPivotReportsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsdataV1alpha::BatchRunPivotReportsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def batch_run_pivot_reports(batch_run_pivot_reports_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha:batchRunPivotReports', options)
+          command.request_representation = Google::Apis::AnalyticsdataV1alpha::BatchRunPivotReportsRequest::Representation
+          command.request_object = batch_run_pivot_reports_request_object
+          command.response_representation = Google::Apis::AnalyticsdataV1alpha::BatchRunPivotReportsResponse::Representation
+          command.response_class = Google::Apis::AnalyticsdataV1alpha::BatchRunPivotReportsResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns multiple reports in a batch. All reports must be for the same Entity.
+        # @param [Google::Apis::AnalyticsdataV1alpha::BatchRunReportsRequest] batch_run_reports_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsdataV1alpha::BatchRunReportsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsdataV1alpha::BatchRunReportsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def batch_run_reports(batch_run_reports_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha:batchRunReports', options)
+          command.request_representation = Google::Apis::AnalyticsdataV1alpha::BatchRunReportsRequest::Representation
+          command.request_object = batch_run_reports_request_object
+          command.response_representation = Google::Apis::AnalyticsdataV1alpha::BatchRunReportsResponse::Representation
+          command.response_class = Google::Apis::AnalyticsdataV1alpha::BatchRunReportsResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns metadata for dimensions and metrics available in reporting methods.
+        # Used to explore the dimensions and metrics. Dimensions and metrics will be
+        # mostly added over time, but renames and deletions may occur. This method
+        # returns Universal Metadata. Universal Metadata are dimensions and metrics
+        # applicable to any property such as `country` and `totalUsers`.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsdataV1alpha::UniversalMetadata] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsdataV1alpha::UniversalMetadata]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_universal_metadata(fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/universalMetadata', options)
+          command.response_representation = Google::Apis::AnalyticsdataV1alpha::UniversalMetadata::Representation
+          command.response_class = Google::Apis::AnalyticsdataV1alpha::UniversalMetadata
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns a customized pivot report of your Google Analytics event data. Pivot
+        # reports are more advanced and expressive formats than regular reports. In a
+        # pivot report, dimensions are only visible if they are included in a pivot.
+        # Multiple pivots can be specified to further dissect your data.
+        # @param [Google::Apis::AnalyticsdataV1alpha::RunPivotReportRequest] run_pivot_report_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsdataV1alpha::RunPivotReportResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsdataV1alpha::RunPivotReportResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def run_pivot_report(run_pivot_report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha:runPivotReport', options)
+          command.request_representation = Google::Apis::AnalyticsdataV1alpha::RunPivotReportRequest::Representation
+          command.request_object = run_pivot_report_request_object
+          command.response_representation = Google::Apis::AnalyticsdataV1alpha::RunPivotReportResponse::Representation
+          command.response_class = Google::Apis::AnalyticsdataV1alpha::RunPivotReportResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns a customized report of your Google Analytics event data. Reports
+        # contain statistics derived from data collected by the Google Analytics
+        # tracking code. The data returned from the API is as a table with columns for
+        # the requested dimensions and metrics. Metrics are individual measurements of
+        # user activity on your property, such as active users or event count.
+        # Dimensions break down metrics across some common criteria, such as country or
+        # event name.
+        # @param [Google::Apis::AnalyticsdataV1alpha::RunReportRequest] run_report_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsdataV1alpha::RunReportResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsdataV1alpha::RunReportResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def run_report(run_report_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha:runReport', options)
+          command.request_representation = Google::Apis::AnalyticsdataV1alpha::RunReportRequest::Representation
+          command.request_object = run_report_request_object
+          command.response_representation = Google::Apis::AnalyticsdataV1alpha::RunReportResponse::Representation
+          command.response_class = Google::Apis::AnalyticsdataV1alpha::RunReportResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/analyticsreporting_v4.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/analytics/devguides/reporting/core/v4/
     module AnalyticsreportingV4
       VERSION = 'V4'
-      REVISION = '20200210'
+      REVISION = '20200902'
 
       # View and manage your Google Analytics data
       AUTH_ANALYTICS = 'https://www.googleapis.com/auth/analytics'

data/generated/google/apis/analyticsreporting_v4/classes.rb

@@ -22,23 +22,21 @@ module Google
   module Apis
     module AnalyticsreportingV4
       
-      # An Activity represents data for an activity of a user. Note that an
-      # Activity is different from a hit.
-      # A hit might result in multiple Activity's. For example, if a hit
-      # includes a transaction and a goal completion, there will be two
-      # Activity protos for this hit, one for ECOMMERCE and one for GOAL.
-      # Conversely, multiple hits can also construct one Activity. In classic
-      # e-commerce, data for one transaction might be sent through multiple hits.
-      # These hits will be merged into one ECOMMERCE Activity.
+      # An Activity represents data for an activity of a user. Note that an Activity
+      # is different from a hit. A hit might result in multiple Activity's. For
+      # example, if a hit includes a transaction and a goal completion, there will be
+      # two Activity protos for this hit, one for ECOMMERCE and one for GOAL.
+      # Conversely, multiple hits can also construct one Activity. In classic e-
+      # commerce, data for one transaction might be sent through multiple hits. These
+      # hits will be merged into one ECOMMERCE Activity.
       class Activity
         include Google::Apis::Core::Hashable
       
-        # Timestamp of the activity. If activities for a visit cross midnight and
-        # occur in two separate dates, then two sessions (one per date)
-        # share the session identifier.
-        # For example, say session ID 113472 has activity within 2019-08-20, and
-        # session ID 243742 has activity within 2019-08-25 and 2019-08-26. Session ID
-        # 113472 is one session, and session ID 243742 is two sessions.
+        # Timestamp of the activity. If activities for a visit cross midnight and occur
+        # in two separate dates, then two sessions (one per date) share the session
+        # identifier. For example, say session ID 113472 has activity within 2019-08-20,
+        # and session ID 243742 has activity within 2019-08-25 and 2019-08-26. Session
+        # ID 113472 is one session, and session ID 243742 is two sessions.
         # Corresponds to the JSON property `activityTime`
         # @return [String]
         attr_accessor :activity_time
@@ -54,15 +52,15 @@ module Google
         attr_accessor :appview
       
         # For manual campaign tracking, it is the value of the utm_campaign campaign
-        # tracking parameter. For AdWords autotagging, it is the name(s) of the
-        # online ad campaign(s) you use for the property. If you use neither, its
-        # value is (not set).
+        # tracking parameter. For AdWords autotagging, it is the name(s) of the online
+        # ad campaign(s) you use for the property. If you use neither, its value is (not
+        # set).
         # Corresponds to the JSON property `campaign`
         # @return [String]
         attr_accessor :campaign
       
-        # The Channel Group associated with an end user's session for this View
-        # (defined by the View's Channel Groupings).
+        # The Channel Group associated with an end user's session for this View (defined
+        # by the View's Channel Groupings).
         # Corresponds to the JSON property `channelGrouping`
         # @return [String]
         attr_accessor :channel_grouping
@@ -94,11 +92,10 @@ module Google
       
         # For manual campaign tracking, it is the value of the utm_term campaign
         # tracking parameter. For AdWords traffic, it contains the best matching
-        # targeting criteria. For the display network, where multiple targeting
-        # criteria could have caused the ad to show up, it returns the best matching
-        # targeting criteria as selected by Ads. This could be display_keyword, site
-        # placement, boomuserlist, user_interest, age, or gender. Otherwise its value
-        # is (not set).
+        # targeting criteria. For the display network, where multiple targeting criteria
+        # could have caused the ad to show up, it returns the best matching targeting
+        # criteria as selected by Ads. This could be display_keyword, site placement,
+        # boomuserlist, user_interest, age, or gender. Otherwise its value is (not set).
         # Corresponds to the JSON property `keyword`
         # @return [String]
         attr_accessor :keyword
@@ -109,11 +106,10 @@ module Google
         attr_accessor :landing_page_path
       
         # The type of referrals. For manual campaign tracking, it is the value of the
-        # utm_medium campaign tracking parameter. For AdWords autotagging, it is cpc.
-        # If users came from a search engine detected by Google Analytics, it is
-        # organic. If the referrer is not a search engine, it is referral. If users
-        # came directly to the property and document.referrer is empty, its value is
-        # (none).
+        # utm_medium campaign tracking parameter. For AdWords autotagging, it is cpc. If
+        # users came from a search engine detected by Google Analytics, it is organic.
+        # If the referrer is not a search engine, it is referral. If users came directly
+        # to the property and document.referrer is empty, its value is (none).
         # Corresponds to the JSON property `medium`
         # @return [String]
         attr_accessor :medium
@@ -123,11 +119,11 @@ module Google
         # @return [Google::Apis::AnalyticsreportingV4::PageviewData]
         attr_accessor :pageview
       
-        # The source of referrals. For manual campaign tracking, it is the value of
-        # the utm_source campaign tracking parameter. For AdWords autotagging, it is
-        # google. If you use neither, it is the domain of the source
-        # (e.g., document.referrer) referring the users. It may also contain a port
-        # address. If users arrived without a referrer, its value is (direct).
+        # The source of referrals. For manual campaign tracking, it is the value of the
+        # utm_source campaign tracking parameter. For AdWords autotagging, it is google.
+        # If you use neither, it is the domain of the source (e.g., document.referrer)
+        # referring the users. It may also contain a port address. If users arrived
+        # without a referrer, its value is (direct).
         # Corresponds to the JSON property `source`
         # @return [String]
         attr_accessor :source
@@ -157,27 +153,27 @@ module Google
       end
       
       # Defines a cohort. A cohort is a group of users who share a common
-      # characteristic. For example, all users with the same acquisition date
-      # belong to the same cohort.
+      # characteristic. For example, all users with the same acquisition date belong
+      # to the same cohort.
       class Cohort
         include Google::Apis::Core::Hashable
       
-        # A contiguous set of days: startDate, startDate + 1 day, ..., endDate.
-        # The start and end dates are specified in
-        # [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) date format `YYYY-MM-DD`.
+        # A contiguous set of days: startDate, startDate + 1 day, ..., endDate. The
+        # start and end dates are specified in [ISO8601](https://en.wikipedia.org/wiki/
+        # ISO_8601) date format `YYYY-MM-DD`.
         # Corresponds to the JSON property `dateRange`
         # @return [Google::Apis::AnalyticsreportingV4::DateRange]
         attr_accessor :date_range
       
-        # A unique name for the cohort. If not defined name will be auto-generated
-        # with values cohort_[1234...].
+        # A unique name for the cohort. If not defined name will be auto-generated with
+        # values cohort_[1234...].
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Type of the cohort. The only supported type as of now is
-        # `FIRST_VISIT_DATE`. If this field is unspecified the cohort is treated
-        # as `FIRST_VISIT_DATE` type cohort.
+        # Type of the cohort. The only supported type as of now is `FIRST_VISIT_DATE`.
+        # If this field is unspecified the cohort is treated as `FIRST_VISIT_DATE` type
+        # cohort.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -194,19 +190,10 @@ module Google
         end
       end
       
-      # 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" `
-      # `]
-      # `
+      # 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" ` `] `
       class CohortGroup
         include Google::Apis::Core::Hashable
       
@@ -215,33 +202,24 @@ module Google
         # @return [Array<Google::Apis::AnalyticsreportingV4::Cohort>]
         attr_accessor :cohorts
       
-        # Enable Life Time Value (LTV).  LTV measures lifetime value for users
-        # acquired through different channels.
-        # Please see:
-        # [Cohort Analysis](https://support.google.com/analytics/answer/6074676) and
-        # [Lifetime Value](https://support.google.com/analytics/answer/6182550)
-        # If the value of lifetimeValue is false:
-        # - The metric values are similar to the values in the web interface cohort
-        # report.
-        # - The cohort definition date ranges must be aligned to the calendar week
-        # and month. i.e. while requesting `ga:cohortNthWeek` the `startDate` in
-        # the cohort definition should be a Sunday and the `endDate` should be the
-        # following Saturday, and for `ga:cohortNthMonth`, the `startDate`
-        # should be the 1st of the month and `endDate` should be the last day
-        # of the month.
-        # When the lifetimeValue is true:
-        # - The metric values will correspond to the values in the web interface
-        # LifeTime value report.
-        # - The Lifetime Value report shows you how user value (Revenue) and
-        # engagement (Appviews, Goal Completions, Sessions, and Session Duration)
-        # grow during the 90 days after a user is acquired.
-        # - The metrics are calculated as a cumulative average per user per the time
-        # increment.
-        # - The cohort definition date ranges need not be aligned to the calendar
-        # week and month boundaries.
-        # - The `viewId` must be an
-        # [app view
-        # ID](https://support.google.com/analytics/answer/2649553#WebVersusAppViews)
+        # Enable Life Time Value (LTV). LTV measures lifetime value for users acquired
+        # through different channels. Please see: [Cohort Analysis](https://support.
+        # google.com/analytics/answer/6074676) and [Lifetime Value](https://support.
+        # google.com/analytics/answer/6182550) If the value of lifetimeValue is false: -
+        # The metric values are similar to the values in the web interface cohort report.
+        # - The cohort definition date ranges must be aligned to the calendar week and
+        # month. i.e. while requesting `ga:cohortNthWeek` the `startDate` in the cohort
+        # definition should be a Sunday and the `endDate` should be the following
+        # Saturday, and for `ga:cohortNthMonth`, the `startDate` should be the 1st of
+        # the month and `endDate` should be the last day of the month. When the
+        # lifetimeValue is true: - The metric values will correspond to the values in
+        # the web interface LifeTime value report. - The Lifetime Value report shows you
+        # how user value (Revenue) and engagement (Appviews, Goal Completions, Sessions,
+        # and Session Duration) grow during the 90 days after a user is acquired. - The
+        # metrics are calculated as a cumulative average per user per the time increment.
+        # - The cohort definition date ranges need not be aligned to the calendar week
+        # and month boundaries. - The `viewId` must be an [app view ID](https://support.
+        # google.com/analytics/answer/2649553#WebVersusAppViews)
         # Corresponds to the JSON property `lifetimeValue`
         # @return [Boolean]
         attr_accessor :lifetime_value
@@ -309,9 +287,9 @@ module Google
         end
       end
       
-      # A contiguous set of days: startDate, startDate + 1 day, ..., endDate.
-      # The start and end dates are specified in
-      # [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) date format `YYYY-MM-DD`.
+      # A contiguous set of days: startDate, startDate + 1 day, ..., endDate. The
+      # start and end dates are specified in [ISO8601](https://en.wikipedia.org/wiki/
+      # ISO_8601) date format `YYYY-MM-DD`.
       class DateRange
         include Google::Apis::Core::Hashable
       
@@ -362,38 +340,31 @@ module Google
         end
       end
       
-      # [Dimensions](https://support.google.com/analytics/answer/1033861)
-      # are attributes of your data. For example, the dimension `ga:city`
-      # indicates the city, for example, "Paris" or "New York", from which
-      # a session originates.
+      # [Dimensions](https://support.google.com/analytics/answer/1033861) are
+      # attributes of your data. For example, the dimension `ga:city` indicates the
+      # city, for example, "Paris" or "New York", from which a session originates.
       class Dimension
         include Google::Apis::Core::Hashable
       
-        # If non-empty, we place dimension values into buckets after string to
-        # int64. Dimension values that are not the string representation of an
-        # integral value will be converted to zero.  The bucket values have to be in
-        # increasing order.  Each bucket is closed on the lower end, and open on the
-        # upper end. The "first" bucket includes all values less than the first
-        # boundary, the "last" bucket includes all values up to infinity. Dimension
-        # values that fall in a bucket get transformed to a new dimension value. For
-        # example, if one gives a list of "0, 1, 3, 4, 7", then we return the
-        # following buckets:
-        # - bucket #1: values < 0, dimension value "<0"
-        # - bucket #2: values in [0,1), dimension value "0"
-        # - bucket #3: values in [1,3), dimension value "1-2"
-        # - bucket #4: values in [3,4), dimension value "3"
-        # - bucket #5: values in [4,7), dimension value "4-6"
-        # - bucket #6: values >= 7, dimension value "7+"
-        # NOTE: If you are applying histogram mutation on any dimension, and using
-        # that dimension in sort, you will want to use the sort type
-        # `HISTOGRAM_BUCKET` for that purpose. Without that the dimension values
-        # will be sorted according to dictionary
-        # (lexicographic) order. For example the ascending dictionary order is:
-        # "<50", "1001+", "121-1000", "50-120"
-        # And the ascending `HISTOGRAM_BUCKET` order is:
-        # "<50", "50-120", "121-1000", "1001+"
-        # The client has to explicitly request `"orderType": "HISTOGRAM_BUCKET"`
-        # for a histogram-mutated dimension.
+        # If non-empty, we place dimension values into buckets after string to int64.
+        # Dimension values that are not the string representation of an integral value
+        # will be converted to zero. The bucket values have to be in increasing order.
+        # Each bucket is closed on the lower end, and open on the upper end. The "first"
+        # bucket includes all values less than the first boundary, the "last" bucket
+        # includes all values up to infinity. Dimension values that fall in a bucket get
+        # transformed to a new dimension value. For example, if one gives a list of "0,
+        # 1, 3, 4, 7", then we return the following buckets: - bucket #1: values < 0,
+        # dimension value "<0" - bucket #2: values in [0,1), dimension value "0" -
+        # bucket #3: values in [1,3), dimension value "1-2" - bucket #4: values in [3,4),
+        # dimension value "3" - bucket #5: values in [4,7), dimension value "4-6" -
+        # bucket #6: values >= 7, dimension value "7+" NOTE: If you are applying
+        # histogram mutation on any dimension, and using that dimension in sort, you
+        # will want to use the sort type `HISTOGRAM_BUCKET` for that purpose. Without
+        # that the dimension values will be sorted according to dictionary (
+        # lexicographic) order. For example the ascending dictionary order is: "<50", "
+        # 1001+", "121-1000", "50-120" And the ascending `HISTOGRAM_BUCKET` order is: "<
+        # 50", "50-120", "121-1000", "1001+" The client has to explicitly request `"
+        # orderType": "HISTOGRAM_BUCKET"` for a histogram-mutated dimension.
         # Corresponds to the JSON property `histogramBuckets`
         # @return [Array<Fixnum>]
         attr_accessor :histogram_buckets
@@ -429,10 +400,10 @@ module Google
         # @return [String]
         attr_accessor :dimension_name
       
-        # Strings or regular expression to match against. Only the first value of
-        # the list is used for comparison unless the operator is `IN_LIST`.
-        # If `IN_LIST` operator, then the entire list is used to filter the
-        # dimensions as explained in the description of the `IN_LIST` operator.
+        # Strings or regular expression to match against. Only the first value of the
+        # list is used for comparison unless the operator is `IN_LIST`. If `IN_LIST`
+        # operator, then the entire list is used to filter the dimensions as explained
+        # in the description of the `IN_LIST` operator.
         # Corresponds to the JSON property `expressions`
         # @return [Array<String>]
         attr_accessor :expressions
@@ -463,19 +434,19 @@ module Google
         end
       end
       
-      # A group of dimension filters. Set the operator value to specify how
-      # the filters are logically combined.
+      # A group of dimension filters. Set the operator value to specify how the
+      # filters are logically combined.
       class DimensionFilterClause
         include Google::Apis::Core::Hashable
       
-        # The repeated set of filters. They are logically combined based on the
-        # operator specified.
+        # The repeated set of filters. They are logically combined based on the operator
+        # specified.
         # Corresponds to the JSON property `filters`
         # @return [Array<Google::Apis::AnalyticsreportingV4::DimensionFilter>]
         attr_accessor :filters
       
-        # The operator for combining multiple dimension filters. If unspecified, it
-        # is treated as an `OR`.
+        # The operator for combining multiple dimension filters. If unspecified, it is
+        # treated as an `OR`.
         # Corresponds to the JSON property `operator`
         # @return [String]
         attr_accessor :operator
@@ -491,8 +462,8 @@ module Google
         end
       end
       
-      # Dynamic segment definition for defining the segment within the request.
-      # A segment can select users, sessions or both.
+      # Dynamic segment definition for defining the segment within the request. A
+      # segment can select users, sessions or both.
       class DynamicSegment
         include Google::Apis::Core::Hashable
       
@@ -501,14 +472,14 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # SegmentDefinition defines the segment to be a set of SegmentFilters which
-        # are combined together with a logical `AND` operation.
+        # SegmentDefinition defines the segment to be a set of SegmentFilters which are
+        # combined together with a logical `AND` operation.
         # Corresponds to the JSON property `sessionSegment`
         # @return [Google::Apis::AnalyticsreportingV4::SegmentDefinition]
         attr_accessor :session_segment
       
-        # SegmentDefinition defines the segment to be a set of SegmentFilters which
-        # are combined together with a logical `AND` operation.
+        # SegmentDefinition defines the segment to be a set of SegmentFilters which are
+        # combined together with a logical `AND` operation.
         # Corresponds to the JSON property `userSegment`
         # @return [Google::Apis::AnalyticsreportingV4::SegmentDefinition]
         attr_accessor :user_segment
@@ -610,26 +581,20 @@ module Google
       class GetReportsRequest
         include Google::Apis::Core::Hashable
       
-        # Requests, each request will have a separate response.
-        # There can be a maximum of 5 requests. All requests should have the same
-        # `dateRanges`, `viewId`, `segments`, `samplingLevel`, and `cohortGroup`.
+        # Requests, each request will have a separate response. There can be a maximum
+        # of 5 requests. All requests should have the same `dateRanges`, `viewId`, `
+        # segments`, `samplingLevel`, and `cohortGroup`.
         # Corresponds to the JSON property `reportRequests`
         # @return [Array<Google::Apis::AnalyticsreportingV4::ReportRequest>]
         attr_accessor :report_requests
       
-        # Enables
-        # [resource based
-        # quotas](/analytics/devguides/reporting/core/v4/limits-quotas#
-        # analytics_reporting_api_v4),
-        # (defaults to `False`). If this field is set to `True` the
-        # per view (profile) quotas are governed by the computational
-        # cost of the request. Note that using cost based quotas will
-        # higher enable sampling rates. (10 Million for `SMALL`,
-        # 100M for `LARGE`. See the
-        # [limits and quotas
-        # documentation](/analytics/devguides/reporting/core/v4/limits-quotas#
-        # analytics_reporting_api_v4)
-        # for details.
+        # Enables [resource based quotas](/analytics/devguides/reporting/core/v4/limits-
+        # quotas#analytics_reporting_api_v4), (defaults to `False`). If this field is
+        # set to `True` the per view (profile) quotas are governed by the computational
+        # cost of the request. Note that using cost based quotas will higher enable
+        # sampling rates. (10 Million for `SMALL`, 100M for `LARGE`. See the [limits and
+        # quotas documentation](/analytics/devguides/reporting/core/v4/limits-quotas#
+        # analytics_reporting_api_v4) for details.
         # Corresponds to the JSON property `useResourceQuotas`
         # @return [Boolean]
         attr_accessor :use_resource_quotas
@@ -646,8 +611,8 @@ module Google
         end
       end
       
-      # The main response class which holds the reports from the Reporting API
-      # `batchGet` call.
+      # The main response class which holds the reports from the Reporting API `
+      # batchGet` call.
       class GetReportsResponse
         include Google::Apis::Core::Hashable
       
@@ -760,35 +725,33 @@ module Google
         end
       end
       
-      # [Metrics](https://support.google.com/analytics/answer/1033861)
-      # are the quantitative measurements. For example, the metric `ga:users`
-      # indicates the total number of users for the requested time period.
+      # [Metrics](https://support.google.com/analytics/answer/1033861) are the
+      # quantitative measurements. For example, the metric `ga:users` indicates the
+      # total number of users for the requested time period.
       class Metric
         include Google::Apis::Core::Hashable
       
-        # An alias for the metric expression is an alternate name for the
-        # expression. The alias can be used for filtering and sorting. This field
-        # is optional and is useful if the expression is not a single metric but
-        # a complex expression which cannot be used in filtering and sorting.
-        # The alias is also used in the response column header.
+        # An alias for the metric expression is an alternate name for the expression.
+        # The alias can be used for filtering and sorting. This field is optional and is
+        # useful if the expression is not a single metric but a complex expression which
+        # cannot be used in filtering and sorting. The alias is also used in the
+        # response column header.
         # Corresponds to the JSON property `alias`
         # @return [String]
         attr_accessor :alias
       
-        # A metric expression in the request. An expression is constructed from one
-        # or more metrics and numbers. Accepted operators include: Plus (+), Minus
-        # (-), Negation (Unary -), Divided by (/), Multiplied by (*), Parenthesis,
-        # Positive cardinal numbers (0-9), can include decimals and is limited to
-        # 1024 characters. Example `ga:totalRefunds/ga:users`, in most cases the
-        # metric expression is just a single metric name like `ga:users`.
-        # Adding mixed `MetricType` (E.g., `CURRENCY` + `PERCENTAGE`) metrics
-        # will result in unexpected results.
+        # A metric expression in the request. An expression is constructed from one or
+        # more metrics and numbers. Accepted operators include: Plus (+), Minus (-),
+        # Negation (Unary -), Divided by (/), Multiplied by (*), Parenthesis, Positive
+        # cardinal numbers (0-9), can include decimals and is limited to 1024 characters.
+        # Example `ga:totalRefunds/ga:users`, in most cases the metric expression is
+        # just a single metric name like `ga:users`. Adding mixed `MetricType` (E.g., `
+        # CURRENCY` + `PERCENTAGE`) metrics will result in unexpected results.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Specifies how the metric expression should be formatted, for example
-        # `INTEGER`.
+        # Specifies how the metric expression should be formatted, for example `INTEGER`.
         # Corresponds to the JSON property `formattingType`
         # @return [String]
         attr_accessor :formatting_type
@@ -814,9 +777,9 @@ module Google
         # @return [String]
         attr_accessor :comparison_value
       
-        # The metric that will be filtered on. A metricFilter must contain a metric
-        # name. A metric name can be an alias earlier defined as a metric or it can
-        # also be a metric expression.
+        # The metric that will be filtered on. A metricFilter must contain a metric name.
+        # A metric name can be an alias earlier defined as a metric or it can also be a
+        # metric expression.
         # Corresponds to the JSON property `metricName`
         # @return [String]
         attr_accessor :metric_name
@@ -828,10 +791,9 @@ module Google
         attr_accessor :not
         alias_method :not?, :not
       
-        # Is the metric `EQUAL`, `LESS_THAN` or `GREATER_THAN` the
-        # comparisonValue, the default is `EQUAL`. If the operator is
-        # `IS_MISSING`, checks if the metric is missing and would ignore the
-        # comparisonValue.
+        # Is the metric `EQUAL`, `LESS_THAN` or `GREATER_THAN` the comparisonValue, the
+        # default is `EQUAL`. If the operator is `IS_MISSING`, checks if the metric is
+        # missing and would ignore the comparisonValue.
         # Corresponds to the JSON property `operator`
         # @return [String]
         attr_accessor :operator
@@ -849,13 +811,13 @@ module Google
         end
       end
       
-      # Represents a group of metric filters.
-      # Set the operator value to specify how the filters are logically combined.
+      # Represents a group of metric filters. Set the operator value to specify how
+      # the filters are logically combined.
       class MetricFilterClause
         include Google::Apis::Core::Hashable
       
-        # The repeated set of filters. They are logically combined based on the
-        # operator specified.
+        # The repeated set of filters. They are logically combined based on the operator
+        # specified.
         # Corresponds to the JSON property `filters`
         # @return [Array<Google::Apis::AnalyticsreportingV4::MetricFilter>]
         attr_accessor :filters
@@ -951,9 +913,8 @@ module Google
       class OrderBy
         include Google::Apis::Core::Hashable
       
-        # The field which to sort by. The default sort order is ascending. Example:
-        # `ga:browser`.
-        # Note, that you can only specify one field for sort here. For example,
+        # The field which to sort by. The default sort order is ascending. Example: `ga:
+        # browser`. Note, that you can only specify one field for sort here. For example,
         # `ga:browser, ga:city` is not valid.
         # Corresponds to the JSON property `fieldName`
         # @return [String]
@@ -1006,54 +967,52 @@ module Google
         end
       end
       
-      # The Pivot describes the pivot section in the request.
-      # The Pivot helps rearrange the information in the table for certain reports
-      # by pivoting your data on a second dimension.
+      # The Pivot describes the pivot section in the request. The Pivot helps
+      # rearrange the information in the table for certain reports by pivoting your
+      # data on a second dimension.
       class Pivot
         include Google::Apis::Core::Hashable
       
         # DimensionFilterClauses are logically combined with an `AND` operator: only
-        # data that is included by all these DimensionFilterClauses contributes to
-        # the values in this pivot region. Dimension filters can be used to restrict
-        # the columns shown in the pivot region. For example if you have
-        # `ga:browser` as the requested dimension in the pivot region, and you
-        # specify key filters to restrict `ga:browser` to only "IE" or "Firefox",
-        # then only those two browsers would show up as columns.
+        # data that is included by all these DimensionFilterClauses contributes to the
+        # values in this pivot region. Dimension filters can be used to restrict the
+        # columns shown in the pivot region. For example if you have `ga:browser` as the
+        # requested dimension in the pivot region, and you specify key filters to
+        # restrict `ga:browser` to only "IE" or "Firefox", then only those two browsers
+        # would show up as columns.
         # Corresponds to the JSON property `dimensionFilterClauses`
         # @return [Array<Google::Apis::AnalyticsreportingV4::DimensionFilterClause>]
         attr_accessor :dimension_filter_clauses
       
-        # A list of dimensions to show as pivot columns. A Pivot can have a maximum
-        # of 4 dimensions. Pivot dimensions are part of the restriction on the
-        # total number of dimensions allowed in the request.
+        # A list of dimensions to show as pivot columns. A Pivot can have a maximum of 4
+        # dimensions. Pivot dimensions are part of the restriction on the total number
+        # of dimensions allowed in the request.
         # Corresponds to the JSON property `dimensions`
         # @return [Array<Google::Apis::AnalyticsreportingV4::Dimension>]
         attr_accessor :dimensions
       
-        # Specifies the maximum number of groups to return.
-        # The default value is 10, also the maximum value is 1,000.
+        # Specifies the maximum number of groups to return. The default value is 10,
+        # also the maximum value is 1,000.
         # Corresponds to the JSON property `maxGroupCount`
         # @return [Fixnum]
         attr_accessor :max_group_count
       
-        # The pivot metrics. Pivot metrics are part of the
-        # restriction on total number of metrics allowed in the request.
+        # The pivot metrics. Pivot metrics are part of the restriction on total number
+        # of metrics allowed in the request.
         # Corresponds to the JSON property `metrics`
         # @return [Array<Google::Apis::AnalyticsreportingV4::Metric>]
         attr_accessor :metrics
       
-        # If k metrics were requested, then the response will contain some
-        # data-dependent multiple of k columns in the report.  E.g., if you pivoted
-        # on the dimension `ga:browser` then you'd get k columns for "Firefox", k
-        # columns for "IE", k columns for "Chrome", etc. The ordering of the groups
-        # of columns is determined by descending order of "total" for the first of
-        # the k values.  Ties are broken by lexicographic ordering of the first
-        # pivot dimension, then lexicographic ordering of the second pivot
-        # dimension, and so on.  E.g., if the totals for the first value for
-        # Firefox, IE, and Chrome were 8, 2, 8, respectively, the order of columns
-        # would be Chrome, Firefox, IE.
-        # The following let you choose which of the groups of k columns are
-        # included in the response.
+        # If k metrics were requested, then the response will contain some data-
+        # dependent multiple of k columns in the report. E.g., if you pivoted on the
+        # dimension `ga:browser` then you'd get k columns for "Firefox", k columns for "
+        # IE", k columns for "Chrome", etc. The ordering of the groups of columns is
+        # determined by descending order of "total" for the first of the k values. Ties
+        # are broken by lexicographic ordering of the first pivot dimension, then
+        # lexicographic ordering of the second pivot dimension, and so on. E.g., if the
+        # totals for the first value for Firefox, IE, and Chrome were 8, 2, 8,
+        # respectively, the order of columns would be Chrome, Firefox, IE. The following
+        # let you choose which of the groups of k columns are included in the response.
         # Corresponds to the JSON property `startGroup`
         # @return [Fixnum]
         attr_accessor :start_group
@@ -1157,8 +1116,8 @@ module Google
         # @return [Float]
         attr_accessor :item_revenue
       
-        # The product name, supplied by the e-commerce tracking application, for
-        # the purchased items.
+        # The product name, supplied by the e-commerce tracking application, for the
+        # purchased items.
         # Corresponds to the JSON property `productName`
         # @return [String]
         attr_accessor :product_name
@@ -1227,24 +1186,22 @@ module Google
         # @return [String]
         attr_accessor :data_last_refreshed
       
-        # Indicates if response to this request is golden or not. Data is
-        # golden when the exact same request will not produce any new results if
-        # asked at a later point in time.
+        # Indicates if response to this request is golden or not. Data is golden when
+        # the exact same request will not produce any new results if asked at a later
+        # point in time.
         # Corresponds to the JSON property `isDataGolden`
         # @return [Boolean]
         attr_accessor :is_data_golden
         alias_method :is_data_golden?, :is_data_golden
       
-        # Minimum and maximum values seen over all matching rows. These are both
-        # empty when `hideValueRanges` in the request is false, or when
-        # rowCount is zero.
+        # Minimum and maximum values seen over all matching rows. These are both empty
+        # when `hideValueRanges` in the request is false, or when rowCount is zero.
         # Corresponds to the JSON property `maximums`
         # @return [Array<Google::Apis::AnalyticsreportingV4::DateRangeValues>]
         attr_accessor :maximums
       
-        # Minimum and maximum values seen over all matching rows. These are both
-        # empty when `hideValueRanges` in the request is false, or when
-        # rowCount is zero.
+        # Minimum and maximum values seen over all matching rows. These are both empty
+        # when `hideValueRanges` in the request is false, or when rowCount is zero.
         # Corresponds to the JSON property `minimums`
         # @return [Array<Google::Apis::AnalyticsreportingV4::DateRangeValues>]
         attr_accessor :minimums
@@ -1259,34 +1216,29 @@ module Google
         # @return [Array<Google::Apis::AnalyticsreportingV4::ReportRow>]
         attr_accessor :rows
       
-        # If the results are
-        # [sampled](https://support.google.com/analytics/answer/2637192),
-        # this returns the total number of samples read, one entry per date range.
-        # If the results are not sampled this field will not be defined. See
-        # [developer guide](/analytics/devguides/reporting/core/v4/basics#sampling)
-        # for details.
+        # If the results are [sampled](https://support.google.com/analytics/answer/
+        # 2637192), this returns the total number of samples read, one entry per date
+        # range. If the results are not sampled this field will not be defined. See [
+        # developer guide](/analytics/devguides/reporting/core/v4/basics#sampling) for
+        # details.
         # Corresponds to the JSON property `samplesReadCounts`
         # @return [Array<Fixnum>]
         attr_accessor :samples_read_counts
       
-        # If the results are
-        # [sampled](https://support.google.com/analytics/answer/2637192),
-        # this returns the total number of
-        # samples present, one entry per date range. If the results are not sampled
-        # this field will not be defined. See
-        # [developer guide](/analytics/devguides/reporting/core/v4/basics#sampling)
-        # for details.
+        # If the results are [sampled](https://support.google.com/analytics/answer/
+        # 2637192), this returns the total number of samples present, one entry per date
+        # range. If the results are not sampled this field will not be defined. See [
+        # developer guide](/analytics/devguides/reporting/core/v4/basics#sampling) for
+        # details.
         # Corresponds to the JSON property `samplingSpaceSizes`
         # @return [Array<Fixnum>]
         attr_accessor :sampling_space_sizes
       
-        # For each requested date range, for the set of all rows that match
-        # the query, every requested value format gets a total. The total
-        # for a value format is computed by first totaling the metrics
-        # mentioned in the value format and then evaluating the value
-        # format as a scalar expression.  E.g., The "totals" for
-        # `3 / (ga:sessions + 2)` we compute
-        # `3 / ((sum of all relevant ga:sessions) + 2)`.
+        # For each requested date range, for the set of all rows that match the query,
+        # every requested value format gets a total. The total for a value format is
+        # computed by first totaling the metrics mentioned in the value format and then
+        # evaluating the value format as a scalar expression. E.g., The "totals" for `3 /
+        # (ga:sessions + 2)` we compute `3 / ((sum of all relevant ga:sessions) + 2)`.
         # Totals are computed before pagination.
         # Corresponds to the JSON property `totals`
         # @return [Array<Google::Apis::AnalyticsreportingV4::DateRangeValues>]
@@ -1314,125 +1266,108 @@ module Google
       class ReportRequest
         include Google::Apis::Core::Hashable
       
-        # 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" `
-        # `]
-        # `
+        # 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]
         attr_accessor :cohort_group
       
-        # 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.
+        # 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>]
         attr_accessor :date_ranges
       
         # 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.
+        # 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>]
         attr_accessor :dimension_filter_clauses
       
-        # The dimensions requested.
-        # Requests can have a total of 9 dimensions.
+        # The dimensions requested. Requests can have a total of 9 dimensions.
         # Corresponds to the JSON property `dimensions`
         # @return [Array<Google::Apis::AnalyticsreportingV4::Dimension>]
         attr_accessor :dimensions
       
-        # 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](https://developers.google.com/analytics/devguides/reporting/core/v3/
-        # reference#filters).
+        # 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](https://developers.google.com/analytics/devguides/
+        # reporting/core/v3/reference#filters).
         # Corresponds to the JSON property `filtersExpression`
         # @return [String]
         attr_accessor :filters_expression
       
-        # 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.
+        # 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]
         attr_accessor :hide_totals
         alias_method :hide_totals?, :hide_totals
       
-        # If set to true, hides the minimum and maximum across all matching rows.
-        # The default is false and the value ranges are returned.
+        # 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]
         attr_accessor :hide_value_ranges
         alias_method :hide_value_ranges?, :hide_value_ranges
       
         # 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.
+        # metrics are equal to zero. The default is false which will exclude these rows.
         # Corresponds to the JSON property `includeEmptyRows`
         # @return [Boolean]
         attr_accessor :include_empty_rows
         alias_method :include_empty_rows?, :include_empty_rows
       
-        # 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.
+        # 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>]
         attr_accessor :metric_filter_clauses
       
-        # The metrics requested.
-        # Requests must specify at least one metric. Requests can have a
-        # total of 10 metrics.
+        # 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>]
         attr_accessor :metrics
       
-        # 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.
+        # 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>]
         attr_accessor :order_bys
       
         # 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.
+        # 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]
         attr_accessor :page_size
       
-        # 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.
+        # 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]
         attr_accessor :page_token
@@ -1442,30 +1377,28 @@ module Google
         # @return [Array<Google::Apis::AnalyticsreportingV4::Pivot>]
         attr_accessor :pivots
       
-        # The desired report
-        # [sample](https://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.
+        # The desired report [sample](https://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]
         attr_accessor :sampling_level
       
-        # 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.
+        # 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>]
         attr_accessor :segments
       
-        # The Analytics
-        # [view ID](https://support.google.com/analytics/answer/1009618)
-        # from which to retrieve data. Every [ReportRequest](#ReportRequest)
-        # within a `batchGet` method must contain the same `viewId`.
+        # The Analytics [view ID](https://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]
         attr_accessor :view_id
@@ -1588,16 +1521,15 @@ module Google
       class SearchUserActivityRequest
         include Google::Apis::Core::Hashable
       
-        # Set of all activity types being requested. Only acvities matching these
-        # types will be returned in the response. If empty, all activies will be
-        # returned.
+        # Set of all activity types being requested. Only acvities matching these types
+        # will be returned in the response. If empty, all activies will be returned.
         # Corresponds to the JSON property `activityTypes`
         # @return [Array<String>]
         attr_accessor :activity_types
       
-        # A contiguous set of days: startDate, startDate + 1 day, ..., endDate.
-        # The start and end dates are specified in
-        # [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) date format `YYYY-MM-DD`.
+        # A contiguous set of days: startDate, startDate + 1 day, ..., endDate. The
+        # start and end dates are specified in [ISO8601](https://en.wikipedia.org/wiki/
+        # ISO_8601) date format `YYYY-MM-DD`.
         # Corresponds to the JSON property `dateRange`
         # @return [Google::Apis::AnalyticsreportingV4::DateRange]
         attr_accessor :date_range
@@ -1609,10 +1541,10 @@ module Google
         # @return [Fixnum]
         attr_accessor :page_size
       
-        # 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 [SearchUserActivityRequest](#SearchUserActivityRequest) request.
+        # 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 [
+        # SearchUserActivityRequest](#SearchUserActivityRequest) request.
         # Corresponds to the JSON property `pageToken`
         # @return [String]
         attr_accessor :page_token
@@ -1622,11 +1554,9 @@ module Google
         # @return [Google::Apis::AnalyticsreportingV4::User]
         attr_accessor :user
       
-        # Required. The Analytics
-        # [view ID](https://support.google.com/analytics/answer/1009618)
-        # from which to retrieve data. Every
-        # [SearchUserActivityRequest](#SearchUserActivityRequest) must contain the
-        # `viewId`.
+        # Required. The Analytics [view ID](https://support.google.com/analytics/answer/
+        # 1009618) from which to retrieve data. Every [SearchUserActivityRequest](#
+        # SearchUserActivityRequest) must contain the `viewId`.
         # Corresponds to the JSON property `viewId`
         # @return [String]
         attr_accessor :view_id
@@ -1650,18 +1580,16 @@ module Google
       class SearchUserActivityResponse
         include Google::Apis::Core::Hashable
       
-        # This token should be passed to
-        # [SearchUserActivityRequest](#SearchUserActivityRequest) to retrieve the
-        # next page.
+        # This token should be passed to [SearchUserActivityRequest](#
+        # SearchUserActivityRequest) to retrieve the next page.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # This field represents the
-        # [sampling rate](https://support.google.com/analytics/answer/2637192) for
-        # the given request and is a number between 0.0 to 1.0. See
-        # [developer guide](/analytics/devguides/reporting/core/v4/basics#sampling)
-        # for details.
+        # This field represents the [sampling rate](https://support.google.com/analytics/
+        # answer/2637192) for the given request and is a number between 0.0 to 1.0. See [
+        # developer guide](/analytics/devguides/reporting/core/v4/basics#sampling) for
+        # details.
         # Corresponds to the JSON property `sampleRate`
         # @return [Float]
         attr_accessor :sample_rate
@@ -1689,14 +1617,14 @@ module Google
         end
       end
       
-      # The segment definition, if the report needs to be segmented.
-      # A Segment is a subset of the Analytics data. For example, of the entire
-      # set of users, one Segment might be users from a particular country or city.
+      # The segment definition, if the report needs to be segmented. A Segment is a
+      # subset of the Analytics data. For example, of the entire set of users, one
+      # Segment might be users from a particular country or city.
       class Segment
         include Google::Apis::Core::Hashable
       
-        # Dynamic segment definition for defining the segment within the request.
-        # A segment can select users, sessions or both.
+        # Dynamic segment definition for defining the segment within the request. A
+        # segment can select users, sessions or both.
         # Corresponds to the JSON property `dynamicSegment`
         # @return [Google::Apis::AnalyticsreportingV4::DynamicSegment]
         attr_accessor :dynamic_segment
@@ -1717,13 +1645,13 @@ module Google
         end
       end
       
-      # SegmentDefinition defines the segment to be a set of SegmentFilters which
-      # are combined together with a logical `AND` operation.
+      # SegmentDefinition defines the segment to be a set of SegmentFilters which are
+      # combined together with a logical `AND` operation.
       class SegmentDefinition
         include Google::Apis::Core::Hashable
       
-        # A segment is defined by a set of segment filters which are combined
-        # together with a logical `AND` operation.
+        # A segment is defined by a set of segment filters which are combined together
+        # with a logical `AND` operation.
         # Corresponds to the JSON property `segmentFilters`
         # @return [Array<Google::Apis::AnalyticsreportingV4::SegmentFilter>]
         attr_accessor :segment_filters
@@ -1788,31 +1716,19 @@ module Google
         end
       end
       
-      # SegmentFilter defines the segment to be either a simple or a sequence
-      # segment. A simple segment condition contains dimension and metric conditions
-      # to select the sessions or users. A sequence segment condition can be used to
-      # select users or sessions based on sequential conditions.
+      # SegmentFilter defines the segment to be either a simple or a sequence segment.
+      # A simple segment condition contains dimension and metric conditions to select
+      # the sessions or users. A sequence segment condition can be used to select
+      # users or sessions based on sequential conditions.
       class SegmentFilter
         include Google::Apis::Core::Hashable
       
-        # If true, match the complement of simple or sequence segment.
-        # For example, to match all visits not from "New York", we can define the
-        # segment as follows:
-        # "sessionSegment": `
-        # "segmentFilters": [`
-        # "simpleSegment" :`
-        # "orFiltersForSegment": [`
-        # "segmentFilterClauses":[`
-        # "dimensionFilter": `
-        # "dimensionName": "ga:city",
-        # "expressions": ["New York"]
-        # `
-        # `]
-        # `]
-        # `,
-        # "not": "True"
-        # `]
-        # `,
+        # If true, match the complement of simple or sequence segment. For example, to
+        # match all visits not from "New York", we can define the segment as follows: "
+        # sessionSegment": ` "segmentFilters": [` "simpleSegment" :` "
+        # orFiltersForSegment": [` "segmentFilterClauses":[` "dimensionFilter": ` "
+        # dimensionName": "ga:city", "expressions": ["New York"] ` `] `] `, "not": "True"
+        # `] `,
         # Corresponds to the JSON property `not`
         # @return [Boolean]
         attr_accessor :not
@@ -1825,8 +1741,8 @@ module Google
         # @return [Google::Apis::AnalyticsreportingV4::SequenceSegment]
         attr_accessor :sequence_segment
       
-        # A Simple segment conditions consist of one or more dimension/metric
-        # conditions that can be combined.
+        # A Simple segment conditions consist of one or more dimension/metric conditions
+        # that can be combined.
         # Corresponds to the JSON property `simpleSegment`
         # @return [Google::Apis::AnalyticsreportingV4::SimpleSegment]
         attr_accessor :simple_segment
@@ -1843,8 +1759,8 @@ module Google
         end
       end
       
-      # Filter Clause to be used in a segment definition, can be wither a metric or
-      # a dimension filter.
+      # Filter Clause to be used in a segment definition, can be wither a metric or a
+      # dimension filter.
       class SegmentFilterClause
         include Google::Apis::Core::Hashable
       
@@ -1891,22 +1807,22 @@ module Google
         # @return [String]
         attr_accessor :max_comparison_value
       
-        # The metric that will be filtered on. A `metricFilter` must contain a
-        # metric name.
+        # The metric that will be filtered on. A `metricFilter` must contain a metric
+        # name.
         # Corresponds to the JSON property `metricName`
         # @return [String]
         attr_accessor :metric_name
       
-        # Specifies is the operation to perform to compare the metric. The default
-        # is `EQUAL`.
+        # Specifies is the operation to perform to compare the metric. The default is `
+        # EQUAL`.
         # Corresponds to the JSON property `operator`
         # @return [String]
         attr_accessor :operator
       
-        # Scope for a metric defines the level at which that metric is defined.  The
-        # specified metric scope must be equal to or greater than its primary scope
-        # as defined in the data model. The primary scope is defined by if the
-        # segment is selecting users or sessions.
+        # Scope for a metric defines the level at which that metric is defined. The
+        # specified metric scope must be equal to or greater than its primary scope as
+        # defined in the data model. The primary scope is defined by if the segment is
+        # selecting users or sessions.
         # Corresponds to the JSON property `scope`
         # @return [String]
         attr_accessor :scope
@@ -1929,14 +1845,14 @@ module Google
       class SegmentSequenceStep
         include Google::Apis::Core::Hashable
       
-        # Specifies if the step immediately precedes or can be any time before the
-        # next step.
+        # Specifies if the step immediately precedes or can be any time before the next
+        # step.
         # Corresponds to the JSON property `matchType`
         # @return [String]
         attr_accessor :match_type
       
-        # A sequence is specified with a list of Or grouped filters which are
-        # combined with `AND` operator.
+        # A sequence is specified with a list of Or grouped filters which are combined
+        # with `AND` operator.
         # Corresponds to the JSON property `orFiltersForSegment`
         # @return [Array<Google::Apis::AnalyticsreportingV4::OrFiltersForSegment>]
         attr_accessor :or_filters_for_segment
@@ -1958,8 +1874,8 @@ module Google
       class SequenceSegment
         include Google::Apis::Core::Hashable
       
-        # If set, first step condition must match the first hit of the visitor (in
-        # the date range).
+        # If set, first step condition must match the first hit of the visitor (in the
+        # date range).
         # Corresponds to the JSON property `firstStepShouldMatchFirstHit`
         # @return [Boolean]
         attr_accessor :first_step_should_match_first_hit
@@ -1981,8 +1897,8 @@ module Google
         end
       end
       
-      # A Simple segment conditions consist of one or more dimension/metric
-      # conditions that can be combined.
+      # A Simple segment conditions consist of one or more dimension/metric conditions
+      # that can be combined.
       class SimpleSegment
         include Google::Apis::Core::Hashable
       
@@ -2077,9 +1993,9 @@ module Google
         # @return [Array<Google::Apis::AnalyticsreportingV4::Activity>]
         attr_accessor :activities
       
-        # The data source of a hit. By default, hits sent from analytics.js are
-        # reported as "web" and hits sent from the mobile SDKs are reported as "app".
-        # These values can be overridden in the Measurement Protocol.
+        # The data source of a hit. By default, hits sent from analytics.js are reported
+        # as "web" and hits sent from the mobile SDKs are reported as "app". These
+        # values can be overridden in the Measurement Protocol.
         # Corresponds to the JSON property `dataSource`
         # @return [String]
         attr_accessor :data_source