google-analytics-data-v1alpha 0.2.0 → 0.6.0

data/lib/google/analytics/data/v1alpha/version.rb

@@ -21,7 +21,7 @@ module Google
   module Analytics
     module Data
       module V1alpha
-        VERSION = "0.2.0"
+        VERSION = "0.6.0"
       end
     end
   end

data/proto_docs/google/analytics/data/v1alpha/analytics_data_api.rb

@@ -21,6 +21,21 @@ module Google
   module Analytics
     module Data
       module V1alpha
+        # The dimensions and metrics currently accepted in reporting methods.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Resource name of this metadata.
+        # @!attribute [rw] dimensions
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::DimensionMetadata>]
+        #     The dimension descriptions.
+        # @!attribute [rw] metrics
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::MetricMetadata>]
+        #     The metric descriptions.
+        class Metadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The request to generate a report.
         # @!attribute [rw] entity
         #   @return [::Google::Analytics::Data::V1alpha::Entity]
@@ -42,10 +57,16 @@ module Google
         # @!attribute [rw] offset
         #   @return [::Integer]
         #     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).
         # @!attribute [rw] limit
         #   @return [::Integer]
         #     The number of rows to return. If unspecified, 10 rows are returned. If
         #     -1, all rows are returned.
+        #
+        #     To learn more about this pagination parameter, see
+        #     [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
         # @!attribute [rw] metric_aggregations
         #   @return [::Array<::Google::Analytics::Data::V1alpha::MetricAggregation>]
         #     Aggregation of metrics. Aggregated metric values will be shown in rows
@@ -111,6 +132,9 @@ module Google
         #     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.
+        #
+        #     To learn more about this pagination parameter, see
+        #     [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
         # @!attribute [rw] metadata
         #   @return [::Google::Analytics::Data::V1alpha::ResponseMetaData]
         #     Metadata for the report.
@@ -295,20 +319,100 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request for the universal dimension and metric metadata.
-        class GetUniversalMetadataRequest
+        # Request for a property's dimension and metric metadata.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     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/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.
+        class GetMetadataRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The dimensions and metrics currently accepted in reporting methods.
+        # The request to generate a realtime report.
+        # @!attribute [rw] property
+        #   @return [::String]
+        #     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/devguides/reporting/data/v1/property-id).
+        #
+        #     Example: properties/1234
         # @!attribute [rw] dimensions
-        #   @return [::Array<::Google::Analytics::Data::V1alpha::DimensionMetadata>]
-        #     The dimensions descriptions.
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::Dimension>]
+        #     The dimensions requested and displayed.
         # @!attribute [rw] metrics
-        #   @return [::Array<::Google::Analytics::Data::V1alpha::MetricMetadata>]
-        #     The metric descriptions.
-        class UniversalMetadata
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::Metric>]
+        #     The metrics requested and displayed.
+        # @!attribute [rw] limit
+        #   @return [::Integer]
+        #     The number of rows to return. If unspecified, 10 rows are returned. If
+        #     -1, all rows are returned.
+        # @!attribute [rw] dimension_filter
+        #   @return [::Google::Analytics::Data::V1alpha::FilterExpression]
+        #     The filter clause of dimensions. Dimensions must be requested to be used in
+        #     this filter. Metrics cannot be used in this filter.
+        # @!attribute [rw] metric_filter
+        #   @return [::Google::Analytics::Data::V1alpha::FilterExpression]
+        #     The filter clause of metrics. Applied at post aggregation phase, similar to
+        #     SQL having-clause. Metrics must be requested to be used in this filter.
+        #     Dimensions cannot be used in this filter.
+        # @!attribute [rw] metric_aggregations
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::MetricAggregation>]
+        #     Aggregation of metrics. Aggregated metric values will be shown in rows
+        #     where the dimension_values are set to "RESERVED_(MetricAggregation)".
+        # @!attribute [rw] order_bys
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::OrderBy>]
+        #     Specifies how rows are ordered in the response.
+        # @!attribute [rw] return_property_quota
+        #   @return [::Boolean]
+        #     Toggles whether to return the current state of this Analytics Property's
+        #     Realtime quota. Quota is returned in [PropertyQuota](#PropertyQuota).
+        class RunRealtimeReportRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response realtime report table corresponding to a request.
+        # @!attribute [rw] dimension_headers
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::DimensionHeader>]
+        #     Describes dimension columns. The number of DimensionHeaders and ordering of
+        #     DimensionHeaders matches the dimensions present in rows.
+        # @!attribute [rw] metric_headers
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::MetricHeader>]
+        #     Describes metric columns. The number of MetricHeaders and ordering of
+        #     MetricHeaders matches the metrics present in rows.
+        # @!attribute [rw] rows
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::Row>]
+        #     Rows of dimension value combinations and metric values in the report.
+        # @!attribute [rw] totals
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::Row>]
+        #     If requested, the totaled values of metrics.
+        # @!attribute [rw] maximums
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::Row>]
+        #     If requested, the maximum values of metrics.
+        # @!attribute [rw] minimums
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::Row>]
+        #     If requested, the minimum values of metrics.
+        # @!attribute [rw] row_count
+        #   @return [::Integer]
+        #     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.
+        # @!attribute [rw] property_quota
+        #   @return [::Google::Analytics::Data::V1alpha::PropertyQuota]
+        #     This Analytics Property's Realtime quota state including this request.
+        class RunRealtimeReportResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end

data/proto_docs/google/analytics/data/v1alpha/data.rb

@@ -22,8 +22,7 @@ module Google
     module Data
       module V1alpha
         # 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.
+        # are allowed up to 4 date ranges.
         # @!attribute [rw] start_date
         #   @return [::String]
         #     The inclusive start date for the query in the format `YYYY-MM-DD`. Cannot
@@ -50,18 +49,30 @@ module Google
         # The unique identifier of the property whose events are tracked.
         # @!attribute [rw] property_id
         #   @return [::String]
-        #     A Google Analytics App + Web property id.
+        #     A Google Analytics GA4 property id. To learn more, see [where to find your
+        #     Property
+        #     ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
         class Entity
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Dimensions are attributes of your data. For example, the dimension City
-        # indicates the city, for example, "Paris" or "New York", from which an event
-        # originates. Requests are allowed up to 8 dimensions.
+        # Dimensions are attributes of your data. For example, the dimension city
+        # indicates the city from which an event originates. Dimension values in report
+        # responses are strings; for example, city could be "Paris" or "New York".
+        # Requests are allowed up to 8 dimensions.
         # @!attribute [rw] name
         #   @return [::String]
-        #     The name of the dimension.
+        #     The name of the dimension. See the [API
+        #     Dimensions](https://developers.google.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`.
         # @!attribute [rw] dimension_expression
         #   @return [::Google::Analytics::Data::V1alpha::DimensionExpression]
         #     One dimension can be the result of an expression of multiple dimensions.
@@ -119,20 +130,30 @@ module Google
           end
         end
 
-        # The quantitative measurements of a report. For example, the metric eventCount
-        # is the total number of events. Requests are allowed up to 10 metrics.
+        # The quantitative measurements of a report. For example, the metric
+        # `eventCount` is the total number of events. Requests are allowed up to 10
+        # metrics.
         # @!attribute [rw] name
         #   @return [::String]
-        #     The name of the metric.
+        #     The name of the metric. See the [API
+        #     Metrics](https://developers.google.com/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 `name` in `metricFilter`, `orderBys`, and metric
+        #     `expression`.
         # @!attribute [rw] expression
         #   @return [::String]
         #     A mathematical expression for derived metrics. For example, the metric
-        #     Event count per user is eventCount/totalUsers.
+        #     Event count per user is `eventCount/totalUsers`.
         # @!attribute [rw] invisible
         #   @return [::Boolean]
-        #     Indicates if a metric is invisible.
-        #     If a metric is invisible, the metric is not in the response, but can be
-        #     used in filters, order_bys or being referred to in a metric expression.
+        #     Indicates if a metric is invisible in the report response. If a metric is
+        #     invisible, the metric will not produce a column in the response, but can be
+        #     used in `metricFilter`, `orderBys`, or a metric `expression`.
         class Metric
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -176,7 +197,10 @@ module Google
         #     or metrics.
         # @!attribute [rw] null_filter
         #   @return [::Boolean]
-        #     A filter for null values.
+        #     A filter for null values. If True, a null dimension value is matched by
+        #     this filter. Null filter is commonly used inside a NOT filter
+        #     expression. For example, a NOT expression of a null filter removes rows
+        #     when a dimension is null.
         # @!attribute [rw] string_filter
         #   @return [::Google::Analytics::Data::V1alpha::Filter::StringFilter]
         #     Strings related filter.
@@ -423,23 +447,38 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         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.
         # @!attribute [rw] cohorts
         #   @return [::Array<::Google::Analytics::Data::V1alpha::Cohort>]
-        #     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.
         # @!attribute [rw] cohorts_range
         #   @return [::Google::Analytics::Data::V1alpha::CohortsRange]
-        #     The data ranges of cohorts.
+        #     Cohort reports follow cohorts over an extended reporting date range. This
+        #     range specifies an offset duration to follow the cohorts over.
         # @!attribute [rw] cohort_report_settings
         #   @return [::Google::Analytics::Data::V1alpha::CohortReportSettings]
-        #     Settings of a cohort report.
+        #     Optional settings for a cohort report.
         class CohortSpec
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         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
+        # 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.
         # @!attribute [rw] name
         #   @return [::String]
@@ -449,69 +488,100 @@ module Google
         #     `cohort_0`, `cohort_1`, etc.
         # @!attribute [rw] dimension
         #   @return [::String]
-        #     The dimension used by cohort. Only supports `firstTouchDate` for retention
-        #     report.
+        #     Dimension used by the cohort. Required and only supports `firstTouchDate`.
         # @!attribute [rw] date_range
         #   @return [::Google::Analytics::Data::V1alpha::DateRange]
-        #     The cohort selects users whose first visit date is between start date
-        #     and end date defined in the `dateRange`. In a cohort request, this
-        #     `dateRange` is required and the `dateRanges` in the `RunReportRequest` or
-        #     `RunPivotReportRequest` must be unspecified.
+        #     The cohort selects users whose first touch date is between start date and
+        #     end date defined in the `dateRange`. This `dateRange` does not specify the
+        #     full date range of event data that is present in a cohort report. In a
+        #     cohort report, this `dateRange` is extended by the granularity and offset
+        #     present in the `cohortsRange`; event data for the extended reporting date
+        #     range is present in a cohort report.
+        #
+        #     In a cohort request, this `dateRange` is required and the `dateRanges` in
+        #     the `RunReportRequest` or `RunPivotReportRequest` must be unspecified.
         #
-        #     The date range should be aligned with the cohort's granularity. If
-        #     CohortsRange uses daily granularity, the date range can be aligned to any
-        #     day. If CohortsRange uses weekly granularity, the date range should be
-        #     aligned to the week boundary, starting at Sunday and ending Saturday. If
-        #     CohortsRange uses monthly granularity, the date range should be aligned to
-        #     the month, starting at the first and ending on the last day of the month.
+        #     This `dateRange` should generally be aligned with the cohort's granularity.
+        #     If `CohortsRange` uses daily granularity, this `dateRange` can be a single
+        #     day. If `CohortsRange` uses weekly granularity, this `dateRange` can be
+        #     aligned to a week boundary, starting at Sunday and ending Saturday. If
+        #     `CohortsRange` uses monthly granularity, this `dateRange` can be aligned to
+        #     a month, starting at the first and ending on the last day of the month.
         class Cohort
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Settings of a cohort report.
-        # @!attribute [rw] accumulate
-        #   @return [::Boolean]
-        #     If true, accumulates the result from first visit day to the end day. Not
-        #     supported in `RunReportRequest`.
-        class CohortReportSettings
-          include ::Google::Protobuf::MessageExts
-          extend ::Google::Protobuf::MessageExts::ClassMethods
-        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.
         # @!attribute [rw] granularity
         #   @return [::Google::Analytics::Data::V1alpha::CohortsRange::Granularity]
-        #     Reporting date range for each cohort is calculated based on these three
-        #     fields.
+        #     The granularity used to interpret the `startOffset` and `endOffset` for the
+        #     extended reporting date range for a cohort report.
         # @!attribute [rw] start_offset
         #   @return [::Integer]
-        #     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.
         # @!attribute [rw] end_offset
         #   @return [::Integer]
-        #     For daily cohorts, this will be the end day offset.
-        #     For weekly cohorts, this will be the week offset.
+        #     `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.
         class CohortsRange
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # Reporting granularity for the cohorts.
+          # The granularity used to interpret the `startOffset` and `endOffset` for the
+          # extended reporting date range for a cohort report.
           module Granularity
-            # Unspecified.
+            # Should never be specified.
             GRANULARITY_UNSPECIFIED = 0
 
-            # Daily
+            # Daily granularity. Commonly used if the cohort's `dateRange` is a single
+            # day and the request contains `cohortNthDay`.
             DAILY = 1
 
-            # Weekly
+            # Weekly granularity. Commonly used if the cohort's `dateRange` is a week
+            # in duration (starting on Sunday and ending on Saturday) and the request
+            # contains `cohortNthWeek`.
             WEEKLY = 2
 
-            # Monthly
+            # Monthly granularity. Commonly used if the cohort's `dateRange` is a month
+            # in duration and the request contains `cohortNthMonth`.
             MONTHLY = 3
           end
         end
 
+        # Optional settings of a cohort report.
+        # @!attribute [rw] accumulate
+        #   @return [::Boolean]
+        #     If true, accumulates the result from first touch day to the end day. Not
+        #     supported in `RunReportRequest`.
+        class CohortReportSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Response's metadata carrying additional information about the report content.
         # @!attribute [rw] data_loss_from_other_row
         #   @return [::Boolean]
@@ -577,28 +647,38 @@ module Google
         # For example if RunReportRequest contains:
         #
         # ```none
-        # dimensions {
-        #   name: "eventName"
-        # }
-        # dimensions {
-        #   name: "countryId"
-        # }
-        # metrics {
-        #   name: "eventCount"
-        # }
+        # "dimensions": [
+        #   {
+        #     "name": "eventName"
+        #   },
+        #   {
+        #     "name": "countryId"
+        #   }
+        # ],
+        # "metrics": [
+        #   {
+        #     "name": "eventCount"
+        #   }
+        # ]
         # ```
         #
-        # One row with 'in_app_purchase' as the eventName, 'us' as the countryId, and
+        # One row with 'in_app_purchase' as the eventName, 'JP' as the countryId, and
         # 15 as the eventCount, would be:
         #
         # ```none
-        # dimension_values {
-        #   name: 'in_app_purchase'
-        #   name: 'us'
-        # }
-        # metric_values {
-        #   int64_value: 15
-        # }
+        # "dimensionValues": [
+        #   {
+        #     "value": "in_app_purchase"
+        #   },
+        #   {
+        #     "value": "JP"
+        #   }
+        # ],
+        # "metricValues": [
+        #   {
+        #     "value": "15"
+        #   }
+        # ]
         # ```
         # @!attribute [rw] dimension_values
         #   @return [::Array<::Google::Analytics::Data::V1alpha::DimensionValue>]
@@ -647,20 +727,24 @@ module Google
         # Exhausted errors.
         # @!attribute [rw] tokens_per_day
         #   @return [::Google::Analytics::Data::V1alpha::QuotaStatus]
-        #     Analytics Properties can use up to 25,000 tokens per day. Most requests
+        #     Standard Analytics Properties can use up to 25,000 tokens per day;
+        #     Analytics 360 Properties can use 250,000 tokens per day. Most requests
         #     consume fewer than 10 tokens.
         # @!attribute [rw] tokens_per_hour
         #   @return [::Google::Analytics::Data::V1alpha::QuotaStatus]
-        #     Analytics Properties can use up to 5,000 tokens per day. An API request
-        #     consumes a single number of tokens, and that number is deducted from both
-        #     the hourly and daily quotas.
+        #     Standard Analytics Properties can use up to 5,000 tokens per day; Analytics
+        #     360 Properties can use 50,000 tokens per day. An API request consumes a
+        #     single number of tokens, and that number is deducted from both the hourly
+        #     and daily quotas.
         # @!attribute [rw] concurrent_requests
         #   @return [::Google::Analytics::Data::V1alpha::QuotaStatus]
-        #     Analytics Properties can send up to 10 concurrent requests.
+        #     Standard Analytics Properties can send up to 10 concurrent requests;
+        #     Analytics 360 Properties can use up to 50 concurrent requests.
         # @!attribute [rw] server_errors_per_project_per_hour
         #   @return [::Google::Analytics::Data::V1alpha::QuotaStatus]
-        #     Analytics Properties and cloud project pairs can have up to 10
-        #     server errors per hour.
+        #     Standard Analytics Properties and cloud project pairs can have up to 10
+        #     server errors per hour; Analytics 360 Properties and cloud project pairs
+        #     can have up to 50 server errors per hour.
         class PropertyQuota
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -696,6 +780,9 @@ module Google
         #     dimension is available by either `apiName` or one of `deprecatedApiNames`
         #     for a period of time. After the deprecation period, the dimension will be
         #     available only by `apiName`.
+        # @!attribute [rw] custom_definition
+        #   @return [::Boolean]
+        #     True if the dimension is a custom dimension for this property.
         class DimensionMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -727,6 +814,9 @@ module Google
         #     The mathematical expression for this derived metric. Can be used in
         #     [Metric](#Metric)'s `expression` field for equivalent reports. Most metrics
         #     are not expressions, and for non-expressions, this field is empty.
+        # @!attribute [rw] custom_definition
+        #   @return [::Boolean]
+        #     True if the metric is a custom metric for this property.
         class MetricMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -764,8 +854,32 @@ module Google
           # A duration of seconds; a special floating point type.
           TYPE_SECONDS = 4
 
+          # A duration in milliseconds; a special floating point type.
+          TYPE_MILLISECONDS = 5
+
+          # A duration in minutes; a special floating point type.
+          TYPE_MINUTES = 6
+
+          # A duration in hours; a special floating point type.
+          TYPE_HOURS = 7
+
+          # A custom metric of standard type; a special floating point type.
+          TYPE_STANDARD = 8
+
           # An amount of money; a special floating point type.
           TYPE_CURRENCY = 9
+
+          # A length in feet; a special floating point type.
+          TYPE_FEET = 10
+
+          # A length in miles; a special floating point type.
+          TYPE_MILES = 11
+
+          # A length in meters; a special floating point type.
+          TYPE_METERS = 12
+
+          # A length in kilometers; a special floating point type.
+          TYPE_KILOMETERS = 13
         end
       end
     end