@google-analytics/data 7.0.0 → 7.2.0

package/build/protos/google/analytics/data/v1alpha/analytics_data_api.proto

@@ -38,6 +38,7 @@ service AlphaAnalyticsData {
   option (google.api.default_host) = "analyticsdata.googleapis.com";
   option (google.api.oauth_scopes) =
       "https://www.googleapis.com/auth/analytics,"
+      "https://www.googleapis.com/auth/analytics.chatbot.read,"
       "https://www.googleapis.com/auth/analytics.readonly";
 
   // Returns a customized funnel report of your Google Analytics event data. The
@@ -301,6 +302,24 @@ service AlphaAnalyticsData {
     option (google.api.method_signature) = "parent";
   }
 
+  // Provides a chat interface for interacting with Google Analytics data
+  // through the API.
+  //
+  // This product uses AI and may display inaccurate info. Your chat activity
+  // may be used to improve the product and your use is subject to Google's
+  // [Terms](https://policies.google.com/terms),
+  // [AI Use
+  // Policy](https://policies.google.com/terms/generative-ai/use-policy), and
+  // [Privacy Policy](https://policies.google.com/privacy).
+  // [Learn more about Chat AI
+  // Privacy](https://support.google.com/helpguide/answer/14185196).
+  rpc Chat(ChatRequest) returns (ChatResponse) {
+    option (google.api.http) = {
+      post: "/v1alpha/{property=properties/*}:chat"
+      body: "*"
+    };
+  }
+
   // Returns a customized report of your Google Analytics event data. Reports
   // contain statistics derived from data collected by the Google Analytics
   // tracking code. The data returned from the API is as a table with columns
@@ -1240,6 +1259,45 @@ message ListReportTasksResponse {
   optional string next_page_token = 2;
 }
 
+// Request message for the Chat method.
+message ChatRequest {
+  // Required. The property to chat about.
+  // Format: properties/{property}
+  string property = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "analyticsadmin.googleapis.com/Property"
+    }
+  ];
+
+  // Required. The user's query.
+  string user_query = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Provide this session ID to continue an existing conversation
+  // and maintain context. If this field is empty or unset, a new chat
+  // session is created. Invalid session IDs will result in an error.
+  optional string session_id = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If true, the response will include the current state of this
+  // Analytics Property's quota. Quota is returned in
+  // [PropertyChatQuota](#PropertyChatQuota).
+  bool return_property_quota = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for the Chat method.
+message ChatResponse {
+  // The unique identifier for this chat session. Provide this ID in subsequent
+  // requests to maintain conversational context.
+  string session_id = 1;
+
+  // The response blocks that make up the chat response. This can include text,
+  // tables, and lists.
+  repeated ResponseBlock blocks = 2;
+
+  // This Analytics Property's quota state including this request.
+  PropertyChatQuota property_quota = 3;
+}
+
 // The request to generate a report.
 message RunReportRequest {
   // Required. A Google Analytics property identifier whose events are tracked.

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

@@ -546,6 +546,73 @@ message ResponseMetaData {
     repeated ActiveMetricRestriction active_metric_restrictions = 1;
   }
 
+  // Describes a reason for data truncation in the report.
+  message DataTruncationReason {
+    // The type of data truncation.
+    enum DataTruncationType {
+      // Unspecified type.
+      DATA_TRUNCATION_TYPE_UNSPECIFIED = 0;
+
+      // Data is truncated in attribution report for rules-based models golden
+      // date.
+      DATA_TRUNCATION_TYPE_RULES_BASED_MODELS = 1;
+
+      // Data is truncated in attribution report for data driven attribution
+      // golden date.
+      DATA_TRUNCATION_TYPE_DATA_DRIVEN_ATTRIBUTION = 2;
+
+      // Data is truncated because DV360 policy does not permit data older than
+      // 2 years from being returned.
+      DATA_TRUNCATION_TYPE_DV360 = 3;
+
+      // Data is truncated because CM360 policy does not permit data older than
+      // 2 years from being returned.
+      DATA_TRUNCATION_TYPE_CM360 = 4;
+
+      // New item-scoped ecommerce metrics only have data after a specific date.
+      DATA_TRUNCATION_TYPE_ITEM_SCOPED_ECOMMERCE_METRICS = 5;
+
+      // New event-scoped ecommerce metrics only have data after a specific
+      // date.
+      DATA_TRUNCATION_TYPE_EVENT_SCOPED_ECOMMERCE_METRICS = 6;
+
+      // Query date range may not be fully served.
+      DATA_TRUNCATION_TYPE_DATE_RANGE = 7;
+
+      // Data truncated because the query attempts to read event data prior
+      // to its retention date.
+      DATA_TRUNCATION_TYPE_PROPERTY = 8;
+
+      // Data is truncated in conversions report.
+      DATA_TRUNCATION_TYPE_CONVERSIONS = 9;
+
+      // Data is truncated due to Google Ads 36 month retention policy.
+      DATA_TRUNCATION_TYPE_GOOGLE_ADS = 10;
+    }
+
+    // Define the truncated date range from start_date to end_date.
+    message DataTruncationDateRange {
+      // The start date in the format YYYY-MM-DD (inclusive).
+      optional string start_date = 1;
+
+      // The end date in the format YYYY-MM-DD (inclusive).
+      optional string end_date = 2;
+    }
+
+    // The type of data truncation.
+    optional DataTruncationType data_truncation_type = 1;
+
+    // A descriptive message explaining the data truncation.
+    optional string data_truncation_message = 2;
+
+    // The data truncation date in the format YYYY-MM-DD.
+    // Indicates data before this date is truncated.
+    optional string data_truncation_date = 3;
+
+    // The truncated date ranges.
+    repeated DataTruncationDateRange data_truncation_date_ranges = 4;
+  }
+
   // If true, indicates some buckets of dimension combinations are rolled into
   // "(other)" row. This can happen for high cardinality reports.
   //
@@ -610,6 +677,9 @@ message ResponseMetaData {
 
   // Identifies the type of data in the report.
   Section section = 10;
+
+  // If set, indicate there is data truncation in the report.
+  repeated DataTruncationReason data_truncation_reasons = 11;
 }
 
 // Describes a dimension column in the report. Dimensions requested in a report
@@ -849,6 +919,49 @@ message FunnelSubReport {
   FunnelResponseMetadata metadata = 4;
 }
 
+// One block of structured data in chat response.
+message ResponseBlock {
+  // A cell in a data table.
+  message DataTableCell {
+    // The value of the cell.
+    string value = 1;
+  }
+
+  // Describes a column header in a DataTable.
+  message DataTableHeader {
+    // The header name.
+    string header = 1;
+
+    // The data type.
+    string data_type = 2;
+  }
+
+  // A row in a DataTable.
+  message DataTableRow {
+    // The cell values in the row.
+    repeated DataTableCell columns = 1;
+  }
+
+  // A table of data.
+  message DataTable {
+    // Describes dimension columns. The number of headers and ordering of
+    // headers matches the dimensions present in rows.
+    repeated DataTableHeader headers = 1;
+
+    // Rows of dimension value combinations and metric values in the report.
+    repeated DataTableRow rows = 2;
+  }
+
+  // One block of structured data.
+  oneof block {
+    // A block of text.
+    string text = 1;
+
+    // A block of table data.
+    DataTable table = 2;
+  }
+}
+
 // User segments are subsets of users who engaged with your site or app. For
 // example, users who have previously purchased; users who added items to their
 // shopping carts, but didn’t complete a purchase.
@@ -1812,3 +1925,12 @@ message ConversionMetadata {
   // This conversion's name within the Google Analytics user interface.
   string display_name = 2;
 }
+
+// Property quota for chatbot specific fields.
+message PropertyChatQuota {
+  // Chat tokens consumed per day.
+  QuotaStatus tokens_per_day = 1;
+
+  // Chat tokens consumed per hour.
+  QuotaStatus tokens_per_hour = 2;
+}

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -622,6 +622,73 @@ message ResponseMetaData {
     repeated ActiveMetricRestriction active_metric_restrictions = 1;
   }
 
+  // Describes a reason for data truncation in the report.
+  message DataTruncationReason {
+    // The type of data truncation.
+    enum DataTruncationType {
+      // Unspecified type.
+      DATA_TRUNCATION_TYPE_UNSPECIFIED = 0;
+
+      // Data is truncated in attribution report for rules-based models golden
+      // date.
+      DATA_TRUNCATION_TYPE_RULES_BASED_MODELS = 1;
+
+      // Data is truncated in attribution report for data driven attribution
+      // golden date.
+      DATA_TRUNCATION_TYPE_DATA_DRIVEN_ATTRIBUTION = 2;
+
+      // Data is truncated because DV360 policy does not permit data older than
+      // 2 years from being returned.
+      DATA_TRUNCATION_TYPE_DV360 = 3;
+
+      // Data is truncated because CM360 policy does not permit data older than
+      // 2 years from being returned.
+      DATA_TRUNCATION_TYPE_CM360 = 4;
+
+      // New item-scoped ecommerce metrics only have data after a specific date.
+      DATA_TRUNCATION_TYPE_ITEM_SCOPED_ECOMMERCE_METRICS = 5;
+
+      // New event-scoped ecommerce metrics only have data after a specific
+      // date.
+      DATA_TRUNCATION_TYPE_EVENT_SCOPED_ECOMMERCE_METRICS = 6;
+
+      // Query date range may not be fully served.
+      DATA_TRUNCATION_TYPE_DATE_RANGE = 7;
+
+      // Data truncated because the query attempts to read event data prior
+      // to its retention date.
+      DATA_TRUNCATION_TYPE_PROPERTY = 8;
+
+      // Data is truncated in conversions report.
+      DATA_TRUNCATION_TYPE_CONVERSIONS = 9;
+
+      // Data is truncated due to Google Ads 36 month retention policy.
+      DATA_TRUNCATION_TYPE_GOOGLE_ADS = 10;
+    }
+
+    // Define the truncated date range from start_date to end_date.
+    message DataTruncationDateRange {
+      // The start date in the format YYYY-MM-DD (inclusive).
+      optional string start_date = 1;
+
+      // The end date in the format YYYY-MM-DD (inclusive).
+      optional string end_date = 2;
+    }
+
+    // The type of data truncation.
+    optional DataTruncationType data_truncation_type = 1;
+
+    // A descriptive message explaining the data truncation.
+    optional string data_truncation_message = 2;
+
+    // The data truncation date in the format YYYY-MM-DD.
+    // Indicates data before this date is truncated.
+    optional string data_truncation_date = 3;
+
+    // The truncated date ranges.
+    repeated DataTruncationDateRange data_truncation_date_ranges = 4;
+  }
+
   // If true, indicates some buckets of dimension combinations are rolled into
   // "(other)" row. This can happen for high cardinality reports.
   //
@@ -681,6 +748,9 @@ message ResponseMetaData {
   //
   // However if the results are not sampled, this field will not be defined.
   repeated SamplingMetadata sampling_metadatas = 9;
+
+  // If set, indicate there is data truncation in the report.
+  repeated DataTruncationReason data_truncation_reasons = 10;
 }
 
 // If this report results is