Classes
A2AArtifact
A2AArtifact is the container for task completed results.
A2AMessage
A2AMessage is one unit of communication between client and server.
A2ATask
A2ATask is the core unit of action for A2A. It has a current status and when results are created for the task they are stored in the artifact. If there are multiple turns for a task, these are stored in history.
APIKeySecurityScheme
APIKeySecurityScheme defines an API key security scheme.
AgentCapabilities
Defines the A2A feature set supported by the agent.
AgentCard
AgentCard conveys key information about an agent.
AgentCardSignature
AgentCardSignature represents a JWS signature of an AgentCard.
AgentContextReference
Message representing a reference to Agent Context.
AgentExtension
A declaration of an extension supported by an Agent.
AgentInterface
Defines additional transport information for the agent.
AgentProvider
Represents information about the service provider of an agent.
AgentSkill
AgentSkill represents a unit of action/solution that the agent can perform.
AlloyDbDatabaseReference
Message representing a reference to a single AlloyDB database.
AlloyDbReference
Message representing reference to an AlloyDB database and agent context.
Only supported for the QueryData method.
AnalysisEvent
An event indicating the progress of an analysis.
AnalysisMessage
A message produced during analysis.
AnalysisOptions
Options for analysis.
AnalysisOptions.Types
Container for nested types declared in the AnalysisOptions message type.
AnalysisOptions.Types.Python
Options for Python analysis.
AnalysisQuery
A query for performing an analysis.
AuthenticationInfo
Defines authentication details, used for push notifications.
AuthorizationCodeOAuthFlow
AuthorizationCodeOAuthFlow defines an authorization code OAuth flow.
BigQueryJob
A BigQuery job executed by the system.
BigQueryPropertyGraphReference
Message representing a reference to a single BigQuery property graph.
BigQueryRoutine
A reference to a BigQuery routine.
BigQueryRoutineReference
A reference to a BigQuery routine.
BigQueryTableReference
Message representing a reference to a single BigQuery table.
BigQueryTableReferences
Message representing references to BigQuery tables and property graphs.
At least one of table_references, property_graph_references, or
search_scope must be populated.
BigtableDatabaseReference
Message representing reference to Bigtable database.
BigtableReference
Message representing reference to a Bigtable instance and agent context.
Blob
A blob of data with a MIME type.
ChartMessage
A message produced during chart generation.
ChartOptions
Options for chart generation.
ChartOptions.Types
Container for nested types declared in the ChartOptions message type.
ChartOptions.Types.ImageOptions
Options for rendering images of generated charts.
ChartOptions.Types.ImageOptions.Types
Container for nested types declared in the ImageOptions message type.
ChartOptions.Types.ImageOptions.Types.NoImage
No image.
ChartOptions.Types.ImageOptions.Types.SvgOptions
SVG options.
ChartQuery
A query for generating a chart.
ChartResult
The result of a chart generation query.
ChatRequest
Request for Chat.
ChatRequest.Types
Container for nested types declared in the ChatRequest message type.
Citation
Source attributions for content.
CitationAnchor
The anchor of the citation.
CitationAnchor.Types
Container for nested types declared in the CitationAnchor message type.
CitationAnchor.Types.TextMessageCitationAnchor
Citation anchor within a TextMessage.
CitationSource
The source of the citation.
ClarificationMessage
Deprecated: Use TextMessage with TextType.FINAL_RESPONSE instead. A message of questions to help clarify the user's query. This is returned when the system cannot confidently answer the user's question.
ClarificationQuestion
Deprecated: Use TextMessage with TextType.FINAL_RESPONSE instead. Represents a single question to the user to help clarify their query.
ClarificationQuestion.Types
Container for nested types declared in the ClarificationQuestion message type.
ClientCredentialsOAuthFlow
ClientCredentialsOAuthFlow defines a client credentials OAuth flow.
ClientManagedResourceContext
Context with client managed resources. Some clients may not use GDA managed resources including conversations and agents, instead they create and manage their own conversations and agents resources.
CloudSqlDatabaseReference
Message representing a reference to a single CloudSQL database.
CloudSqlDatabaseReference.Types
Container for nested types declared in the CloudSqlDatabaseReference message type.
CloudSqlReference
Message representing reference to a CloudSQL database and agent context.
Only supported for the QueryData method.
Context
A collection of context to apply to this conversation
Context.Types
Container for nested types declared in the Context message type.
Context.Types.SchemaRelationship
The relationship between two tables, including referencing and referenced columns. This is a derived context retrieved from Dataplex Dataset Insights.
Context.Types.SchemaRelationship.Types
Container for nested types declared in the SchemaRelationship message type.
Context.Types.SchemaRelationship.Types.SchemaPaths
Represents an ordered set of paths within the table schema.
Conversation
Message for a conversation.
ConversationName
Resource name for the Conversation resource.
ConversationOptions
Options for the conversation.
ConversationOptions.Types
Container for nested types declared in the ConversationOptions message type.
ConversationReference
Reference to a persisted conversation and agent context.
CreateConversationRequest
Request for creating a conversation.
CreateDataAgentRequest
Message for creating a DataAgent.
Credentials
Represents different forms of credential specification.
CryptoKeyName
Resource name for the CryptoKey resource.
DataA2AService
DataA2AService defines the Agent-to-Agent (A2A) protocol service for Gemini Data Analytics.
DataA2AService.DataA2AServiceBase
Base class for server-side implementations of DataA2AService
DataA2AService.DataA2AServiceClient
Client for DataA2AService
DataA2AServiceClient
DataA2AService client wrapper, for convenient use.
DataA2AServiceClient.SendStreamingMessageStream
Server streaming methods for SendStreamingMessage(SendMessageRequest, CallSettings).
DataA2AServiceClientBuilder
Builder class for DataA2AServiceClient to provide simple configuration of credentials, endpoint etc.
DataA2AServiceClientImpl
DataA2AService client wrapper implementation, for convenient use.
DataA2AServiceSettings
Settings for DataA2AServiceClient instances.
DataAgent
Message describing a DataAgent object.
DataAgentContext
Context for the chat request using a data agent.
DataAgentContext.Types
Container for nested types declared in the DataAgentContext message type.
DataAgentName
Resource name for the DataAgent resource.
DataAgentService
Service describing handlers for resources.
DataAgentService.DataAgentServiceBase
Base class for server-side implementations of DataAgentService
DataAgentService.DataAgentServiceClient
Client for DataAgentService
DataAgentServiceClient
DataAgentService client wrapper, for convenient use.
DataAgentServiceClientBuilder
Builder class for DataAgentServiceClient to provide simple configuration of credentials, endpoint etc.
DataAgentServiceClientImpl
DataAgentService client wrapper implementation, for convenient use.
DataAgentServiceSettings
Settings for DataAgentServiceClient instances.
DataAnalyticsAgent
Message describing a DataAnalyticsAgent object.
DataChatService
Service to ask a natural language question on top of BigQuery and Looker Studio datasources to get back streamed responses of various kinds to help provide a rich conversational answer.
DataChatService.DataChatServiceBase
Base class for server-side implementations of DataChatService
DataChatService.DataChatServiceClient
Client for DataChatService
DataChatServiceClient
DataChatService client wrapper, for convenient use.
DataChatServiceClient.ChatStream
Server streaming methods for Chat(ChatRequest, CallSettings).
DataChatServiceClientBuilder
Builder class for DataChatServiceClient to provide simple configuration of credentials, endpoint etc.
DataChatServiceClientImpl
DataChatService client wrapper implementation, for convenient use.
DataChatServiceSettings
Settings for DataChatServiceClient instances.
DataFilter
A filter on a datasource's underlying data. Filter syntax documentation: https://cloud.google.com/looker/docs/filter-expressions
DataMessage
A message produced during data retrieval.
DataPart
DataPart represents a structured blob. This is most commonly a JSON payload.
DataQuery
A query for retrieving data.
DataResult
Retrieved data.
DatabaseTableReference
Message representing a table including its schema.
Datasource
A datasource that can be used to answer questions.
DatasourceOptions
Options for datasources configurations.
DatasourceReferences
A collection of references to datasources.
DeleteConversationRequest
Request for deleting a conversation based on parent and conversation id.
DeleteDataAgentRequest
Message for deleting a DataAgent.
DynamicField
A dynamic field in Looker (Custom Dimension, Custom Measure, or Table Calculation).
ErrorMessage
An error message from a tool call. This message is used to represent an error that occurred while an agent was trying to use a tool. It's important to note that not all errors are terminal. Many are recoverable, and the agent may use the information from this error message to self-correct and retry the tool call or try a different approach.
For example, if a data query fails, the agent might receive an
ErrorMessage, analyze it, and then generate a corrected query.
Clients should be cautious about interpreting this message as a definitive failure. It can be part of the agent's normal, iterative process of completing a task. Surfacing these errors directly to end-users without context (e.g., as a "hard failure") may be misleading.
ExampleQueries
A message containing derived and authored example queries.
ExampleQuery
Example of relevant and commonly used SQL query and its corresponding natural language queries optionally present. Currently only used for BigQuery data sources.
ExecutedQueryResult
The result of a query execution. The design is generic for all dialects.
ExecutedQueryResult.Types
Container for nested types declared in the ExecutedQueryResult message type.
ExecutedQueryResult.Types.Column
Describes a single column in the result set.
ExecutedQueryResult.Types.Row
Represents a single row in the result set.
ExecutedQueryResult.Types.Value
Represents a single value within a row.
Field
A field in a schema.
FilePart
FilePart represents the different ways files can be provided.
FirestoreDatabaseReference
Message representing a reference to a single Firestore database.
FirestoreReference
Message representing reference to a Firestore database and agent context.
GenerationOptions
Options to control query generation, execution, and response format.
GetAgentCardRequest
Request message for GetAgentCard.
GetConversationRequest
Request for getting a conversation based on parent and conversation id.
GetDataAgentRequest
Message for getting a DataAgent.
GlossaryTerm
Definition of a term within a specific domain.
HTTPAuthSecurityScheme
HTTPAuthSecurityScheme defines an HTTP authentication security scheme.
ImplicitOAuthFlow
ImplicitOAuthFlow defines an implicit OAuth flow.
ListAccessibleDataAgentsRequest
Message for requesting list of accessible DataAgents.
ListAccessibleDataAgentsRequest.Types
Container for nested types declared in the ListAccessibleDataAgentsRequest message type.
ListAccessibleDataAgentsResponse
Message for response to listing accessible DataAgents.
ListConversationsRequest
Request for listing conversations based on parent.
ListConversationsResponse
Message for response to listing conversations.
ListDataAgentsRequest
Message for requesting list of DataAgents.
ListDataAgentsResponse
Message for response to listing DataAgents.
ListMessagesRequest
Request for listing chat messages based on parent and conversation_id.
ListMessagesResponse
Response for listing chat messages.
LookerExploreReference
Message representing a reference to a single Looker explore.
LookerExploreReferences
Message representing references to Looker explores.
LookerGoldenQuery
A golden query for Looker, including natural language questions and a corresponding Looker Query. Analogous to ExampleQuery.
LookerQuery
Looker Query Object Looker API documentation.
LookerQuery.Types
Container for nested types declared in the LookerQuery message type.
LookerQuery.Types.Filter
A Looker query filter.
LookerSettings
Message to hold Looker specific custom settings.
MatchedQuery
A matched query message represents the agent having matched one of the example queries supplied in context as being applicable to the current question. It will also contain additional info during the matching process.
Message
A message from an interaction between the user and the system.
MutualTlsSecurityScheme
MutualTlsSecurityScheme defines a Mutual TLS security scheme.
OAuth2SecurityScheme
OAuth2SecurityScheme defines an OAuth2 security scheme.
OAuthCredentials
Represents OAuth credentials.
OAuthCredentials.Types
Container for nested types declared in the OAuthCredentials message type.
OAuthCredentials.Types.SecretBased
The name of the secret containing the access token. Represents secret-based OAuth credentials.
OAuthCredentials.Types.TokenBased
Read more about Looker access tokens here: https://developers.looker.com/api/advanced-usage/looker-api-oauth
OAuthFlows
OAuthFlows contains configuration information for supported OAuth flows.
OpenIdConnectSecurityScheme
OpenIdConnectSecurityScheme defines an OpenID Connect security scheme.
OperationMetadata
Represents the metadata of the long-running operation.
ParameterizedSecureViewParameters
Parameters for Parameterized Secure Views (PSV). These parameters are used to enforce row-level security during SQL generation and query execution.
ParameterizedSecureViewParameters.Types
Container for nested types declared in the ParameterizedSecureViewParameters message type.
ParameterizedSecureViewParameters.Types.Parameter
Represents a single parameter for Parameterized Secure Views.
Part
Part represents a container for a section of communication content. Parts can be purely textual, some sort of file (image, video, etc) or a structured data blob (i.e. JSON).
PasswordOAuthFlow
PasswordOAuthFlow defines a password OAuth flow.
PrivateLookerInstanceInfo
Message representing a private Looker instance info required if the Looker instance is behind a private network.
PushNotificationConfig
Configuration for setting up push notifications for task updates.
QueryDataContext
References to data sources and context to use for the query.
QueryDataRequest
Request to query data from a natural language query.
QueryDataResponse
Response containing the generated query and related information.
QueryParameter
A query parameter message represents a parameter that can be used to parameterize a SQL query.
QueryParameterValues
A query parameter values message represents the values for the query parameters that were extracted from the user question by LLM, based on the example query.
RetrieveAgentOpsObservabilityRequest
Request for RetrieveAgentOpsObservability.
RetrieveAgentOpsObservabilityResponse
Response for RetrieveAgentOpsObservability.
Schema
The schema of a Datasource or QueryResult instance.
SchemaMessage
A message produced during schema resolution.
SchemaQuery
A query for resolving the schema relevant to the posed question.
SchemaResult
The result of schema resolution.
Security
Security requirements for contacting the agent.
SecurityScheme
SecurityScheme defines a security scheme for contacting the agent.
SendMessageConfiguration
Configuration of a send message request.
SendMessageRequest
Request message for SendMessage and SendStreamingMessage.
SendMessageResponse
Response message for SendMessage.
SetAgentOpsObservabilityMetadata
Metadata for SetAgentOpsObservability.
SetAgentOpsObservabilityRequest
Request for SetAgentOpsObservability.
SetAgentOpsObservabilityResponse
Response for SetAgentOpsObservability.
SpannerDatabaseReference
Message representing a reference to a single Spanner database.
SpannerDatabaseReference.Types
Container for nested types declared in the SpannerDatabaseReference message type.
SpannerReference
Message representing reference to a Spanner database and agent context.
Only supported for the QueryData method.
StorageMessage
A stored message containing user message or system message.
StreamResponse
The stream response for a message.
StringList
StringList is a wrapper for a repeated list of strings.
StudioDatasourceReference
Message representing a reference to a single Looker Studio datasource.
StudioDatasourceReferences
Message representing references to Looker Studio datasources.
SystemMessage
A message from the system in response to the user. This message can also be a message from the user as historical context for multi-turn conversations with the system.
TaskArtifactUpdateEvent
TaskArtifactUpdateEvent represents a task delta where an artifact has been generated.
TaskStatus
A container for the status of a task.
TaskStatusUpdateEvent
TaskStatusUpdateEvent is a delta event on a task indicating that a task has changed.
TextMessage
A multi-part text message.
TextMessage.Types
Container for nested types declared in the TextMessage message type.
TokenUsage
Overall token usage tracking for the response.
UpdateConversationRequest
Request for updating a conversation.
UpdateDataAgentRequest
Message for updating a DataAgent.
UserFunctions
A collection of user functions to be included in context.
UserMessage
A message from the user that is interacting with the system.
Enums
AnalysisEvent.KindOneofCase
Enum of possible cases for the "kind" oneof.
AnalysisMessage.KindOneofCase
Enum of possible cases for the "kind" oneof.
ChartMessage.KindOneofCase
Enum of possible cases for the "kind" oneof.
ChartOptions.Types.ImageOptions.KindOneofCase
Enum of possible cases for the "kind" oneof.
ChatRequest.ContextProviderOneofCase
Enum of possible cases for the "context_provider" oneof.
ChatRequest.DatasourceSettingsOneofCase
Enum of possible cases for the "datasource_settings" oneof.
ChatRequest.Types.Model
Model selection for the agent for BigQuery users.
ChatRequest.Types.ThinkingMode
Mode of thinking for the agent.
CitationAnchor.AnchorTypeOneofCase
Enum of possible cases for the "anchor_type" oneof.
CitationSource.SourceTypeOneofCase
Enum of possible cases for the "source_type" oneof.
ClarificationQuestion.Types.ClarificationQuestionType
Deprecated: The parent message is deprecated. The type of clarification question. This enum may be extended with new values in the future.
ClarificationQuestion.Types.SelectionMode
Deprecated: The parent message is deprecated. The selection mode for the clarification question.
CloudSqlDatabaseReference.Types.Engine
The database engine.
Context.Types.SchemaRelationship.Types.Source
Source which generated the schema relation edge.
ConversationName.ResourceNameType
The possible contents of ConversationName.
ConversationOptions.Types.Model
Allowed models for the agent/conversation.
Credentials.KindOneofCase
Enum of possible cases for the "kind" oneof.
CryptoKeyName.ResourceNameType
The possible contents of CryptoKeyName.
DataAgent.TypeOneofCase
Enum of possible cases for the "type" oneof.
DataAgentContext.Types.ContextVersion
List of context versions supported by DCS. There are two versions of context. This is to maintain versioning for the data agent.
DataAgentName.ResourceNameType
The possible contents of DataAgentName.
DataFilterType
The type of filter present on a datasource, such as ALWAYS_FILTER.
DataMessage.KindOneofCase
Enum of possible cases for the "kind" oneof.
DataQuery.QueryTypeOneofCase
Enum of possible cases for the "query_type" oneof.
Datasource.ReferenceOneofCase
Enum of possible cases for the "reference" oneof.
DatasourceReferences.ReferencesOneofCase
Enum of possible cases for the "references" oneof.
ExampleQuery.QueryOneofCase
Enum of possible cases for the "query" oneof.
FilePart.FileOneofCase
Enum of possible cases for the "file" oneof.
ListAccessibleDataAgentsRequest.Types.CreatorFilter
Filter for the creator of the agent.
LookerExploreReference.InstanceOneofCase
Enum of possible cases for the "instance" oneof.
Message.KindOneofCase
Enum of possible cases for the "kind" oneof.
OAuthCredentials.KindOneofCase
Enum of possible cases for the "kind" oneof.
OAuthFlows.FlowOneofCase
Enum of possible cases for the "flow" oneof.
Part.PartOneofCase
Enum of possible cases for the "part" oneof.
Role
Role indicates the sender of a message.
SchemaMessage.KindOneofCase
Enum of possible cases for the "kind" oneof.
SecurityScheme.SchemeOneofCase
Enum of possible cases for the "scheme" oneof.
SendMessageResponse.PayloadOneofCase
Enum of possible cases for the "payload" oneof.
SpannerDatabaseReference.Types.Engine
The database engine.
StreamResponse.PayloadOneofCase
Enum of possible cases for the "payload" oneof.
SystemMessage.KindOneofCase
Enum of possible cases for the "kind" oneof.
TaskState
The set of states a Task can be in.
TextMessage.Types.TextType
The type of the text message.
UserMessage.KindOneofCase
Enum of possible cases for the "kind" oneof.