feat: add kind field which is used to distinguish between response types

Google APIs · copybara-github · commit 95dd24960cf9 · 2021-03-30T13:17:43.000-07:00
feat: add `potentially_thresholded_requests_per_hour` field to `PropertyQuota`

PiperOrigin-RevId: 365882072
diff --git a/google/analytics/data/v1beta/analytics_data_api.proto b/google/analytics/data/v1beta/analytics_data_api.proto
@@ -244,6 +244,11 @@ message RunReportResponse {
 
   // This Analytics Property's quota state including this request.
   PropertyQuota property_quota = 9;
+
+  // Identifies what kind of resource this message is. This `kind` is always the
+  // fixed string "analyticsData#runReport". Useful to distinguish between
+  // response types in JSON.
+  string kind = 10;
 }
 
 // The request to generate a pivot report.
@@ -369,6 +374,11 @@ message RunPivotReportResponse {
 
   // This Analytics Property's quota state including this request.
   PropertyQuota property_quota = 7;
+
+  // Identifies what kind of resource this message is. This `kind` is always the
+  // fixed string "analyticsData#runPivotReport". Useful to distinguish between
+  // response types in JSON.
+  string kind = 8;
 }
 
 // The batch request containing multiple report requests.
@@ -393,6 +403,11 @@ message BatchRunReportsRequest {
 message BatchRunReportsResponse {
   // Individual responses. Each response has a separate report request.
   repeated RunReportResponse reports = 1;
+
+  // Identifies what kind of resource this message is. This `kind` is always the
+  // fixed string "analyticsData#batchRunReports". Useful to distinguish between
+  // response types in JSON.
+  string kind = 2;
 }
 
 // The batch request containing multiple pivot report requests.
@@ -417,6 +432,11 @@ message BatchRunPivotReportsRequest {
 message BatchRunPivotReportsResponse {
   // Individual responses. Each response has a separate pivot report request.
   repeated RunPivotReportResponse pivot_reports = 1;
+
+  // Identifies what kind of resource this message is. This `kind` is always the
+  // fixed string "analyticsData#batchRunPivotReports". Useful to distinguish
+  // between response types in JSON.
+  string kind = 2;
 }
 
 // Request for a property's dimension and metric metadata.
@@ -519,4 +539,9 @@ message RunRealtimeReportResponse {
 
   // This Analytics Property's Realtime quota state including this request.
   PropertyQuota property_quota = 8;
+
+  // Identifies what kind of resource this message is. This `kind` is always the
+  // fixed string "analyticsData#runRealtimeReport". Useful to distinguish
+  // between response types in JSON.
+  string kind = 9;
 }
diff --git a/google/analytics/data/v1beta/data.proto b/google/analytics/data/v1beta/data.proto
@@ -381,8 +381,8 @@ message Pivot {
   int64 offset = 3;
 
   // The number of unique combinations of dimension values to return in this
-  // pivot. If unspecified, up to 10,000 unique combinations of dimension values
-  // are returned. `limit` must be positive.
+  // pivot. The `limit` parameter is required. A `limit` of 10,000 is common for
+  // single pivot requests.
   //
   // The product of the `limit` for each `pivot` in a `RunPivotReportRequest`
   // must not exceed 100,000. For example, a two pivot request with `limit:
@@ -667,6 +667,12 @@ message PropertyQuota {
   // server errors per hour; Analytics 360 Properties and cloud project pairs
   // can have up to 50 server errors per hour.
   QuotaStatus server_errors_per_project_per_hour = 4;
+
+  // Analytics Properties can send up to 120 requests with potentially
+  // thresholded dimensions per hour. In a batch request, each report request
+  // is individually counted for this quota if the request contains potentially
+  // thresholded dimensions.
+  QuotaStatus potentially_thresholded_requests_per_hour = 5;
 }
 
 // Current state for a particular quota group.
