@google-analytics/data 2.7.0 → 3.0.2

package/build/protos/google/analytics/data/v1beta/data.proto

@@ -52,8 +52,8 @@ message MinuteRange {
   //
   // If unspecified, `startMinutesAgo` is defaulted to 29. Standard Analytics
   // properties can request up to the last 30 minutes of event data
-  // (`startMinutesAgo <= 29`), and 360 Analytics properties can request up to
-  // the last 60 minutes of event data (`startMinutesAgo <= 59`).
+  // (`startMinutesAgo <= 29`), and Google Analytics 360 properties can request
+  // up to the last 60 minutes of event data (`startMinutesAgo <= 59`).
   optional int32 start_minutes_ago = 1;
 
   // The inclusive end minute for the query as a number of minutes before now.
@@ -63,8 +63,8 @@ message MinuteRange {
   //
   // If unspecified, `endMinutesAgo` is defaulted to 0. Standard Analytics
   // properties can request any minute in the last 30 minutes of event data
-  // (`endMinutesAgo <= 29`), and 360 Analytics properties can request any
-  // minute in the last 60 minutes of event data (`endMinutesAgo <= 59`).
+  // (`endMinutesAgo <= 29`), and Google Analytics 360 properties can request
+  // any minute in the last 60 minutes of event data (`endMinutesAgo <= 59`).
   optional int32 end_minutes_ago = 2;
 
   // Assigns a name to this minute range. The dimension `dateRange` is valued to
@@ -87,7 +87,7 @@ message Dimension {
   // would like within the allowed character set. For example if a
   // `dimensionExpression` concatenates `country` and `city`, you could call
   // that dimension `countryAndCity`. Dimension names that you choose must match
-  // the regular expression "^[a-zA-Z0-9_]$".
+  // the regular expression `^[a-zA-Z0-9_]$`.
   //
   // Dimensions are referenced by `name` in `dimensionFilter`, `orderBys`,
   // `dimensionExpression`, and `pivots`.
@@ -152,7 +152,7 @@ message Metric {
   // within the allowed character set. For example if `expression` is
   // `screenPageViews/sessions`, you could call that metric's name =
   // `viewsPerSession`. Metric names that you choose must match the regular
-  // expression "^[a-zA-Z0-9_]$".
+  // expression `^[a-zA-Z0-9_]$`.
   //
   // Metrics are referenced by `name` in `metricFilter`, `orderBys`, and metric
   // `expression`.
@@ -555,9 +555,55 @@ message CohortReportSettings {
 
 // Response's metadata carrying additional information about the report content.
 message ResponseMetaData {
+  // The schema restrictions actively enforced in creating this report. To learn
+  // more, see [Access and data-restriction
+  // management](https://support.google.com/analytics/answer/10851388).
+  message SchemaRestrictionResponse {
+    // A metric actively restricted in creating the report.
+    message ActiveMetricRestriction {
+      // The name of the restricted metric.
+      optional string metric_name = 1;
+
+      // The reason for this metric's restriction.
+      repeated RestrictedMetricType restricted_metric_types = 2;
+    }
+
+    // All restrictions actively enforced in creating the report. For example,
+    // `purchaseRevenue` always has the restriction type `REVENUE_DATA`.
+    // However, this active response restriction is only populated if the user's
+    // custom role disallows access to `REVENUE_DATA`.
+    repeated ActiveMetricRestriction active_metric_restrictions = 1;
+  }
+
   // If true, indicates some buckets of dimension combinations are rolled into
   // "(other)" row. This can happen for high cardinality reports.
   bool data_loss_from_other_row = 3;
+
+  // Describes the schema restrictions actively enforced in creating this
+  // report. To learn more, see [Access and data-restriction
+  // management](https://support.google.com/analytics/answer/10851388).
+  optional SchemaRestrictionResponse schema_restriction_response = 4;
+
+  // The currency code used in this report. Intended to be used in formatting
+  // currency metrics like `purchaseRevenue` for visualization. If currency_code
+  // was specified in the request, this response parameter will echo the request
+  // parameter; otherwise, this response parameter is the property's current
+  // currency_code.
+  //
+  // Currency codes are string encodings of currency types from the ISO 4217
+  // standard (https://en.wikipedia.org/wiki/ISO_4217); for example "USD",
+  // "EUR", "JPY". To learn more, see
+  // https://support.google.com/analytics/answer/9796179.
+  optional string currency_code = 5;
+
+  // The property's current timezone. Intended to be used to interpret
+  // time-based dimensions like `hour` and `minute`. Formatted as strings from
+  // the IANA Time Zone database (https://www.iana.org/time-zones); for example
+  // "America/New_York" or "Asia/Tokyo".
+  optional string time_zone = 6;
+
+  // If empty reason is specified, the report is empty for this reason.
+  optional string empty_reason = 7;
 }
 
 // Describes a dimension column in the report. Dimensions requested in a report
@@ -744,6 +790,20 @@ message DimensionMetadata {
 
 // Explains a metric.
 message MetricMetadata {
+  // Justifications for why this metric is blocked.
+  enum BlockedReason {
+    // Will never be specified in API response.
+    BLOCKED_REASON_UNSPECIFIED = 0;
+
+    // If present, your access is blocked to revenue related metrics for this
+    // property, and this metric is revenue related.
+    NO_REVENUE_METRICS = 1;
+
+    // If present, your access is blocked to cost related metrics for this
+    // property, and this metric is cost related.
+    NO_COST_METRICS = 2;
+  }
+
   // A metric name. Useable in [Metric](#Metric)'s `name`. For example,
   // `eventCount`.
   string api_name = 1;
@@ -772,6 +832,16 @@ message MetricMetadata {
   // True if the metric is a custom metric for this property.
   bool custom_definition = 7;
 
+  // If reasons are specified, your access is blocked to this metric for this
+  // property. API requests from you to this property for this metric will
+  // succeed; however, the report will contain only zeros for this metric. API
+  // requests with metric filters on blocked metrics will fail. If reasons are
+  // empty, you have access to this metric.
+  //
+  // To learn more, see [Access and data-restriction
+  // management](https://support.google.com/analytics/answer/10851388).
+  repeated BlockedReason blocked_reasons = 8;
+
   // The display name of the category that this metrics belongs to. Similar
   // dimensions and metrics are categorized together.
   string category = 10;
@@ -861,6 +931,19 @@ enum MetricType {
   TYPE_KILOMETERS = 13;
 }
 
+// Categories of data that you may be restricted from viewing on certain GA4
+// properties.
+enum RestrictedMetricType {
+  // Unspecified type.
+  RESTRICTED_METRIC_TYPE_UNSPECIFIED = 0;
+
+  // Cost metrics such as `adCost`.
+  COST_DATA = 1;
+
+  // Revenue metrics such as `purchaseRevenue`.
+  REVENUE_DATA = 2;
+}
+
 // The compatibility types for a single dimension or metric.
 enum Compatibility {
   // Unspecified compatibility.