google-api-client 0.49.0 → 0.53.0

data/generated/google/apis/analyticsdata_v1alpha.rb

@@ -22,10 +22,10 @@ module Google
     #
     # Accesses report data in Google Analytics.
     #
-    # @see https://developers.google.com/analytics/trusted-testing/analytics-data/
+    # @see https://developers.google.com/analytics/devguides/reporting/data/v1/
     module AnalyticsdataV1alpha
       VERSION = 'V1alpha'
-      REVISION = '20201030'
+      REVISION = '20201209'
 
       # View and manage your Google Analytics data
       AUTH_ANALYTICS = 'https://www.googleapis.com/auth/analytics'

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

@@ -157,21 +157,19 @@ module Google
         end
       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.
+      # Defines a cohort selection criteria. A cohort is a group of users who share a
+      # common characteristic. For example, users with the same `firstTouchDate`
+      # belong to the same cohort.
       class Cohort
         include Google::Apis::Core::Hashable
       
         # A contiguous set of days: startDate, startDate + 1, ..., endDate. Requests are
-        # allowed up to 4 date ranges, and the union of the ranges can cover up to 1
-        # year.
+        # allowed up to 4 date ranges.
         # Corresponds to the JSON property `dateRange`
         # @return [Google::Apis::AnalyticsdataV1alpha::DateRange]
         attr_accessor :date_range
       
-        # The dimension used by cohort. Only supports `firstTouchDate` for retention
-        # report.
+        # Dimension used by the cohort. Required and only supports `firstTouchDate`.
         # Corresponds to the JSON property `dimension`
         # @return [String]
         attr_accessor :dimension
@@ -196,11 +194,11 @@ module Google
         end
       end
       
-      # Settings of a cohort report.
+      # Optional settings of a cohort report.
       class CohortReportSettings
         include Google::Apis::Core::Hashable
       
-        # If true, accumulates the result from first visit day to the end day. Not
+        # If true, accumulates the result from first touch day to the end day. Not
         # supported in `RunReportRequest`.
         # Corresponds to the JSON property `accumulate`
         # @return [Boolean]
@@ -217,21 +215,34 @@ module Google
         end
       end
       
-      # Specification for a cohort report.
+      # Specification of cohorts for a cohort report. Cohort reports can be used for
+      # example to create a time series of user retention for the cohort. For example,
+      # you could select the cohort of users that were acquired in the first week of
+      # September and follow that cohort for the next six weeks. Selecting the users
+      # acquired in the first week of September cohort is specified in the `cohort`
+      # object. Following that cohort for the next six weeks is specified in the `
+      # cohortsRange` object. The report response could show a weekly time series
+      # where say your app has retained 60% of this cohort after three weeks and 25%
+      # of this cohort after six weeks. These two percentages can be calculated by the
+      # metric `cohortActiveUsers/cohortTotalUsers` and will be separate rows in the
+      # report.
       class CohortSpec
         include Google::Apis::Core::Hashable
       
-        # Settings of a cohort report.
+        # Optional settings of a cohort report.
         # Corresponds to the JSON property `cohortReportSettings`
         # @return [Google::Apis::AnalyticsdataV1alpha::CohortReportSettings]
         attr_accessor :cohort_report_settings
       
-        # The definition for the cohorts.
+        # Defines the selection criteria to group users into cohorts. Most cohort
+        # reports define only a single cohort. If multiple cohorts are specified, each
+        # cohort can be recognized in the report by their name.
         # Corresponds to the JSON property `cohorts`
         # @return [Array<Google::Apis::AnalyticsdataV1alpha::Cohort>]
         attr_accessor :cohorts
       
-        # Describes date range for a cohort report.
+        # Configures the extended reporting date range for a cohort report. Specifies an
+        # offset duration to follow the cohorts over.
         # Corresponds to the JSON property `cohortsRange`
         # @return [Google::Apis::AnalyticsdataV1alpha::CohortsRange]
         attr_accessor :cohorts_range
@@ -248,23 +259,39 @@ module Google
         end
       end
       
-      # Describes date range for a cohort report.
+      # Configures the extended reporting date range for a cohort report. Specifies an
+      # offset duration to follow the cohorts over.
       class CohortsRange
         include Google::Apis::Core::Hashable
       
-        # For daily cohorts, this will be the end day offset. For weekly cohorts, this
-        # will be the week offset.
+        # Required. `endOffset` specifies the end date of the extended reporting date
+        # range for a cohort report. `endOffset` can be any positive integer but is
+        # commonly set to 5 to 10 so that reports contain data on the cohort for the
+        # next several granularity time periods. If `granularity` is `DAILY`, the `
+        # endDate` of the extended reporting date range is `endDate` of the cohort plus `
+        # endOffset` days. If `granularity` is `WEEKLY`, the `endDate` of the extended
+        # reporting date range is `endDate` of the cohort plus `endOffset * 7` days. If `
+        # granularity` is `MONTHLY`, the `endDate` of the extended reporting date range
+        # is `endDate` of the cohort plus `endOffset * 30` days.
         # Corresponds to the JSON property `endOffset`
         # @return [Fixnum]
         attr_accessor :end_offset
       
-        # Reporting date range for each cohort is calculated based on these three fields.
+        # Required. The granularity used to interpret the `startOffset` and `endOffset`
+        # for the extended reporting date range for a cohort report.
         # Corresponds to the JSON property `granularity`
         # @return [String]
         attr_accessor :granularity
       
-        # For daily cohorts, this will be the start day offset. For weekly cohorts, this
-        # will be the week offset.
+        # `startOffset` specifies the start date of the extended reporting date range
+        # for a cohort report. `startOffset` is commonly set to 0 so that reports
+        # contain data from the acquisition of the cohort forward. If `granularity` is `
+        # DAILY`, the `startDate` of the extended reporting date range is `startDate` of
+        # the cohort plus `startOffset` days. If `granularity` is `WEEKLY`, the `
+        # startDate` of the extended reporting date range is `startDate` of the cohort
+        # plus `startOffset * 7` days. If `granularity` is `MONTHLY`, the `startDate` of
+        # the extended reporting date range is `startDate` of the cohort plus `
+        # startOffset * 30` days.
         # Corresponds to the JSON property `startOffset`
         # @return [Fixnum]
         attr_accessor :start_offset
@@ -312,8 +339,7 @@ module Google
       end
       
       # A contiguous set of days: startDate, startDate + 1, ..., endDate. Requests are
-      # allowed up to 4 date ranges, and the union of the ranges can cover up to 1
-      # year.
+      # allowed up to 4 date ranges.
       class DateRange
         include Google::Apis::Core::Hashable
       
@@ -368,9 +394,9 @@ module Google
         attr_accessor :dimension_expression
       
         # The name of the dimension. See the [API Dimensions](https://developers.google.
-        # com/analytics/trusted-testing/analytics-data/api-schema#dimensions) for the
-        # list of dimension names. If `dimensionExpression` is specified, `name` can be
-        # any string that you would like. For example if a `dimensionExpression`
+        # com/analytics/devguides/reporting/data/v1/api-schema#dimensions) for the list
+        # of dimension names. If `dimensionExpression` is specified, `name` can be any
+        # string that you would like. For example if a `dimensionExpression`
         # concatenates `country` and `city`, you could call that dimension `
         # countryAndCity`. Dimensions are referenced by `name` in `dimensionFilter`, `
         # orderBys`, `dimensionExpression`, and `pivots`.
@@ -454,6 +480,12 @@ module Google
         # @return [String]
         attr_accessor :api_name
       
+        # True if the dimension is a custom dimension for this property.
+        # Corresponds to the JSON property `customDefinition`
+        # @return [Boolean]
+        attr_accessor :custom_definition
+        alias_method :custom_definition?, :custom_definition
+      
         # Still usable but deprecated names for this dimension. If populated, this
         # dimension is available by either `apiName` or one of `deprecatedApiNames` for
         # a period of time. After the deprecation period, the dimension will be
@@ -480,6 +512,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @api_name = args[:api_name] if args.key?(:api_name)
+          @custom_definition = args[:custom_definition] if args.key?(:custom_definition)
           @deprecated_api_names = args[:deprecated_api_names] if args.key?(:deprecated_api_names)
           @description = args[:description] if args.key?(:description)
           @ui_name = args[:ui_name] if args.key?(:ui_name)
@@ -535,8 +568,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A Google Analytics GA4 property id. To learn more, see [where to find your
-        # Property ID](https://developers.google.com/analytics/trusted-testing/analytics-
-        # data/property-id).
+        # Property ID](https://developers.google.com/analytics/devguides/reporting/data/
+        # v1/property-id).
         # Corresponds to the JSON property `propertyId`
         # @return [String]
         attr_accessor :property_id
@@ -740,7 +773,7 @@ module Google
         alias_method :invisible?, :invisible
       
         # The name of the metric. See the [API Metrics](https://developers.google.com/
-        # analytics/trusted-testing/analytics-data/api-schema#metrics) for the list of
+        # analytics/devguides/reporting/data/v1/api-schema#metrics) for the list of
         # metric names. If `expression` is specified, `name` can be any string that you
         # would like. For example if `expression` is `screenPageViews/sessions`, you
         # could call that metric's name = `viewsPerSession`. Metrics are referenced by `
@@ -799,6 +832,12 @@ module Google
         # @return [String]
         attr_accessor :api_name
       
+        # True if the metric is a custom metric for this property.
+        # Corresponds to the JSON property `customDefinition`
+        # @return [Boolean]
+        attr_accessor :custom_definition
+        alias_method :custom_definition?, :custom_definition
+      
         # Still usable but deprecated names for this metric. If populated, this metric
         # is available by either `apiName` or one of `deprecatedApiNames` for a period
         # of time. After the deprecation period, the metric will be available only by `
@@ -837,6 +876,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @api_name = args[:api_name] if args.key?(:api_name)
+          @custom_definition = args[:custom_definition] if args.key?(:custom_definition)
           @deprecated_api_names = args[:deprecated_api_names] if args.key?(:deprecated_api_names)
           @description = args[:description] if args.key?(:description)
           @expression = args[:expression] if args.key?(:expression)
@@ -1251,7 +1291,17 @@ module Google
       class RunPivotReportRequest
         include Google::Apis::Core::Hashable
       
-        # Specification for a cohort report.
+        # Specification of cohorts for a cohort report. Cohort reports can be used for
+        # example to create a time series of user retention for the cohort. For example,
+        # you could select the cohort of users that were acquired in the first week of
+        # September and follow that cohort for the next six weeks. Selecting the users
+        # acquired in the first week of September cohort is specified in the `cohort`
+        # object. Following that cohort for the next six weeks is specified in the `
+        # cohortsRange` object. The report response could show a weekly time series
+        # where say your app has retained 60% of this cohort after three weeks and 25%
+        # of this cohort after six weeks. These two percentages can be calculated by the
+        # metric `cohortActiveUsers/cohortTotalUsers` and will be separate rows in the
+        # report.
         # Corresponds to the JSON property `cohortSpec`
         # @return [Google::Apis::AnalyticsdataV1alpha::CohortSpec]
         attr_accessor :cohort_spec
@@ -1552,7 +1602,17 @@ module Google
       class RunReportRequest
         include Google::Apis::Core::Hashable
       
-        # Specification for a cohort report.
+        # Specification of cohorts for a cohort report. Cohort reports can be used for
+        # example to create a time series of user retention for the cohort. For example,
+        # you could select the cohort of users that were acquired in the first week of
+        # September and follow that cohort for the next six weeks. Selecting the users
+        # acquired in the first week of September cohort is specified in the `cohort`
+        # object. Following that cohort for the next six weeks is specified in the `
+        # cohortsRange` object. The report response could show a weekly time series
+        # where say your app has retained 60% of this cohort after three weeks and 25%
+        # of this cohort after six weeks. These two percentages can be calculated by the
+        # metric `cohortActiveUsers/cohortTotalUsers` and will be separate rows in the
+        # report.
         # Corresponds to the JSON property `cohortSpec`
         # @return [Google::Apis::AnalyticsdataV1alpha::CohortSpec]
         attr_accessor :cohort_spec
@@ -1597,7 +1657,9 @@ module Google
         alias_method :keep_empty_rows?, :keep_empty_rows
       
         # The number of rows to return. If unspecified, 10 rows are returned. If -1, all
-        # rows are returned.
+        # rows are returned. To learn more about this pagination parameter, see [
+        # Pagination](https://developers.google.com/analytics/devguides/reporting/data/
+        # v1/basics#pagination).
         # Corresponds to the JSON property `limit`
         # @return [Fixnum]
         attr_accessor :limit
@@ -1619,7 +1681,9 @@ module Google
         # @return [Array<Google::Apis::AnalyticsdataV1alpha::Metric>]
         attr_accessor :metrics
       
-        # The row count of the start row. The first row is counted as row 0.
+        # The row count of the start row. The first row is counted as row 0. To learn
+        # more about this pagination parameter, see [Pagination](https://developers.
+        # google.com/analytics/devguides/reporting/data/v1/basics#pagination).
         # Corresponds to the JSON property `offset`
         # @return [Fixnum]
         attr_accessor :offset
@@ -1700,7 +1764,9 @@ module Google
         # The total number of rows in the query result, regardless of the number of rows
         # returned in the response. For example if a query returns 175 rows and includes
         # limit = 50 in the API request, the response will contain row_count = 175 but
-        # only 50 rows.
+        # only 50 rows. To learn more about this pagination parameter, see [Pagination](
+        # https://developers.google.com/analytics/devguides/reporting/data/v1/basics#
+        # pagination).
         # Corresponds to the JSON property `rowCount`
         # @return [Fixnum]
         attr_accessor :row_count
@@ -1764,31 +1830,6 @@ module Google
           @value = args[:value] if args.key?(:value)
         end
       end
-      
-      # The dimensions and metrics currently accepted in reporting methods.
-      class UniversalMetadata
-        include Google::Apis::Core::Hashable
-      
-        # The dimensions descriptions.
-        # Corresponds to the JSON property `dimensions`
-        # @return [Array<Google::Apis::AnalyticsdataV1alpha::DimensionMetadata>]
-        attr_accessor :dimensions
-      
-        # The metric descriptions.
-        # Corresponds to the JSON property `metrics`
-        # @return [Array<Google::Apis::AnalyticsdataV1alpha::MetricMetadata>]
-        attr_accessor :metrics
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @dimensions = args[:dimensions] if args.key?(:dimensions)
-          @metrics = args[:metrics] if args.key?(:metrics)
-        end
-      end
     end
   end
 end

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

@@ -310,12 +310,6 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class UniversalMetadata
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
       class BatchRunPivotReportsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -456,6 +450,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :api_name, as: 'apiName'
+          property :custom_definition, as: 'customDefinition'
           collection :deprecated_api_names, as: 'deprecatedApiNames'
           property :description, as: 'description'
           property :ui_name, as: 'uiName'
@@ -562,6 +557,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :api_name, as: 'apiName'
+          property :custom_definition, as: 'customDefinition'
           collection :deprecated_api_names, as: 'deprecatedApiNames'
           property :description, as: 'description'
           property :expression, as: 'expression'
@@ -843,16 +839,6 @@ module Google
           property :value, as: 'value'
         end
       end
-      
-      class UniversalMetadata
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          collection :dimensions, as: 'dimensions', class: Google::Apis::AnalyticsdataV1alpha::DimensionMetadata, decorator: Google::Apis::AnalyticsdataV1alpha::DimensionMetadata::Representation
-      
-          collection :metrics, as: 'metrics', class: Google::Apis::AnalyticsdataV1alpha::MetricMetadata, decorator: Google::Apis::AnalyticsdataV1alpha::MetricMetadata::Representation
-      
-        end
-      end
     end
   end
 end

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

@@ -30,7 +30,7 @@ module Google
       #    Analyticsdata = Google::Apis::AnalyticsdataV1alpha # Alias the module
       #    service = Analyticsdata::AnalyticsDataService.new
       #
-      # @see https://developers.google.com/analytics/trusted-testing/analytics-data/
+      # @see https://developers.google.com/analytics/devguides/reporting/data/v1/
       class AnalyticsDataService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
@@ -59,8 +59,10 @@ module Google
         #   Required. The resource name of the metadata to retrieve. This name field is
         #   specified in the URL path and not URL parameters. Property is a numeric Google
         #   Analytics GA4 Property identifier. To learn more, see [where to find your
-        #   Property ID](https://developers.google.com/analytics/trusted-testing/analytics-
-        #   data/property-id). Example: properties/1234/metadata
+        #   Property ID](https://developers.google.com/analytics/devguides/reporting/data/
+        #   v1/property-id). Example: properties/1234/metadata Set the Property ID to 0
+        #   for dimensions and metrics common to all properties. In this special mode,
+        #   this method will not return custom dimensions and metrics.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -94,8 +96,8 @@ module Google
         # @param [String] property
         #   A Google Analytics GA4 property identifier whose events are tracked. Specified
         #   in the URL path and not the body. To learn more, see [where to find your
-        #   Property ID](https://developers.google.com/analytics/trusted-testing/analytics-
-        #   data/property-id). Example: properties/1234
+        #   Property ID](https://developers.google.com/analytics/devguides/reporting/data/
+        #   v1/property-id). Example: properties/1234
         # @param [Google::Apis::AnalyticsdataV1alpha::RunRealtimeReportRequest] run_realtime_report_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -187,37 +189,6 @@ module Google
           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.

data/generated/google/apis/androidenterprise_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/android/work/play/emm-api
     module AndroidenterpriseV1
       VERSION = 'V1'
-      REVISION = '20200915'
+      REVISION = '20201125'
 
       # Manage corporate Android devices
       AUTH_ANDROIDENTERPRISE = 'https://www.googleapis.com/auth/androidenterprise'

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

@@ -2121,6 +2121,11 @@ module Google
         # @return [Google::Apis::AndroidenterpriseV1::AutoInstallPolicy]
         attr_accessor :auto_install_policy
       
+        # The auto-update mode for the product.
+        # Corresponds to the JSON property `autoUpdateMode`
+        # @return [String]
+        attr_accessor :auto_update_mode
+      
         # A managed configuration resource contains the set of managed properties
         # defined by the app developer in the app's managed configurations schema, as
         # well as any configuration variables defined for the user.
@@ -2152,6 +2157,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @auto_install_policy = args[:auto_install_policy] if args.key?(:auto_install_policy)
+          @auto_update_mode = args[:auto_update_mode] if args.key?(:auto_update_mode)
           @managed_configuration = args[:managed_configuration] if args.key?(:managed_configuration)
           @product_id = args[:product_id] if args.key?(:product_id)
           @track_ids = args[:track_ids] if args.key?(:track_ids)