docs: specify the data sources supported only by the QueryData API

Google APIs · copybara-github · commit 884065f16380 · 2025-12-15T18:48:56.000-08:00
PiperOrigin-RevId: 845011156
diff --git a/google/cloud/geminidataanalytics/v1alpha/datasource.proto b/google/cloud/geminidataanalytics/v1alpha/datasource.proto
@@ -53,22 +53,27 @@ message DatasourceReferences {
     // References to Looker Explores.
     LookerExploreReferences looker = 3;
 
-    // Reference to an AlloyDB database.
+    // Reference to an AlloyDB database. Only supported for the `QueryData`
+    // method.
     AlloyDbReference alloydb = 8;
 
-    // Reference to a Spanner database.
+    // Reference to a Spanner database. Only supported for the `QueryData`
+    // method.
     SpannerReference spanner_reference = 9;
 
-    // Reference to a CloudSql database.
+    // Reference to a CloudSql database. Only supported for the `QueryData`
+    // method.
     CloudSqlReference cloud_sql_reference = 10;
   }
 }
 
-// Message representing references to BigQuery tables.
+// Message representing references to BigQuery tables and property graphs.
+// At least one of `table_references` or `property_graph_references` must be
+// populated.
 message BigQueryTableReferences {
-  // Required. References to BigQuery tables.
+  // Optional. References to BigQuery tables.
   repeated BigQueryTableReference table_references = 1
-      [(google.api.field_behavior) = REQUIRED];
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Message representing a reference to a single BigQuery table.
@@ -99,6 +104,7 @@ message StudioDatasourceReference {
 }
 
 // Message representing reference to an AlloyDB database and agent context.
+// Only supported for the `QueryData` method.
 message AlloyDbReference {
   // Required. Singular proto that supports specifying which database and tables
   // to include.
@@ -132,6 +138,7 @@ message AlloyDbDatabaseReference {
 }
 
 // Message representing reference to a Spanner database and agent context.
+// Only supported for the `QueryData` method.
 message SpannerReference {
   // Required. Singular proto that supports specifying which database and tables
   // to include.
@@ -177,6 +184,7 @@ message SpannerDatabaseReference {
 }
 
 // Message representing reference to a CloudSQL database and agent context.
+// Only supported for the `QueryData` method.
 message CloudSqlReference {
   // Required. Singular proto that supports specifying which database and tables
   // to include.
