google-api-client 0.9.8 → 0.9.20

data/generated/google/apis/analytics_v3/representations.rb

@@ -376,6 +376,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class IncludeConditions
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class LinkedForeignAccount
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class McfData
         class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -490,6 +502,36 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RemarketingAudience
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+        class AudienceDefinition
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+        
+        class StateBasedAudienceDefinition
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+          class ExcludeConditions
+            class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+            include Google::Apis::Core::JsonObjectSupport
+          end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RemarketingAudiences
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Segment
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1159,6 +1201,7 @@ module Google
           collection :column_headers, as: 'columnHeaders', class: Google::Apis::AnalyticsV3::GaData::ColumnHeader, decorator: Google::Apis::AnalyticsV3::GaData::ColumnHeader::Representation
       
           property :contains_sampled_data, as: 'containsSampledData'
+          property :data_last_refreshed, as: 'dataLastRefreshed'
           property :data_table, as: 'dataTable', class: Google::Apis::AnalyticsV3::GaData::DataTable, decorator: Google::Apis::AnalyticsV3::GaData::DataTable::Representation
       
           property :id, as: 'id'
@@ -1366,6 +1409,33 @@ module Google
         end
       end
       
+      class IncludeConditions
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :days_to_look_back, as: 'daysToLookBack'
+          property :is_smart_list, as: 'isSmartList'
+          property :kind, as: 'kind'
+          property :membership_duration_days, as: 'membershipDurationDays'
+          property :segment, as: 'segment'
+        end
+      end
+      
+      class LinkedForeignAccount
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :account_id, as: 'accountId'
+          property :eligible_for_search, as: 'eligibleForSearch'
+          property :id, as: 'id'
+          property :internal_web_property_id, as: 'internalWebPropertyId'
+          property :kind, as: 'kind'
+          property :linked_account_id, as: 'linkedAccountId'
+          property :remarketing_audience_id, as: 'remarketingAudienceId'
+          property :status, as: 'status'
+          property :type, as: 'type'
+          property :web_property_id, as: 'webPropertyId'
+        end
+      end
+      
       class McfData
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1633,6 +1703,72 @@ module Google
         end
       end
       
+      class RemarketingAudience
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :account_id, as: 'accountId'
+          property :audience_definition, as: 'audienceDefinition', class: Google::Apis::AnalyticsV3::RemarketingAudience::AudienceDefinition, decorator: Google::Apis::AnalyticsV3::RemarketingAudience::AudienceDefinition::Representation
+      
+          property :audience_type, as: 'audienceType'
+          property :created, as: 'created', type: DateTime
+      
+          property :description, as: 'description'
+          property :id, as: 'id'
+          property :internal_web_property_id, as: 'internalWebPropertyId'
+          property :kind, as: 'kind'
+          collection :linked_ad_accounts, as: 'linkedAdAccounts', class: Google::Apis::AnalyticsV3::LinkedForeignAccount, decorator: Google::Apis::AnalyticsV3::LinkedForeignAccount::Representation
+      
+          collection :linked_views, as: 'linkedViews'
+          property :name, as: 'name'
+          property :state_based_audience_definition, as: 'stateBasedAudienceDefinition', class: Google::Apis::AnalyticsV3::RemarketingAudience::StateBasedAudienceDefinition, decorator: Google::Apis::AnalyticsV3::RemarketingAudience::StateBasedAudienceDefinition::Representation
+      
+          property :updated, as: 'updated', type: DateTime
+      
+          property :web_property_id, as: 'webPropertyId'
+        end
+        
+        class AudienceDefinition
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :include_conditions, as: 'includeConditions', class: Google::Apis::AnalyticsV3::IncludeConditions, decorator: Google::Apis::AnalyticsV3::IncludeConditions::Representation
+        
+          end
+        end
+        
+        class StateBasedAudienceDefinition
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :exclude_conditions, as: 'excludeConditions', class: Google::Apis::AnalyticsV3::RemarketingAudience::StateBasedAudienceDefinition::ExcludeConditions, decorator: Google::Apis::AnalyticsV3::RemarketingAudience::StateBasedAudienceDefinition::ExcludeConditions::Representation
+        
+            property :include_conditions, as: 'includeConditions', class: Google::Apis::AnalyticsV3::IncludeConditions, decorator: Google::Apis::AnalyticsV3::IncludeConditions::Representation
+        
+          end
+          
+          class ExcludeConditions
+            # @private
+            class Representation < Google::Apis::Core::JsonRepresentation
+              property :exclusion_duration, as: 'exclusionDuration'
+              property :segment, as: 'segment'
+            end
+          end
+        end
+      end
+      
+      class RemarketingAudiences
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :items, as: 'items', class: Google::Apis::AnalyticsV3::RemarketingAudience, decorator: Google::Apis::AnalyticsV3::RemarketingAudience::Representation
+      
+          property :items_per_page, as: 'itemsPerPage'
+          property :kind, as: 'kind'
+          property :next_link, as: 'nextLink'
+          property :previous_link, as: 'previousLink'
+          property :start_index, as: 'startIndex'
+          property :total_results, as: 'totalResults'
+          property :username, as: 'username'
+        end
+      end
+      
       class Segment
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -2450,6 +2450,223 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets a remarketing audience to which the user has access.
+        # @param [String] account_id
+        #   The account ID of the remarketing audience to retrieve.
+        # @param [String] web_property_id
+        #   The web property ID of the remarketing audience to retrieve.
+        # @param [String] remarketing_audience_id
+        #   The ID of the remarketing audience to retrieve.
+        # @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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsV3::RemarketingAudience] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsV3::RemarketingAudience]
+        #
+        # @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_management_remarketing_audience(account_id, web_property_id, remarketing_audience_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'management/accounts/{accountId}/webproperties/{webPropertyId}/remarketingAudiences/{remarketingAudienceId}', options)
+          command.response_representation = Google::Apis::AnalyticsV3::RemarketingAudience::Representation
+          command.response_class = Google::Apis::AnalyticsV3::RemarketingAudience
+          command.params['accountId'] = account_id unless account_id.nil?
+          command.params['webPropertyId'] = web_property_id unless web_property_id.nil?
+          command.params['remarketingAudienceId'] = remarketing_audience_id unless remarketing_audience_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Creates a new remarketing audience.
+        # @param [String] account_id
+        #   The account ID for which to create the remarketing audience.
+        # @param [String] web_property_id
+        #   Web property ID for which to create the remarketing audience.
+        # @param [Google::Apis::AnalyticsV3::RemarketingAudience] remarketing_audience_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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsV3::RemarketingAudience] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsV3::RemarketingAudience]
+        #
+        # @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 insert_management_remarketing_audience(account_id, web_property_id, remarketing_audience_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'management/accounts/{accountId}/webproperties/{webPropertyId}/remarketingAudiences', options)
+          command.request_representation = Google::Apis::AnalyticsV3::RemarketingAudience::Representation
+          command.request_object = remarketing_audience_object
+          command.response_representation = Google::Apis::AnalyticsV3::RemarketingAudience::Representation
+          command.response_class = Google::Apis::AnalyticsV3::RemarketingAudience
+          command.params['accountId'] = account_id unless account_id.nil?
+          command.params['webPropertyId'] = web_property_id unless web_property_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists remarketing audiences to which the user has access.
+        # @param [String] account_id
+        #   The account ID of the remarketing audiences to retrieve.
+        # @param [String] web_property_id
+        #   The web property ID of the remarketing audiences to retrieve.
+        # @param [Fixnum] max_results
+        #   The maximum number of remarketing audiences to include in this response.
+        # @param [Fixnum] start_index
+        #   An index of the first entity to retrieve. Use this parameter as a pagination
+        #   mechanism along with the max-results parameter.
+        # @param [String] type
+        # @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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsV3::RemarketingAudiences] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsV3::RemarketingAudiences]
+        #
+        # @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 list_management_remarketing_audiences(account_id, web_property_id, max_results: nil, start_index: nil, type: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'management/accounts/{accountId}/webproperties/{webPropertyId}/remarketingAudiences', options)
+          command.response_representation = Google::Apis::AnalyticsV3::RemarketingAudiences::Representation
+          command.response_class = Google::Apis::AnalyticsV3::RemarketingAudiences
+          command.params['accountId'] = account_id unless account_id.nil?
+          command.params['webPropertyId'] = web_property_id unless web_property_id.nil?
+          command.query['max-results'] = max_results unless max_results.nil?
+          command.query['start-index'] = start_index unless start_index.nil?
+          command.query['type'] = type unless type.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates an existing remarketing audience. This method supports patch semantics.
+        # @param [String] account_id
+        #   The account ID of the remarketing audience to update.
+        # @param [String] web_property_id
+        #   The web property ID of the remarketing audience to update.
+        # @param [String] remarketing_audience_id
+        #   The ID of the remarketing audience to update.
+        # @param [Google::Apis::AnalyticsV3::RemarketingAudience] remarketing_audience_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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsV3::RemarketingAudience] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsV3::RemarketingAudience]
+        #
+        # @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 patch_management_remarketing_audience(account_id, web_property_id, remarketing_audience_id, remarketing_audience_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:patch, 'management/accounts/{accountId}/webproperties/{webPropertyId}/remarketingAudiences/{remarketingAudienceId}', options)
+          command.request_representation = Google::Apis::AnalyticsV3::RemarketingAudience::Representation
+          command.request_object = remarketing_audience_object
+          command.response_representation = Google::Apis::AnalyticsV3::RemarketingAudience::Representation
+          command.response_class = Google::Apis::AnalyticsV3::RemarketingAudience
+          command.params['accountId'] = account_id unless account_id.nil?
+          command.params['webPropertyId'] = web_property_id unless web_property_id.nil?
+          command.params['remarketingAudienceId'] = remarketing_audience_id unless remarketing_audience_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates an existing remarketing audience.
+        # @param [String] account_id
+        #   The account ID of the remarketing audience to update.
+        # @param [String] web_property_id
+        #   The web property ID of the remarketing audience to update.
+        # @param [String] remarketing_audience_id
+        #   The ID of the remarketing audience to update.
+        # @param [Google::Apis::AnalyticsV3::RemarketingAudience] remarketing_audience_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.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AnalyticsV3::RemarketingAudience] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AnalyticsV3::RemarketingAudience]
+        #
+        # @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 update_management_remarketing_audience(account_id, web_property_id, remarketing_audience_id, remarketing_audience_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:put, 'management/accounts/{accountId}/webproperties/{webPropertyId}/remarketingAudiences/{remarketingAudienceId}', options)
+          command.request_representation = Google::Apis::AnalyticsV3::RemarketingAudience::Representation
+          command.request_object = remarketing_audience_object
+          command.response_representation = Google::Apis::AnalyticsV3::RemarketingAudience::Representation
+          command.response_class = Google::Apis::AnalyticsV3::RemarketingAudience
+          command.params['accountId'] = account_id unless account_id.nil?
+          command.params['webPropertyId'] = web_property_id unless web_property_id.nil?
+          command.params['remarketingAudienceId'] = remarketing_audience_id unless remarketing_audience_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists segments to which the user has access.
         # @param [Fixnum] max_results
         #   The maximum number of segments to include in this response.

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 = '20160512'
+      REVISION = '20161011'
 
       # View your Google Analytics data
       AUTH_ANALYTICS_READONLY = 'https://www.googleapis.com/auth/analytics.readonly'

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

@@ -47,7 +47,9 @@ module Google
         end
       end
       
-      # A metric in the request.
+      # [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
       
@@ -358,7 +360,8 @@ module Google
         # @return [Google::Apis::AnalyticsreportingV4::CohortGroup]
         attr_accessor :cohort_group
       
-        # Dimensions requested in the request.
+        # The dimensions requested.
+        # Requests can have a total of 7 dimensions.
         # Corresponds to the JSON property `dimensions`
         # @return [Array<Google::Apis::AnalyticsreportingV4::Dimension>]
         attr_accessor :dimensions
@@ -394,7 +397,7 @@ module Google
         # @return [Array<Google::Apis::AnalyticsreportingV4::DimensionFilterClause>]
         attr_accessor :dimension_filter_clauses
       
-        # The pivot definitions.
+        # The pivot definitions. Requests can have a maximum of 2 pivots.
         # Corresponds to the JSON property `pivots`
         # @return [Array<Google::Apis::AnalyticsreportingV4::Pivot>]
         attr_accessor :pivots
@@ -407,28 +410,36 @@ module Google
         # 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)
+        # 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
       
         # 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. All requests should have the same segment definitions. Requests
+        # 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 desired sampling level. If the sampling level is not specified the
-        # DEFAULT sampling level will be used. All requests should have same
-        # `samplingLevel`.
+        # 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
       
-        # Metrics, the quantitative measurements, requested in the request.
-        # Requests must specify at least one metric.
+        # 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
@@ -471,7 +482,10 @@ module Google
         attr_accessor :hide_value_ranges
         alias_method :hide_value_ranges?, :hide_value_ranges
       
-        # Unique View Id for retrieving Analytics data.
+        # 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
@@ -610,8 +624,13 @@ module Google
         # @return [Fixnum]
         attr_accessor :row_count
       
-        # If sampling was enabled, this returns the total number of samples
-        # present, one entry per date range.
+        # 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<String>]
         attr_accessor :sampling_space_sizes
@@ -623,8 +642,12 @@ module Google
         # @return [Array<Google::Apis::AnalyticsreportingV4::DateRangeValues>]
         attr_accessor :maximums
       
-        # If sampling was enabled, this returns the total number of samples
-        # read, one entry per date range
+        # 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<String>]
         attr_accessor :samples_read_counts
@@ -684,7 +707,7 @@ module Google
       
         # Requests, each request will have a separate response.
         # There can be a maximum of 5 requests. All requests should have the same
-        # `dateRange`, `viewId`, `segments`, `samplingLevel`, and `cohortGroup`.
+        # `dateRanges`, `viewId`, `segments`, `samplingLevel`, and `cohortGroup`.
         # Corresponds to the JSON property `reportRequests`
         # @return [Array<Google::Apis::AnalyticsreportingV4::ReportRequest>]
         attr_accessor :report_requests
@@ -880,8 +903,7 @@ module Google
       class PivotHeaderEntry
         include Google::Apis::Core::Hashable
       
-        # The name of the dimensions in the pivotDimensionValues field in the
-        # response.
+        # The name of the dimensions in the pivot response.
         # Corresponds to the JSON property `dimensionNames`
         # @return [Array<String>]
         attr_accessor :dimension_names
@@ -969,12 +991,15 @@ module Google
       class Pivot
         include Google::Apis::Core::Hashable
       
-        # A list of dimensions to show as pivot columns.
+        # 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
       
-        # Metrics to aggregate and return.
+        # 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
@@ -1144,7 +1169,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :dimensions
       
-        # List of metrics for each requested DateRange
+        # List of metrics for each requested DateRange.
         # Corresponds to the JSON property `metrics`
         # @return [Array<Google::Apis::AnalyticsreportingV4::DateRangeValues>]
         attr_accessor :metrics
@@ -1313,7 +1338,10 @@ module Google
         end
       end
       
-      # A dimension in the request.
+      # [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