google-analytics-data-v1alpha 0.1.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f35e825d5c952314987ebc573bc42c593da6d4fcef5d92f214bbd1b38c072e3
-  data.tar.gz: 3ea3956052db10fd5f8847df581c4c608eb004094c8c7e4937d34b08e09a0247
+  metadata.gz: 46a4a35fe96d97d0e55469823d63d565fad0d23c91ec695e4900dd026dac33c2
+  data.tar.gz: 4fb8b75aa1d11f18617f9667010111ac548a77cd304e1d9e4522e9f3e395138d
 SHA512:
-  metadata.gz: e8af6266cc1c1d6c60eb17d8ca1655b19bf4c83f86fe4c44943cc9c97ad42baa7fa1db868400851ef8cac6b5c479fc2f6449a06ed4dc70a6c7f81590313e9199
-  data.tar.gz: 6a9229c5a63f5307d31dfaa92991c498b2a9ce45d93ef383e1711cfcbd208c3b642811c653dc514b69e65957f038eae4e33cea31d1bc8fce335be97c27e0f00c
+  metadata.gz: 88e10c1f978a46c7e3417bc54941af2a6dc1d8c04b01ec296dc0b868f01b606dfa7c37206a2ce71a12051364c43650e78e47e7863042d88552ccf375a0683771
+  data.tar.gz: ae84293ce9806270947f602b06f98b16cfae7435ad075a7672ef7de96e111cda55793e309971c7c79c5a4bb9e2aad2af593625f59691d4356b31f7e3d37a1ccc

data/lib/google/analytics/data/v1alpha/analytics_data/client.rb

@@ -199,9 +199,15 @@ module Google
             #     must be unspecified.
             #   @param offset [::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](basics#pagination).
             #   @param limit [::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](basics#pagination).
             #   @param metric_aggregations [::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)".
@@ -504,8 +510,15 @@ module Google
 
             ##
             # 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.
+            # Used to explore the dimensions and metrics. In this method, a Google
+            # Analytics GA4 Property Identifier is specified in the request, and
+            # the metadata response includes Custom dimensions and metrics as well as
+            # Universal metadata.
+            #
+            # For example if a custom metric with parameter name `levels_unlocked` is
+            # registered to a property, the Metadata response will contain
+            # `customEvent:levels_unlocked`. Universal metadata are dimensions and
+            # metrics applicable to any property such as `country` and `totalUsers`.
             #
             # @overload get_metadata(request, options = nil)
             #   Pass arguments to `get_metadata` via a request object, either of type
@@ -523,10 +536,17 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the metadata to retrieve. Either has the form
-            #     'metadata' or 'properties/\\{property}/metadata'. This name field is
+            #     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 App + Web Property Id.
+            #     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
+            #
+            #     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.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Analytics::Data::V1alpha::Metadata]
@@ -573,6 +593,101 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # The Google Analytics Realtime API returns a customized report of realtime
+            # event data for your property. These reports show events and usage from the
+            # last 30 minutes.
+            #
+            # @overload run_realtime_report(request, options = nil)
+            #   Pass arguments to `run_realtime_report` via a request object, either of type
+            #   {::Google::Analytics::Data::V1alpha::RunRealtimeReportRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Analytics::Data::V1alpha::RunRealtimeReportRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload run_realtime_report(property: nil, dimensions: nil, metrics: nil, limit: nil, dimension_filter: nil, metric_filter: nil, metric_aggregations: nil, order_bys: nil, return_property_quota: nil)
+            #   Pass arguments to `run_realtime_report` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param property [::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/trusted-testing/analytics-data/property-id).
+            #
+            #     Example: properties/1234
+            #   @param dimensions [::Array<::Google::Analytics::Data::V1alpha::Dimension, ::Hash>]
+            #     The dimensions requested and displayed.
+            #   @param metrics [::Array<::Google::Analytics::Data::V1alpha::Metric, ::Hash>]
+            #     The metrics requested and displayed.
+            #   @param limit [::Integer]
+            #     The number of rows to return. If unspecified, 10 rows are returned. If
+            #     -1, all rows are returned.
+            #   @param dimension_filter [::Google::Analytics::Data::V1alpha::FilterExpression, ::Hash]
+            #     The filter clause of dimensions. Dimensions must be requested to be used in
+            #     this filter. Metrics cannot be used in this filter.
+            #   @param metric_filter [::Google::Analytics::Data::V1alpha::FilterExpression, ::Hash]
+            #     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.
+            #   @param metric_aggregations [::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)".
+            #   @param order_bys [::Array<::Google::Analytics::Data::V1alpha::OrderBy, ::Hash>]
+            #     Specifies how rows are ordered in the response.
+            #   @param return_property_quota [::Boolean]
+            #     Toggles whether to return the current state of this Analytics Property's
+            #     Realtime quota. Quota is returned in [PropertyQuota](#PropertyQuota).
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Analytics::Data::V1alpha::RunRealtimeReportResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Analytics::Data::V1alpha::RunRealtimeReportResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def run_realtime_report request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Analytics::Data::V1alpha::RunRealtimeReportRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.run_realtime_report.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Analytics::Data::V1alpha::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {
+                "property" => request.property
+              }
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.run_realtime_report.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.run_realtime_report.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @analytics_data_stub.call_rpc :run_realtime_report, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the AnalyticsData API.
             #
@@ -734,6 +849,11 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :get_metadata
+                ##
+                # RPC-specific configuration for `run_realtime_report`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :run_realtime_report
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -747,6 +867,8 @@ module Google
                   @batch_run_pivot_reports = ::Gapic::Config::Method.new batch_run_pivot_reports_config
                   get_metadata_config = parent_rpcs&.get_metadata if parent_rpcs&.respond_to? :get_metadata
                   @get_metadata = ::Gapic::Config::Method.new get_metadata_config
+                  run_realtime_report_config = parent_rpcs&.run_realtime_report if parent_rpcs&.respond_to? :run_realtime_report
+                  @run_realtime_report = ::Gapic::Config::Method.new run_realtime_report_config
 
                   yield self if block_given?
                 end

data/lib/google/analytics/data/v1alpha/analytics_data/paths.rb

@@ -27,32 +27,15 @@ module Google
             ##
             # Create a fully-qualified Metadata resource string.
             #
-            # @overload metadata_path()
-            #   The resource will be in the following format:
+            # The resource will be in the following format:
             #
-            #   `metadata`
+            # `properties/{property}/metadata`
             #
-            # @overload metadata_path(property:)
-            #   The resource will be in the following format:
-            #
-            #   `properties/{property}/metadata`
-            #
-            #   @param property [String]
+            # @param property [String]
             #
             # @return [::String]
-            def metadata_path **args
-              resources = {
-                ""         => (proc do
-                  "metadata"
-                end),
-                "property" => (proc do |property:|
-                  "properties/#{property}/metadata"
-                end)
-              }
-
-              resource = resources[args.keys.sort.join(":")]
-              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
-              resource.call(**args)
+            def metadata_path property:
+              "properties/#{property}/metadata"
             end
 
             extend self

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

@@ -38,6 +38,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :totals, :message, 8, "google.analytics.data.v1alpha.Row"
       repeated :maximums, :message, 9, "google.analytics.data.v1alpha.Row"
       repeated :minimums, :message, 10, "google.analytics.data.v1alpha.Row"
+      optional :row_count, :int32, 12
       optional :metadata, :message, 6, "google.analytics.data.v1alpha.ResponseMetaData"
       optional :property_quota, :message, 7, "google.analytics.data.v1alpha.PropertyQuota"
     end
@@ -80,6 +81,27 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.analytics.data.v1alpha.GetMetadataRequest" do
       optional :name, :string, 1
     end
+    add_message "google.analytics.data.v1alpha.RunRealtimeReportRequest" do
+      optional :property, :string, 1
+      repeated :dimensions, :message, 2, "google.analytics.data.v1alpha.Dimension"
+      repeated :metrics, :message, 3, "google.analytics.data.v1alpha.Metric"
+      optional :limit, :int64, 4
+      optional :dimension_filter, :message, 5, "google.analytics.data.v1alpha.FilterExpression"
+      optional :metric_filter, :message, 6, "google.analytics.data.v1alpha.FilterExpression"
+      repeated :metric_aggregations, :enum, 7, "google.analytics.data.v1alpha.MetricAggregation"
+      repeated :order_bys, :message, 8, "google.analytics.data.v1alpha.OrderBy"
+      optional :return_property_quota, :bool, 9
+    end
+    add_message "google.analytics.data.v1alpha.RunRealtimeReportResponse" do
+      repeated :dimension_headers, :message, 1, "google.analytics.data.v1alpha.DimensionHeader"
+      repeated :metric_headers, :message, 2, "google.analytics.data.v1alpha.MetricHeader"
+      repeated :rows, :message, 3, "google.analytics.data.v1alpha.Row"
+      repeated :totals, :message, 4, "google.analytics.data.v1alpha.Row"
+      repeated :maximums, :message, 5, "google.analytics.data.v1alpha.Row"
+      repeated :minimums, :message, 6, "google.analytics.data.v1alpha.Row"
+      optional :row_count, :int32, 7
+      optional :property_quota, :message, 8, "google.analytics.data.v1alpha.PropertyQuota"
+    end
   end
 end
 
@@ -97,6 +119,8 @@ module Google
         BatchRunPivotReportsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.BatchRunPivotReportsRequest").msgclass
         BatchRunPivotReportsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.BatchRunPivotReportsResponse").msgclass
         GetMetadataRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.GetMetadataRequest").msgclass
+        RunRealtimeReportRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.RunRealtimeReportRequest").msgclass
+        RunRealtimeReportResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.analytics.data.v1alpha.RunRealtimeReportResponse").msgclass
       end
     end
   end

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

@@ -54,9 +54,20 @@ module Google
             # Entity.
             rpc :BatchRunPivotReports, ::Google::Analytics::Data::V1alpha::BatchRunPivotReportsRequest, ::Google::Analytics::Data::V1alpha::BatchRunPivotReportsResponse
             # 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.
+            # Used to explore the dimensions and metrics. In this method, a Google
+            # Analytics GA4 Property Identifier is specified in the request, and
+            # the metadata response includes Custom dimensions and metrics as well as
+            # Universal metadata.
+            #
+            # For example if a custom metric with parameter name `levels_unlocked` is
+            # registered to a property, the Metadata response will contain
+            # `customEvent:levels_unlocked`. Universal metadata are dimensions and
+            # metrics applicable to any property such as `country` and `totalUsers`.
             rpc :GetMetadata, ::Google::Analytics::Data::V1alpha::GetMetadataRequest, ::Google::Analytics::Data::V1alpha::Metadata
+            # The Google Analytics Realtime API returns a customized report of realtime
+            # event data for your property. These reports show events and usage from the
+            # last 30 minutes.
+            rpc :RunRealtimeReport, ::Google::Analytics::Data::V1alpha::RunRealtimeReportRequest, ::Google::Analytics::Data::V1alpha::RunRealtimeReportResponse
           end
 
           Stub = Service.rpc_stub_class

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

@@ -224,7 +224,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :TYPE_INTEGER, 1
       value :TYPE_FLOAT, 2
       value :TYPE_SECONDS, 4
+      value :TYPE_MILLISECONDS, 5
+      value :TYPE_MINUTES, 6
+      value :TYPE_HOURS, 7
+      value :TYPE_STANDARD, 8
       value :TYPE_CURRENCY, 9
+      value :TYPE_FEET, 10
+      value :TYPE_MILES, 11
+      value :TYPE_METERS, 12
+      value :TYPE_KILOMETERS, 13
     end
   end
 end

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

@@ -21,7 +21,7 @@ module Google
   module Analytics
     module Data
       module V1alpha
-        VERSION = "0.1.0"
+        VERSION = "0.5.0"
       end
     end
   end

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

@@ -27,7 +27,7 @@ module Google
         #     Resource name of this metadata.
         # @!attribute [rw] dimensions
         #   @return [::Array<::Google::Analytics::Data::V1alpha::DimensionMetadata>]
-        #     The dimensions descriptions.
+        #     The dimension descriptions.
         # @!attribute [rw] metrics
         #   @return [::Array<::Google::Analytics::Data::V1alpha::MetricMetadata>]
         #     The metric descriptions.
@@ -57,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](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](basics#pagination).
         # @!attribute [rw] metric_aggregations
         #   @return [::Array<::Google::Analytics::Data::V1alpha::MetricAggregation>]
         #     Aggregation of metrics. Aggregated metric values will be shown in rows
@@ -120,6 +126,15 @@ module Google
         # @!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.
+        #
+        #     To learn more about this pagination parameter, see
+        #     [Pagination](basics#pagination).
         # @!attribute [rw] metadata
         #   @return [::Google::Analytics::Data::V1alpha::ResponseMetaData]
         #     Metadata for the report.
@@ -304,17 +319,103 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request for dimension and metric metadata.
+        # Request for a property's dimension and metric metadata.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The name of the metadata to retrieve. Either has the form
-        #     'metadata' or 'properties/\\{property}/metadata'. This name field is
+        #     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 App + Web Property Id.
+        #     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
+        #
+        #     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 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/trusted-testing/analytics-data/property-id).
+        #
+        #     Example: properties/1234
+        # @!attribute [rw] dimensions
+        #   @return [::Array<::Google::Analytics::Data::V1alpha::Dimension>]
+        #     The dimensions requested and displayed.
+        # @!attribute [rw] metrics
+        #   @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
       end
     end
   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/trusted-testing/analytics-data/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/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` 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/trusted-testing/analytics-data/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.
@@ -556,7 +580,9 @@ module Google
         #     combinations.
         # @!attribute [rw] row_count
         #   @return [::Integer]
-        #     The cardinality of the pivot as if offset = 0 and limit = -1.
+        #     The cardinality of the pivot as if offset = 0 and limit = -1. The total
+        #     number of rows for this pivot's fields regardless of how the parameters
+        #     offset and limit are specified in the request.
         class PivotHeader
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -575,28 +601,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>]
@@ -645,20 +681,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
@@ -762,8 +802,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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-analytics-data-v1alpha
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-18 00:00:00.000000000 Z
+date: 2020-11-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common