Skip to content

Google BigQuery

Google BigQuery

Google BigQuery is a fully managed, serverless data warehouse that lets you run analytical SQL queries on massive datasets with high speed and scale. With the SquadOS integration, your agents can create and query datasets, run SQL jobs, manage tables, routines, and machine learning models, and control IAM permissions — all through natural language.

This tool uses OAuth 2.0 (OAUTH2) or a Google Service Account (GOOGLE_SERVICE_ACCOUNT) to connect.

You will need one of the following authentication methods:

FieldRequiredDescription
Google Account (OAuth 2.0)YesAuthorize access via the OAuth flow on the Composio secure connection page.
Service account (JSON)Yes (alternative)JSON credentials file from a service account with permissions on the BigQuery project.
Section titled “Option 1 — OAuth 2.0 (recommended for personal use)”
  1. Go to the Google Cloud Console and sign in.
  2. Make sure the BigQuery API is enabled in your desired project.
  3. When connecting via SquadOS, you will be redirected to authorize OAuth access directly on the Composio secure connection page.
Section titled “Option 2 — Service Account (recommended for automations)”
  1. Go to the Google Cloud Console and select your project.
  2. Navigate to IAM & Admin → Service Accounts.
  3. Click Create Service Account, fill in the name, and assign the BigQuery User and BigQuery Data Editor roles (or the roles appropriate for the desired scope).
  4. After creating, go to the service account → Keys tab → Add Key → Create new key → JSON.
  5. Download the JSON file — this is the value to provide when connecting via service account in SquadOS.
  1. Go to Tools in the side menu (/admin/tools).
  2. Open the Available tab and search for Google BigQuery.
  3. Click the card to open the details modal and hit Connect.
  4. You’re taken to the secure connection page hosted by Composio, where you authorize access via OAuth 2.0 or enter the service account credentials.
  5. Once done, you’re sent back to SquadOS with the account connected and the tool available to your agents. (Connection-flow details in Organization Tools.)

GOOGLEBIGQUERY_CANCEL_JOB

Tool to cancel a running BigQuery job. This call returns immediately, and you need to poll for the job status to see if the cancel completed successfully. Note that cancelled jobs may still incur costs.

NameTypeRequiredDescription
job_idstringYesRequired. Job ID of the job to cancel.
locationstringNoThe geographic location of the job. You must specify the location to run the job for the following scenarios: If the location to run a job is not in the us or the eu multi-regional location. If the job’s location is in a single region (for example, us-central1).
project_idstringYesRequired. Project ID of the job to cancel.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_CAPACITY_COMMITMENT

Tool to create a new capacity commitment resource in BigQuery Reservation. Use when you need to purchase compute capacity (slots) with a committed period of usage for BigQuery jobs. Supports various commitment plans (FLEX, MONTHLY, ANNUAL, THREE_YEAR) and editions (STANDARD, ENTERPRISE, ENTERPRISE_PLUS).

NameTypeRequiredDescription
planstring ("COMMITMENT_PLAN_UNSPECIFIED" | "FLEX" | "FLEX_FLAT_RATE" | "TRIAL" | "MONTHLY" | "MONTHLY_FLAT_RATE" | "ANNUAL" | "ANNUAL_FLAT_RATE" | "THREE_YEAR" | "NONE")YesRequired. Capacity commitment plan. Determines the commitment period and pricing.
parentstringYesRequired. Resource name of the parent reservation. Must be in the format projects/{project}/locations/{location} (e.g., projects/myproject/locations/US).
editionstring ("EDITION_UNSPECIFIED" | "STANDARD" | "ENTERPRISE" | "ENTERPRISE_PLUS")NoEdition of the capacity commitment.
slotCountstringYesRequired. Number of slots in this commitment. Must be a positive integer represented as a string.
renewalPlanstringNoCapacity commitment plan types.
capacityCommitmentIdstringNoThe optional capacity commitment ID. Generated automatically if empty. Must only contain lower case alphanumeric characters or dashes. Max length is 64 characters.
multiRegionAuxiliarybooleanNoApplicable only for commitments located within one of the BigQuery multi-regions (US or EU). If set to true, this commitment is placed in the organization’s secondary region for disaster recovery.
enforceSingleAdminProjectPerOrgbooleanNoIf true, fail the request if another project in the organization has a capacity commitment.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_CONNECTION

Tool to create a new BigQuery connection to external data sources using the BigQuery Connection API. Use when setting up connections to AWS, Azure, Cloud Spanner, Cloud SQL, Salesforce DataCloud, or Apache Spark.

NameTypeRequiredDescription
awsobjectNoConnection properties specific to Amazon Web Services (AWS).
azureobjectNoContainer for connection properties specific to Azure.
sparkobjectNoContainer for connection properties to execute stored procedures for Apache Spark.
parentstringYesRequired. Parent resource name in the format projects/{project_id}/locations/{location_id}. Example: projects/my-project/locations/us-central1.
cloudSqlobjectNoConnection properties specific to Cloud SQL.
kmsKeyNamestringNoOptional. The Cloud KMS key that is used for encryption.
descriptionstringNoUser provided description for the connection.
cloudSpannerobjectNoConnection properties specific to Cloud Spanner.
connectionIdstringNoOptional. Connection id that should be assigned to the created connection. If not specified, a random connection id will be generated.
friendlyNamestringNoUser provided display name for the connection.
cloudResourceobjectNoContainer for connection properties for delegation of access to GCP resources.
salesforceDataCloudobjectNoConnection properties specific to Salesforce DataCloud.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_DATA_EXCHANGE

Tool to create a new Analytics Hub data exchange for sharing BigQuery datasets. Use when you need to set up a container for data sharing with descriptive information and listings.

NameTypeRequiredDescription
iconstringNoOptional. Base64 encoded image representing the data exchange. Max Size: 3.0MiB. Expected image dimensions are 512x512 pixels.
parentstringYesRequired. The parent resource path of the data exchange in the format projects/{project}/locations/{location}. Example: projects/my-project/locations/US.
descriptionstringNoOptional. Description of the data exchange. Max length: 2000 bytes.
displayNamestringYesRequired. Human-readable display name of the data exchange. Max length: 63 bytes.
documentationstringNoOptional. Documentation describing the data exchange.
dataExchangeIdstringYesRequired. The ID of the data exchange. Must contain only Unicode letters, numbers (0-9), underscores (_). Max length: 100 bytes.
primaryContactstringNoOptional. Email or URL of the primary point of contact of the data exchange. Max Length: 1000 bytes.
sharingEnvironmentConfigobjectNoSharing environment configuration for data exchange behavior.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_DATAEXCHANGES_LISTINGS

Tool to create a new listing in a BigQuery Analytics Hub data exchange. Use when you need to share a BigQuery dataset with specific subscribers or make it available for discovery. The dataset must exist and be in the same region as the data exchange.

NameTypeRequiredDescription
parentstringYesRequired. The parent data exchange resource path in format projects/{projectId}/locations/{location}/dataExchanges/{dataExchangeId}. The location must match the dataset location.
listingIdstringYesRequired. The ID to use for the listing. Must contain only Unicode letters, numbers (0-9), underscores (_). Max length: 100 bytes.
publisherobjectNoDetails of the publisher who owns the listing.
categoriesarrayNoOptional. Categories of the listing. Up to two categories are allowed.
descriptionstringNoOptional. Short description of the listing. Max 2000 bytes.
displayNamestringYesRequired. Human-readable display name of the listing. Max 63 bytes.
dataProviderobjectNoDetails of the data provider who owns the source data.
documentationstringNoOptional. Documentation describing the listing in detail.
requestAccessstringNoOptional. Email or URL where users can request access to the listing. Max 1000 bytes.
primaryContactstringNoOptional. Email or URL of the primary point of contact for the listing. Max 1000 bytes.
bigqueryDatasetobjectYesRequired. The BigQuery dataset source to be shared. This dataset must exist and be in the same region as the data exchange.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_DATASET

Tool to create a new BigQuery dataset with explicit location, labels, and description using the BigQuery Datasets API. Use when the workflow needs to set up a staging/warehouse dataset and correctness of region is critical to avoid downstream job location mismatches. Surfaces 409 Already Exists errors cleanly without retrying.

NameTypeRequiredDescription
accessarrayNoAccess control list (ACL) for the dataset. If not specified, the dataset inherits project-level permissions.
labelsobjectNoLabels to organize and categorize the dataset. Labels are key-value pairs. Keys and values must be lowercase, max 63 characters.
locationstringYesGeographic location where the dataset should reside. This is CRITICAL to avoid location-related query/job errors. Examples: US, EU, us-central1, europe-west1.
dataset_idstringYesThe dataset ID. Must be unique within the project. Use alphanumeric characters, underscores, or hyphens.
project_idstringYesThe project ID where the dataset will be created. This is used in the URL path, not in the request body.
descriptionstringNoA description of the dataset. Use this to document the dataset’s purpose and contents.
friendly_namestringNoA user-friendly name for the dataset. This is a descriptive label that appears in the BigQuery UI.
defaultTableExpirationMsintegerNoDefault lifetime of all tables in the dataset, in milliseconds.
defaultPartitionExpirationMsintegerNoDefault lifetime of all partitions in tables in the dataset, in milliseconds.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_LISTING

Tool to create a new listing in a data exchange using Analytics Hub API. Use when publishing a BigQuery dataset to make it available for subscription by other users or organizations.

NameTypeRequiredDescription
altstring ("json" | "media" | "proto")NoData format for response.
keystringNoAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
iconstringNoBase64 encoded image representing the listing. Max Size: 3.0MiB. Expected image dimensions are 512x512 pixels.
xgafvstring ("1" | "2")NoV1 error format.
fieldsstringNoSelector specifying which fields to include in a partial response.
parentstringYesRequired. The parent resource path of the listing. Format: projects/{project_id}/locations/{location}/dataExchanges/{data_exchange_id}.
callbackstringNoJSONP callback parameter.
listingIdstringNoThe ID of the listing to create. If not provided, a random ID will be generated.
publisherobjectNoDetails of the listing publisher.
categoriesarrayNoCategories of the listing. Up to two categories are allowed.
quota_userstringNoAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadTypestringNoLegacy upload protocol for media (e.g. ‘media’, ‘multipart’).
descriptionstringNoShort description of the listing. Max length: 2000 bytes.
displayNamestringYesRequired. Human-readable display name of the listing. Max length: 63 bytes.
oauth_tokenstringNoOAuth 2.0 token for the current user.
prettyPrintbooleanNoReturns response with indentations and line breaks.
access_tokenstringNoOAuth access token.
dataProviderobjectNoDetails of the data provider.
documentationstringNoDocumentation describing the listing.
requestAccessstringNoEmail or URL of the request access of the listing. Max Length: 1000 bytes.
primaryContactstringNoEmail or URL of the primary point of contact of the listing. Max Length: 1000 bytes.
bigqueryDatasetobjectYesRequired. Reference to the shared BigQuery dataset. Analytics Hub creates a linked dataset for subscribers when they subscribe to this listing.
upload_protocolstringNoUpload protocol for media (e.g. ‘raw’, ‘multipart’).
restrictedExportConfigobjectNoRestricted export configuration for linked dataset.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_LOCATIONS_DATAPOLICIES

Tool to create a new data policy under a project with specified location using the v2beta1 BigQuery Data Policy API. Use when you need to set up data masking rules or column-level security for sensitive data. The v2beta1 endpoint uses a nested request structure.

NameTypeRequiredDescription
parentstringYesRequired. Resource name of the project and location that the data policy will belong to. The format is projects/{project_number}/locations/{location_id}. Example: projects/934040047113/locations/us-central1.
dataPolicyobjectYesRequired. The data policy configuration containing the policy type, policy tag, and masking rules.
dataPolicyIdstringYesRequired. User-assigned (human readable) ID of the data policy that needs to be unique within a project. Used as {data_policy_id} in part of the resource name. This will also be used as the display name.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_QUERY_TEMPLATE

Tool to create a new query template in a BigQuery Analytics Hub Data Clean Room (DCR) data exchange. Use when you need to define predefined and approved queries for data clean room use cases. Query templates must be created in DCR data exchanges only.

NameTypeRequiredDescription
parentstringYesRequired. The parent resource where this query template will be created. Format: projects/{project}/locations/{location}/dataExchanges/{dataExchange}. Note: Query templates require a Data Clean Room (DCR) data exchange.
routineobjectYesRequired. The routine definition containing the query template logic.
descriptionstringNoOptional. Description of the query template explaining its purpose and usage.
displayNamestringYesRequired. Human-readable name of the query template. This name will be shown to subscribers of the data exchange.
queryTemplateIdstringYesRequired. The ID to use for the query template. Must contain only Unicode letters, numbers (0-9), underscores (_). Max length: 100 bytes.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_RESERVATION

Tool to create a new BigQuery reservation resource to guarantee compute capacity (slots) for query and pipeline jobs. Use when you need to reserve dedicated compute resources for predictable performance and cost management. Reservations can be configured with autoscaling, concurrency limits, and edition-based features.

NameTypeRequiredDescription
parentstringYesRequired. Project, location. E.g., projects/myproject/locations/US. The parent resource where the reservation will be created.
editionstring ("EDITION_UNSPECIFIED" | "STANDARD" | "ENTERPRISE" | "ENTERPRISE_PLUS")NoEdition of the reservation.
autoscaleobjectNoAuto scaling settings for the reservation.
concurrencystringNoJob concurrency target which sets a soft upper bound on the number of jobs that can run concurrently in this reservation. Default value is 0 which means that concurrency target will be automatically computed by the system. Must be a non-negative integer represented as a string.
slotCapacitystringYesRequired. Baseline slots available to this reservation. A slot is a unit of computational power in BigQuery. Must be a positive integer represented as a string.
reservationIdstringNoOptional reservation ID. Maximum length is 64 characters. If not provided, a reservation ID will be generated automatically.
ignoreIdleSlotsbooleanNoIf false, any query or pipeline job using this reservation will use idle slots from other reservations within the same admin project.
multiRegionAuxiliarybooleanNoApplicable only for reservations located within one of the BigQuery multi-regions (US or EU). If set to true, this reservation is placed in the organization’s secondary region for disaster recovery purposes.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_RESERVATION_ASSIGNMENT

Tool to create a BigQuery reservation assignment that allows a project, folder, or organization to submit jobs using slots from a specified reservation. Use when setting up resource allocation for BigQuery workloads. Note: A resource can only have one assignment per (job_type, location) combination.

NameTypeRequiredDescription
parentstringYesRequired. The parent resource name of the assignment. Format: projects/{project_id}/locations/{location}/reservations/{reservation_id}. Example: projects/myproject/locations/US/reservations/team1-prod.
jobTypestring ("JOB_TYPE_UNSPECIFIED" | "PIPELINE" | "QUERY" | "ML_EXTERNAL" | "BACKGROUND")YesRequired. Which type of jobs will use the reservation.
assigneestringYesRequired. The resource which will use the reservation. Can be a project, folder, or organization. Format: projects/{project_id}, folders/{folder_id}, or organizations/{org_id}.
assignmentIdstringNoOptional assignment ID. Assignment name will be generated automatically if this field is empty. Max length is 64 characters.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_ROUTINE

Tool to create a new user-defined routine (function or procedure) in a BigQuery dataset. Use when you need to define SQL, JavaScript, Python, Java, or Scala functions/procedures for reusable logic, data transformations, or custom masking. Supports scalar functions, table-valued functions, procedures, and aggregate functions with comprehensive type definitions.

NameTypeRequiredDescription
languagestring ("LANGUAGE_UNSPECIFIED" | "SQL" | "JAVASCRIPT" | "PYTHON" | "JAVA" | "SCALA")NoProgramming language of the routine.
argumentsarrayNoOptional. Input/output arguments for the routine.
dataset_idstringYesRequired. Dataset ID where the routine will be created. Used in the URL path.
project_idstringYesRequired. Project ID where the routine will be created. Used in the URL path.
returnTypeobjectNoData type of a BigQuery field or function argument.
strictModebooleanNoOptional. If TRUE (default), the procedure body is checked for errors like non-existent tables.
descriptionstringNoOptional. A description of the routine.
routineTypestring ("ROUTINE_TYPE_UNSPECIFIED" | "SCALAR_FUNCTION" | "PROCEDURE" | "TABLE_VALUED_FUNCTION" | "AGGREGATE_FUNCTION")YesRequired. The type of routine.
securityModestring ("SECURITY_MODE_UNSPECIFIED" | "DEFINER" | "INVOKER")NoSecurity mode of the routine.
sparkOptionsobjectNoOptions for user-defined Spark routines.
definitionBodystringYesRequired. The body of the routine. For SQL functions, this is the expression in the AS clause (excluding parentheses). For JavaScript, it’s the evaluated string in the AS clause.
returnTableTypeobjectNoA table type for table-valued functions.
determinismLevelstring ("DETERMINISM_LEVEL_UNSPECIFIED" | "DETERMINISTIC" | "NOT_DETERMINISTIC")NoDeterminism level for JavaScript UDFs.
routineReferenceobjectYesRequired. Reference containing projectId, datasetId, and routineId for the new routine.
importedLibrariesarrayNoOptional. For JavaScript routines, paths of imported JavaScript libraries.
dataGovernanceTypestring ("DATA_GOVERNANCE_TYPE_UNSPECIFIED" | "DATA_MASKING")NoData governance type for the routine.
remoteFunctionOptionsobjectNoOptions for remote user-defined functions.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_CREATE_TABLE

Tool to create a new, empty table in a BigQuery dataset. Use when setting up data infrastructure for standard tables, external tables, views, or materialized views. Supports partitioning, clustering, and encryption configuration.

NameTypeRequiredDescription
viewobjectNoLogical view definition.
labelsobjectNoLabels to organize tables. Keys and values must be lowercase, max 63 characters, starting with a letter.
schemaobjectNoSchema of a table defining its fields/columns.
clusteringobjectNoClustering configuration for a table.
dataset_idstringYesThe dataset ID where the table will be created. Used in the URL path.
project_idstringYesThe project ID where the table will be created. Used in the URL path.
descriptionstringNoA user-friendly description of the table.
friendlyNamestringNoA descriptive name for the table shown in the BigQuery UI.
expirationTimestringNoTime when the table expires, in milliseconds since epoch.
tableReferenceobjectYesReference identifying the table. Must match project_id and dataset_id from the path.
defaultCollationstringNoDefault collation for new STRING fields. Options: und:ci (case insensitive), '' (case sensitive, default).
materializedViewobjectNoMaterialized view definition and configuration.
timePartitioningobjectNoTime-based partitioning configuration for a table.
rangePartitioningobjectNoRange-based partitioning configuration for a table.
requirePartitionFilterbooleanNoIf true, queries over this table require a partition filter for partition elimination.
encryptionConfigurationobjectNoEncryption configuration for a table.
externalDataConfigurationobjectNoConfiguration for external data sources.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_DELETE_DATASET

Tool to delete a BigQuery dataset specified by datasetId via the datasets.delete API. Before deletion, you must delete all tables unless deleteContents=True is specified. Use when cleaning up test datasets or removing unused data warehouses.

NameTypeRequiredDescription
dataset_idstringYesRequired. Dataset ID of dataset being deleted.
project_idstringYesRequired. Project ID of the dataset being deleted.
delete_contentsbooleanNoIf True, delete all the tables in the dataset. If False and the dataset contains tables, the request will fail. Default is False.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_DELETE_JOB_METADATA

Tool to delete the metadata of a BigQuery job. Use when you need to remove job metadata from the system. If this is a parent job with child jobs, metadata from all child jobs will be deleted as well.

NameTypeRequiredDescription
job_idstringYesRequired. Job ID of the job for which metadata is to be deleted. If this is a parent job which has child jobs, the metadata from all child jobs will be deleted as well. Direct deletion of the metadata of child jobs is not allowed.
locationstringNoThe geographic location of the job. Required for jobs in certain regions.
project_idstringYesRequired. Project ID of the job for which metadata is to be deleted.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_DELETE_MODEL

Tool to delete a BigQuery ML model from a dataset. Use when you need to remove a trained machine learning model permanently. The operation deletes the model and cannot be undone.

NameTypeRequiredDescription
model_idstringYesRequired. Model ID of the model to delete.
dataset_idstringYesRequired. Dataset ID of the model to delete.
project_idstringYesRequired. Project ID of the model to delete.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_DELETE_ROUTINE

Tool to delete a BigQuery routine by its ID. Use when you need to remove a stored procedure, user-defined function, or table function from a dataset. This operation is irreversible.

NameTypeRequiredDescription
dataset_idstringYesRequired. Dataset ID of the routine to delete.
project_idstringYesRequired. Project ID of the routine to delete.
routine_idstringYesRequired. Routine ID of the routine to delete.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_DELETE_TABLE

Tool to delete a BigQuery table from a dataset. Use when you need to remove a table and all its data permanently. The operation deletes all data in the table and cannot be undone.

NameTypeRequiredDescription
table_idstringYesRequired. Table ID of the table to delete.
dataset_idstringYesRequired. Dataset ID of the table to delete.
project_idstringYesRequired. Project ID of the table to delete.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_BIGQUERY_MODEL

Tool to retrieve a specific BigQuery ML model resource by model ID. Use when you need detailed information about a trained machine learning model including its configuration, training runs, hyperparameters, and evaluation metrics.

NameTypeRequiredDescription
model_idstringYesRequired. Model ID of the requested model.
dataset_idstringYesRequired. Dataset ID of the requested model.
project_idstringYesRequired. Project ID of the requested model.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_CONNECTION_IAM_POLICY

Tool to get the IAM access control policy for a BigQuery connection resource. Returns an empty policy if the resource exists but has no policy set. Use this to check who has access to a specific connection before modifying permissions.

NameTypeRequiredDescription
optionsobjectNoOptional settings for GetIamPolicy request. Specify requestedPolicyVersion if you need a specific policy version format.
resourcestringYesREQUIRED: The resource for which the policy is being requested. Format: projects/{project}/locations/{location}/connections/{connection}. Example: projects/my-project/locations/us/connections/my-connection
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_DATASET

Tool to retrieve BigQuery dataset metadata including location via the datasets.get API. Use this before creating jobs/queries if the workflow has been failing with location mismatch to confirm the dataset’s region and correct the job location accordingly.

NameTypeRequiredDescription
dataset_idstringYesDataset ID of the requested dataset.
project_idstringYesProject ID of the requested dataset.
dataset_viewstring ("DATASET_VIEW_UNSPECIFIED" | "METADATA" | "ACL" | "FULL")NoOptional view specifying which dataset information to return. DATASET_VIEW_UNSPECIFIED defaults to FULL.
access_policy_versionintegerNoVersion of access policy schema to fetch. Valid values: 0, 1, 3. Use version 3 for conditional access policy bindings. If unset, defaults to version 1.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_JOB

Tool to retrieve information about a specific BigQuery job. Returns job configuration, status, and statistics. Use this to check job status after running queries or to get details about job execution.

NameTypeRequiredDescription
job_idstringYesRequired. Job ID of the requested job.
locationstringNoThe geographic location of the job. You must specify the location to run the job for the following scenarios: If the location to run a job is not in the us or the eu multi-regional location, or if the job’s location is in a single region (for example, us-central1).
project_idstringYesRequired. Project ID of the requested job.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_QUERY_RESULTS

Tool to get the results of a BigQuery query job via RPC. Use this to retrieve results after running a query, or to check job completion status and fetch paginated results.

NameTypeRequiredDescription
altstring ("json" | "media" | "proto")NoData format for response enum.
keystringNoAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
jobIdstringYesRequired. Job ID of the query job.
xgafvstring ("1" | "2")NoV1 error format enum.
fieldsstringNoSelector specifying which fields to include in a partial response.
callbackstringNoJSONP callback parameter.
locationstringNoThe geographic location of the job.
pageTokenstringNoPage token, returned by a previous call, to request the next page of results.
projectIdstringYesRequired. Project ID of the query job.
quotaUserstringNoAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
timeoutMsintegerNoOptional: Specifies the maximum amount of time, in milliseconds, that the client is willing to wait for the query to complete. By default, this limit is 10 seconds (10,000 milliseconds).
maxResultsintegerNoMaximum number of results to read.
startIndexstringNoZero-based index of the starting row.
uploadTypestringNoLegacy upload protocol for media (e.g. “media”, “multipart”).
oauth_tokenstringNoOAuth 2.0 token for the current user.
prettyPrintbooleanNoReturns response with indentations and line breaks.
access_tokenstringNoOAuth access token.
upload_protocolstringNoUpload protocol for media (e.g. “raw”, “multipart”).
formatOptions.useInt64TimestampbooleanNoOptional. Output timestamp as usec int64. Default is false.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_ROUTINE

Tool to retrieve a BigQuery routine (user-defined function or stored procedure) by its ID. Use to inspect routine definitions, arguments, return types, and metadata.

NameTypeRequiredDescription
read_maskstringNoIf set, only the Routine fields in the field mask are returned in the response. If unset, all Routine fields are returned.
dataset_idstringYesRequired. Dataset ID of the requested routine.
project_idstringYesRequired. Project ID of the requested routine.
routine_idstringYesRequired. Routine ID of the requested routine.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_ROUTINE_IAM_POLICY

Tool to retrieve the IAM access control policy for a BigQuery routine resource. Returns an empty policy if the routine exists but has no policy set. Use this to check current access permissions before modifying them.

NameTypeRequiredDescription
optionsobjectNoOptional settings for GetIamPolicy request. Specify requestedPolicyVersion if you need a specific policy version format.
dataset_idstringYesRequired. The ID of the dataset containing the routine.
project_idstringYesRequired. The ID of the project containing the routine.
routine_idstringYesRequired. The ID of the routine to get IAM policy for.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_SERVICE_ACCOUNT

Tool to get the service account for a project used for interactions with Google Cloud KMS. Use when you need to retrieve the BigQuery service account email for KMS encryption configuration or key access permissions.

NameTypeRequiredDescription
altstring ("json" | "media" | "proto")NoData format for response.
keystringNoAPI key.
xgafvstring ("1" | "2")NoV1 error format.
fieldsstringNoSelector specifying which fields to include in a partial response.
callbackstringNoJSONP callback.
project_idstringYesRequired. ID of the project.
quota_userstringNoAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadTypestringNoLegacy upload protocol for media (e.g. ‘media’, ‘multipart’).
oauth_tokenstringNoOAuth 2.0 token for the current user.
prettyPrintbooleanNoReturns response with indentations and line breaks.
access_tokenstringNoOAuth access token.
upload_protocolstringNoUpload protocol for media (e.g. ‘raw’, ‘multipart’).
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_TABLE_IAM_POLICY

Tool to retrieve the IAM access control policy for a BigQuery table resource. Returns an empty policy if the resource exists but has no policy set. Use this to check current access permissions before modifying them.

NameTypeRequiredDescription
resourcestringYesREQUIRED: The resource for which the policy is being requested. Format: projects/{projectId}/datasets/{datasetId}/tables/{tableId}.
requested_policy_versionintegerNoOptional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Policies with conditional role bindings must specify version 3. If unset, defaults to version 1.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_GET_TABLE_SCHEMA

Tool to fetch a BigQuery table’s schema and metadata without querying row data. Use before generating SQL queries to avoid column name typos and confirm field types and nullable modes. This is especially useful when INFORMATION_SCHEMA access is restricted.

NameTypeRequiredDescription
table_idstringYesThe table ID to retrieve schema and metadata for.
dataset_idstringYesThe dataset ID containing the table.
project_idstringYesThe project ID containing the dataset.
selected_fieldsstringNoComma-separated list of fields to return (e.g., schema,numRows,type). If not specified, returns all fields.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_INSERT_ALL

Tool to stream data into BigQuery one record at a time without running a load job. Use when you need immediate data availability or inserting small batches. Supports row-level deduplication via insertId and error handling via skipInvalidRows.

NameTypeRequiredDescription
rowsarrayYesRequired. Array of rows to insert. Each row contains the data to be inserted as a JSON object. At least one row must be provided.
traceIdstringNoOptional. Unique request trace ID for debugging. Case-sensitive, up to 36 ASCII characters. A UUID is recommended.
table_idstringYesRequired. Table ID of the destination table.
dataset_idstringYesRequired. Dataset ID of the destination table.
project_idstringYesRequired. Project ID of the destination table.
templateSuffixstringNoOptional. If specified, treats the destination table as a base template and inserts rows into an instance table named {destination}{templateSuffix}. Useful for table sharding patterns.
skipInvalidRowsbooleanNoOptional. If true, insert all valid rows even if some rows are invalid. If false (default), the entire request fails if any row is invalid.
ignoreUnknownValuesbooleanNoOptional. If true, accept rows with values that don’t match the schema and ignore the unknown values. If false (default), treat unknown values as errors.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_INSERT_JOB

Tool to start a new asynchronous BigQuery job (query, load, extract, or copy). Use when you need to run a query as a job, load data from Cloud Storage, extract table data to GCS, or copy tables. For dry-run validation without execution, set dryRun to true in configuration.

NameTypeRequiredDescription
project_idstringYesProject ID of project that will be billed for the job. This is used in the URL path.
jobReferenceobjectNoJob reference identifying the job.
configurationobjectYesRequired. Job configuration. Specify exactly one of: query, load, extract, or copy in the configuration object.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_INSERT_JOB_WITH_UPLOAD

Tool to start a new BigQuery load job with file upload. Uploads a file (CSV, JSON, etc.) and loads it into a BigQuery table in a single operation. Use when you need to upload data from a local file directly to BigQuery rather than loading from Cloud Storage.

NameTypeRequiredDescription
project_idstringYesProject ID that will be billed for the job. Used in the URL path.
jobReferenceobjectNoOptional job reference for the upload job.
configurationobjectYesJob configuration containing load settings (schema, destination table, format, etc.).
file_to_uploadobjectYesFile to upload to BigQuery. The file content will be loaded according to the sourceFormat specified in configuration.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_ANALYTICS_HUB_LISTINGS

Tool to list all listings in a given Analytics Hub data exchange. Use when you need to discover available data listings within a specific data exchange that can be subscribed to for data sharing.

NameTypeRequiredDescription
altstring ("json" | "media" | "proto")NoData format for response.
keystringNoAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafvstring ("1" | "2")NoV1 error format.
fieldsstringNoSelector specifying which fields to include in a partial response.
parentstringYesRequired. The parent resource path of the listing. Format: projects/{project_id}/locations/{location}/dataExchanges/{data_exchange_id}.
callbackstringNoJSONP callback parameter.
pageSizeintegerNoThe maximum number of results to return in a single response page.
pageTokenstringNoPage token, returned by a previous call, to request the next page of results.
quota_userstringNoAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadTypestringNoLegacy upload protocol for media (e.g. ‘media’, ‘multipart’).
oauth_tokenstringNoOAuth 2.0 token for the current user.
prettyPrintbooleanNoReturns response with indentations and line breaks.
access_tokenstringNoOAuth access token.
upload_protocolstringNoUpload protocol for media (e.g. ‘raw’, ‘multipart’).
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_BIG_QUERY_CONNECTIONS

Tool to list BigQuery connections in a given project and location. Use when you need to discover available external data source connections (Cloud SQL, AWS, Azure, Spark, etc.) configured for BigQuery.

NameTypeRequiredDescription
parentstringYesRequired. Parent resource name. Must be in the form: projects/{project_id}/locations/{location_id}. Example: projects/my-project/locations/us-central1
pageSizeintegerNoMaximum number of connections to return per page.
pageTokenstringNoPage token for pagination. Use the nextPageToken from a previous response to get the next page of results.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_CAPACITY_COMMITMENTS

Tool to list all capacity commitments for the admin project. Use when you need to view purchased compute capacity slots and their commitment details (plan, state, duration).

NameTypeRequiredDescription
parentstringYesRequired. Resource name of the parent reservation. E.g., projects/myproject/locations/US
page_sizeintegerNoThe maximum number of items to return.
page_tokenstringNoThe next_page_token value returned from a previous List request, if any.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_DATAEXCHANGES_LISTINGS

Tool to list all listings in a given Analytics Hub data exchange using the v1beta1 API. Use when you need to discover available data listings within a specific data exchange that can be subscribed to for data sharing.

NameTypeRequiredDescription
altstring ("json" | "media" | "proto")NoData format for response.
keystringNoAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafvstring ("1" | "2")NoV1 error format.
fieldsstringNoSelector specifying which fields to include in a partial response.
parentstringYesRequired. The parent resource path of the listing. Format: projects/{project_id}/locations/{location}/dataExchanges/{data_exchange_id}.
callbackstringNoJSONP callback parameter.
pageSizeintegerNoThe maximum number of results to return in a single response page.
pageTokenstringNoPage token, returned by a previous call, to request the next page of results.
quota_userstringNoAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadTypestringNoLegacy upload protocol for media (e.g. ‘media’, ‘multipart’).
oauth_tokenstringNoOAuth 2.0 token for the current user.
prettyPrintbooleanNoReturns response with indentations and line breaks.
access_tokenstringNoOAuth access token.
upload_protocolstringNoUpload protocol for media (e.g. ‘raw’, ‘multipart’).
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_DATASETS

Tool to list datasets in a specific BigQuery project, including dataset locations. Use after identifying an accessible project to discover available datasets and their locations before querying. The dataset location is critical for avoiding location-related query/job errors.

NameTypeRequiredDescription
allbooleanNoWhether to list all datasets, including hidden ones. Defaults to false.
filterstringNoFilter datasets by label in the format labels.key:value. Multiple filters can be ANDed together by connecting with a space.
page_tokenstringNoPage token for pagination.
project_idstringYesThe project ID containing the datasets.
max_resultsintegerNoMaximum number of datasets to return per page.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_JOBS

Tool to list all jobs that you started in a BigQuery project. Job information is available for a six month period after creation. Jobs are sorted in reverse chronological order by creation time. Use to monitor query execution, track job statuses, and retrieve job history.

NameTypeRequiredDescription
all_usersbooleanNoWhether to display jobs owned by all users in the project. Default False. Requires Is Owner project role to set to true.
page_tokenstringNoPage token, returned by a previous call, to request the next page of results.
project_idstringYesProject ID of the jobs to list.
projectionstring ("full" | "minimal")NoRestrict information returned to a set of selected fields.
max_resultsintegerNoThe maximum number of results to return in a single response page.
state_filterarrayNoFilter for job state. Can include values like done, pending, running. Multiple states can be specified.
parent_job_idstringNoIf set, show only child jobs of the specified parent. Otherwise, show all top-level jobs.
max_creation_timestringNoMax value for job creation time, in milliseconds since the POSIX epoch.
min_creation_timestringNoMin value for job creation time, in milliseconds since the POSIX epoch.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_LOCATIONS

Tool to list information about supported locations for BigQuery Data Transfer Service. Use when you need to discover available regions/locations where BigQuery Data Transfer operations can be performed.

NameTypeRequiredDescription
namestringYesThe resource that owns the locations collection, if applicable. Format: projects/{project_id}.
filterstringNoA filter to narrow down results to a preferred subset.
pageSizeintegerNoThe maximum number of results to return.
pageTokenstringNoA page token received from the next_page_token field in the response.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_LOCATIONS_CONNECTIONS

Tool to list BigQuery connections in a given project and location using the v1beta1 API. Use when you need to discover available external data source connections (Cloud SQL, AWS, Azure, Spark, etc.) configured for BigQuery in a specific location.

NameTypeRequiredDescription
parentstringYesRequired. Parent resource name. Must be in the form: projects/{project_id}/locations/{location_id}. Example: projects/my-project/locations/us
pageTokenstringNoPage token for pagination.
maxResultsintegerYesRequired. Maximum number of connections to return per page.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_LOCATIONS_DATAPOLICIES

Tool to list all data policies in a specified parent project and location using the v2beta1 API. Use when you need to discover data masking policies and column-level security policies configured for BigQuery datasets.

NameTypeRequiredDescription
filterstringNoFilters the data policies by policy tags that they are associated with. Currently filter only supports policy_tag based filtering and OR based predicates.
parentstringYesRequired. Resource name of the project for which to list data policies. Format is projects/{project}/locations/{location}.
pageSizeintegerNoThe maximum number of data policies to return. Must be a value between 1 and 1000. If not set, defaults to 50.
pageTokenstringNoThe nextPageToken value returned from a previous list request, if any.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_MODELS

Tool to list all BigQuery ML models in a specified dataset. Requires READER dataset role. Use this to discover available models before getting detailed information via models.get method.

NameTypeRequiredDescription
dataset_idstringYesRequired. Dataset ID of the models to list.
page_tokenstringNoPage token for pagination, returned by a previous call.
project_idstringYesRequired. Project ID of the models to list.
max_resultsintegerNoMaximum number of models to return per page.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_ORGANIZATION_DATA_EXCHANGES

Tool to list all data exchanges from projects in a given organization and location using Analytics Hub API. Use when you need to discover available data exchanges within an organization that can be used for data sharing.

NameTypeRequiredDescription
altstring ("json" | "media" | "proto")NoData format for response.
keystringNoAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafvstring ("1" | "2")NoV1 error format.
fieldsstringNoSelector specifying which fields to include in a partial response.
callbackstringNoJSONP callback parameter.
pageSizeintegerNoThe maximum number of results to return in a single response page.
pageTokenstringNoPage token, returned by a previous call, to request the next page of results.
quota_userstringNoAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
uploadTypestringNoLegacy upload protocol for media (e.g. ‘media’, ‘multipart’).
oauth_tokenstringNoOAuth 2.0 token for the current user.
prettyPrintbooleanNoReturns response with indentations and line breaks.
access_tokenstringNoOAuth access token.
organizationstringYesRequired. The organization resource path of the projects containing DataExchanges. Format: organizations/{organization_id}/locations/{location}.
upload_protocolstringNoUpload protocol for media (e.g. ‘raw’, ‘multipart’).
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_PROJECTS

Tool to list BigQuery projects to which the user has been granted any project role. Returns projects with at least READ access. For enhanced capabilities, consider using the Resource Manager API.

NameTypeRequiredDescription
page_tokenstringNoPage token returned by a previous call, to request the next page of results.
max_resultsintegerNoMaximum number of projects to return per page. If not set, returns all results up to 50 per page.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_QUERY_TEMPLATES

Tool to list all query templates in a given Analytics Hub data exchange. Use when you need to discover available query templates that define predefined and approved queries for data clean room use cases.

NameTypeRequiredDescription
parentstringYesRequired. The parent resource path of the QueryTemplates. Format: projects/{project}/locations/{location}/dataExchanges/{dataExchange}.
pageSizeintegerNoThe maximum number of results to return in a single response page.
pageTokenstringNoPage token, returned by a previous call, to request the next page of results.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_RESERVATION_ASSIGNMENTS

Tool to list BigQuery reservation assignments. Only explicitly created assignments will be returned (no expansion or merge happens). Use wildcard ”-” in parent path to list assignments across all reservations in a location.

NameTypeRequiredDescription
parentstringYesRequired. The parent resource name of the reservation. Format: projects/{project_id}/locations/{location}/reservations/{reservation_id} or projects/{project_id}/locations/{location}/reservations/- (wildcard to list assignments across all reservations).
page_sizeintegerNoMaximum number of assignments to return per page.
page_tokenstringNoPage token from a previous ListAssignments response.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_RESERVATION_GROUPS

Tool to list all BigQuery reservation groups for a project in a specified location. Use when you need to discover available reservation groups which serve as containers for reservations.

NameTypeRequiredDescription
parentstringYesRequired. The parent resource name containing project and location in the format projects/{projectId}/locations/{location}.
page_sizeintegerNoThe maximum number of items to return per page.
page_tokenstringNoThe next_page_token value returned from a previous List request, if any.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_RESERVATIONS

Tool to list all BigQuery reservations for a project in a specified location. Use when you need to discover available reservations or view reservation details including slot capacity and autoscale configuration.

NameTypeRequiredDescription
altstring ("json" | "media" | "proto")NoData format for response.
keystringNoAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
xgafvstring ("1" | "2")NoV1 error format.
fieldsstringNoSelector specifying which fields to include in a partial response.
parentstringYesRequired. The parent resource name containing project and location, e.g.: projects/myproject/locations/US. The location must be specified (e.g., US, EU, us-central1).
callbackstringNoJSONP
page_sizeintegerNoThe maximum number of items to return per page.
page_tokenstringNoThe next_page_token value returned from a previous List request, if any.
quota_userstringNoAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
oauth_tokenstringNoOAuth 2.0 token for the current user.
upload_typestringNoLegacy upload protocol for media (e.g. ‘media’, ‘multipart’).
access_tokenstringNoOAuth access token.
pretty_printbooleanNoReturns response with indentations and line breaks.
upload_protocolstringNoUpload protocol for media (e.g. ‘raw’, ‘multipart’).
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_ROUTINES

Tool to list all routines (user-defined functions and stored procedures) in a BigQuery dataset. Requires the READER dataset role. Use this to discover available routines before executing or inspecting them.

NameTypeRequiredDescription
filterstringNoIf set, then only the Routines matching this filter are returned. The supported format is routineType:{RoutineType}, where {RoutineType} is a RoutineType enum. For example: routineType:SCALAR_FUNCTION.
readMaskstringNoIf set, then only the Routine fields in the field mask, as well as project_id, dataset_id and routine_id, are returned in the response.
pageTokenstringNoPage token, returned by a previous call, to request the next page of results.
dataset_idstringYesRequired. Dataset ID of the routines to list.
maxResultsintegerNoThe maximum number of results to return in a single response page.
project_idstringYesRequired. Project ID of the routines to list.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_ROW_ACCESS_POLICIES

Tool to list all row access policies on a specified BigQuery table. Use when you need to discover which row-level security policies are applied to a table and their filter predicates.

NameTypeRequiredDescription
table_idstringYesRequired. Table ID of the table to list row access policies.
page_sizeintegerNoThe maximum number of results to return in a single response page.
dataset_idstringYesRequired. Dataset ID of row access policies to list.
page_tokenstringNoPage token, returned by a previous call, to request the next page of results.
project_idstringYesRequired. Project ID of the row access policies to list.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_TABLE_DATA

Tool to list the content of a BigQuery table in rows via the REST API. Use this to retrieve actual data from a table without writing SQL queries. Returns paginated results with row data in the native BigQuery format.

NameTypeRequiredDescription
table_idstringYesRequired. Table ID of the table to list.
dataset_idstringYesRequired. Dataset ID of the table to list.
page_tokenstringNoTo retrieve the next page of table data, set this field to the string provided in the pageToken field of the response body from your previous call to tabledata.list.
project_idstringYesRequired. Project ID of the table to list.
max_resultsintegerNoRow limit of the table. Maximum number of rows to return per page.
start_indexstringNoStart row index of the table.
selected_fieldsstringNoSubset of fields to return, supports select into sub fields. Example: selected_fields = 'a,e.d.f'.
format_options_use_int64_timestampbooleanNoOptional. Output timestamp as usec int64. Default is false.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_LIST_TABLES

Tool to list tables in a BigQuery dataset via the REST API. Use this early in exploration to discover accessible tables without relying on INFORMATION_SCHEMA, especially when SQL-based metadata queries are blocked or restricted. This provides a deterministic inventory of tables even when dataset-level permissions prevent INFORMATION_SCHEMA access.

NameTypeRequiredDescription
dataset_idstringYesThe dataset ID to list tables from.
page_tokenstringNoPage token for pagination.
project_idstringYesThe project ID containing the dataset.
max_resultsintegerNoMaximum number of tables to return per page.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_PATCH_DATASET

Tool to update an existing BigQuery dataset using RFC5789 PATCH semantics. Only replaces fields provided in the request, leaving other fields unchanged. Use when you need to modify dataset properties like description, labels, expiration settings, or access controls without affecting other configuration.

NameTypeRequiredDescription
accessarrayNoOptional. An array of objects that define dataset access for one or more entities.
labelsobjectNoThe labels associated with this dataset. You can use these to organize and group your datasets.
locationstringNoThe geographic location where the dataset should reside.
dataset_idstringYesRequired. Dataset ID of the dataset being updated.
project_idstringYesRequired. Project ID of the dataset being updated.
descriptionstringNoOptional. A user-friendly description of the dataset.
friendlyNamestringNoOptional. A descriptive name for the dataset.
datasetReferenceobjectNoDataset reference for patching.
defaultCollationstringNoOptional. Defines the default collation specification of future tables created in the dataset. Supported values: und:ci (case insensitive) or '' (case sensitive).
isCaseInsensitivebooleanNoOptional. TRUE if the dataset and its table names are case-insensitive, otherwise FALSE.
maxTimeTravelHoursstringNoOptional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days).
defaultRoundingModestring ("ROUNDING_MODE_UNSPECIFIED" | "ROUND_HALF_AWAY_FROM_ZERO" | "ROUND_HALF_EVEN")NoOptional. Defines the default rounding mode specification of new tables created within this dataset.
linkedDatasetSourceobjectNoLinked dataset source configuration.
storageBillingModelstring ("STORAGE_BILLING_MODEL_UNSPECIFIED" | "LOGICAL" | "PHYSICAL")NoOptional. Updates storage_billing_model for the dataset.
defaultTableExpirationMsstringNoOptional. The default lifetime of all tables in the dataset, in milliseconds. Minimum value is 3600000 (one hour). Set to 0 to clear.
externalDatasetReferenceobjectNoExternal dataset reference configuration.
defaultPartitionExpirationMsstringNoDefault partition expiration in milliseconds.
defaultEncryptionConfigurationobjectNoEncryption configuration for the dataset.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_PATCH_MODEL

Tool to update specific fields in an existing BigQuery ML model using PATCH semantics. Use when you need to modify model metadata like description, friendly name, labels, or expiration time without replacing the entire model resource.

NameTypeRequiredDescription
labelsobjectNoThe labels associated with this model. Label keys and values can be no longer than 63 characters, can only contain lowercase letters, numeric characters, underscores and dashes.
model_idstringYesRequired. Model ID of the model to patch.
dataset_idstringYesRequired. Dataset ID of the model to patch.
project_idstringYesRequired. Project ID of the model to patch.
descriptionstringNoOptional. A user-friendly description of this model.
friendlyNamestringNoOptional. A descriptive name for this model.
expirationTimestringNoOptional. The time when this model expires, in milliseconds since the epoch. If not present, the model will persist indefinitely.
encryptionConfigurationobjectNoEncryption configuration for the model.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_PATCH_TABLE

Tool to update specific fields in an existing BigQuery table using RFC5789 PATCH semantics. Only the fields provided in the request are updated; unspecified fields remain unchanged. Use when you need to modify table metadata like description, friendly name, labels, or expiration time without replacing the entire table resource.

NameTypeRequiredDescription
labelsobjectNoLabels to organize and categorize the table. Keys and values must be lowercase, max 63 characters.
table_idstringYesThe table ID to update.
dataset_idstringYesThe dataset ID containing the table to update.
project_idstringYesThe project ID containing the table to update.
descriptionstringNoUser-friendly description of the table.
friendlyNamestringNoA descriptive name for the table that appears in the BigQuery UI.
expirationTimestringNoThe time when this table expires, in milliseconds since the epoch.
autodetect_schemabooleanNoWhen true, will autodetect schema; otherwise will keep the original schema.
requirePartitionFilterbooleanNoIf true, queries over this table require a partition filter that can be used for partition elimination.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_QUERY

Query Tool runs a SQL query in BigQuery using the REST API. Use proper BigQuery SQL syntax, e.g., SELECT * FROM \project.dataset.table` WHERE column_name = ‘value’`. Results are returned under data.rows; an empty rows array means no matching data. Large result sets may be returned via remote_file_info instead of inline rows. Verify exact project_id, dataset, table, and column names before running; wrong identifiers trigger invalidQuery or notFound errors.

NameTypeRequiredDescription
querystringYesQuery to run on BigQuery. Use standard SQL syntax.
locationstringNoGeographic location where the query should run (e.g., US, EU, us-central1). Defaults to US multi-region. Must match the dataset’s actual geographic location; mismatched regions cause query failure.
project_idstringYesThe project ID to run the query against.
timeout_msintegerNoQuery timeout in milliseconds. Defaults to 10000 (10 seconds).
max_resultsintegerNoMaximum number of rows to return. If not specified, returns all rows.
use_legacy_sqlbooleanNoWhether to use legacy SQL syntax. Defaults to False (standard SQL).
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

Search All BigQuery Reservation Assignments

Section titled “Search All BigQuery Reservation Assignments”

GOOGLEBIGQUERY_SEARCH_ALL_ASSIGNMENTS

Tool to search all BigQuery reservation assignments for a specified resource in a particular region. Use when you need to find assignments for a project, folder, or organization. Returns assignments created on the resource or its closest ancestor, covering all JobTypes.

NameTypeRequiredDescription
altstring ("json" | "media" | "proto")NoData format for response.
keystringNoAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
querystringNoPlease specify resource name as assignee in the query. Examples: assignee=projects/myproject, assignee=folders/123, assignee=organizations/456
xgafvstring ("1" | "2")NoV1 error format.
fieldsstringNoSelector specifying which fields to include in a partial response.
parentstringYesRequired. The resource name with location (project name could be the wildcard -), e.g.: projects/-/locations/US.
callbackstringNoJSONP
page_sizeintegerNoThe maximum number of items to return per page.
page_tokenstringNoThe next_page_token value returned from a previous List request, if any.
quota_userstringNoAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
oauth_tokenstringNoOAuth 2.0 token for the current user.
upload_typestringNoLegacy upload protocol for media (e.g. ‘media’, ‘multipart’).
access_tokenstringNoOAuth access token.
pretty_printbooleanNoReturns response with indentations and line breaks.
upload_protocolstringNoUpload protocol for media (e.g. ‘raw’, ‘multipart’).
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_SET_ROUTINE_IAM_POLICY

Tool to set the IAM access control policy for a BigQuery routine resource. Use this to grant or modify access permissions for users, service accounts, or groups. Include the etag from getIamPolicy to prevent concurrent modifications.

NameTypeRequiredDescription
policyobjectYesThe IAM policy to set, containing bindings (array of role-members mappings), optional etag and version.
dataset_idstringYesRequired. Dataset ID of the routine.
project_idstringYesRequired. Project ID of the routine.
routine_idstringYesRequired. Routine ID.
update_maskstringNoField mask for selective policy updates. Specify fields to update (e.g., bindings,etag).
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_TEST_ROUTINE_IAM_PERMISSIONS

Tool to test which IAM permissions the caller has on a BigQuery routine. Returns the subset of requested permissions that the caller actually has. Use to verify access before performing operations.

NameTypeRequiredDescription
dataset_idstringYesRequired. Dataset ID of the routine to test IAM permissions for.
project_idstringYesRequired. Project ID of the routine to test IAM permissions for.
routine_idstringYesRequired. Routine ID to test IAM permissions for.
permissionsarrayYesRequired. The set of permissions to check for the resource. Array of permission strings like bigquery.routines.get, bigquery.routines.update, bigquery.routines.delete.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_UNDELETE_DATASET

Tool to undelete a BigQuery dataset within the time travel window. If a deletion time is specified, the dataset version deleted at that time is undeleted; otherwise, the most recently deleted version is restored.

NameTypeRequiredDescription
dataset_idstringYesRequired. Dataset ID of the dataset being undeleted.
project_idstringYesRequired. Project ID of the dataset to be undeleted.
deletion_timestringNoOptional. The exact time when the dataset was deleted (RFC3339 format). If not specified, it will undelete the most recently deleted version.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_UPDATE_CONNECTION

Tool to update a specified BigQuery connection using the BigQuery Connection API. Use when you need to modify connection properties such as friendly name, description, or connection-specific settings. For security reasons, credentials are automatically reset if connection properties are included in the update mask.

NameTypeRequiredDescription
awsobjectNoConnection properties specific to Amazon Web Services.
namestringYesRequired. Name of the connection to update in the format projects/{project_id}/locations/{location_id}/connections/{connection_id}.
azureobjectNoConnection properties specific to Azure.
sparkobjectNoConnection properties for Apache Spark.
cloudSqlobjectNoConnection properties specific to Cloud SQL.
kmsKeyNamestringNoOptional. The Cloud KMS key that is used for encryption.
updateMaskstringYesRequired. Update mask for the connection fields to be updated. Comma-separated list of field paths (e.g., friendlyName,description). For security reasons, credentials are reset if connection properties are in the mask.
descriptionstringNoUser provided description.
cloudSpannerobjectNoConnection properties specific to Cloud Spanner.
friendlyNamestringNoUser provided display name for the connection.
cloudResourceobjectNoConnection properties for delegation of access to GCP resources.
salesforceDataCloudobjectNoConnection properties specific to Salesforce DataCloud.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_UPDATE_DATASET

Tool to update information in an existing BigQuery dataset using the PUT method. The update method replaces the entire dataset resource, whereas the patch method only replaces fields that are provided in the submitted dataset resource. Use when you need to modify dataset properties like description, access controls, or default settings.

NameTypeRequiredDescription
accessarrayNoOptional. An array of objects that define dataset access for one or more entities. If unspecified, BigQuery adds default dataset access for projectReaders, projectWriters, projectOwners, and the dataset creator.
labelsobjectNoOptional. Labels to organize and categorize the dataset. Labels are key-value pairs. Keys and values must be lowercase, max 63 characters.
locationstringYesRequired. Geographic location where the dataset resides. This cannot be changed after dataset creation. Examples: US, EU, us-central1, europe-west1.
dataset_idstringYesRequired. Dataset ID of the dataset being updated. This is used in the URL path.
project_idstringYesRequired. Project ID of the dataset being updated. This is used in the URL path.
descriptionstringNoOptional. A user-friendly description of the dataset.
friendlyNamestringNoOptional. A descriptive name for the dataset. This is a user-friendly label that appears in the BigQuery UI.
datasetReferenceobjectYesRequired. Dataset reference containing the dataset ID and project ID. This must match the path parameters.
defaultCollationstringNoOptional. Defines the default collation specification of future tables created in the dataset. Supported values: und:ci (undetermined locale, case insensitive) or '' (empty string for case-sensitive).
isCaseInsensitivebooleanNoOptional. TRUE if the dataset and its table names are case-insensitive, otherwise FALSE. By default, this is FALSE.
maxTimeTravelHoursintegerNoOptional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days). The default value is 168 hours if this is not set.
defaultRoundingModestring ("ROUNDING_MODE_UNSPECIFIED" | "ROUND_HALF_AWAY_FROM_ZERO" | "ROUND_HALF_EVEN")NoOptional. Defines the default rounding mode specification of new tables created within this dataset.
linkedDatasetSourceobjectNoA dataset source type which refers to another BigQuery dataset.
storageBillingModelstring ("STORAGE_BILLING_MODEL_UNSPECIFIED" | "LOGICAL" | "PHYSICAL")NoOptional. Updates storage_billing_model for the dataset. LOGICAL uses logical bytes, PHYSICAL uses physical bytes.
defaultTableExpirationMsintegerNoOptional. The default lifetime of all tables in the dataset, in milliseconds. The minimum lifetime value is 3600000 milliseconds (one hour). To clear an existing default expiration, set to 0.
externalDatasetReferenceobjectNoConfigures the access a dataset defined in an external metadata storage.
defaultPartitionExpirationMsintegerNoOptional. The default partition expiration, expressed in milliseconds.
defaultEncryptionConfigurationobjectNoEncryption configuration for the dataset.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_UPDATE_ROUTINE

Tool to update an existing BigQuery routine (function or stored procedure). This replaces the entire routine resource with the provided definition. Use when modifying routine logic, arguments, return types, or other configuration. Ensure all required fields are provided as this is a full replacement operation.

NameTypeRequiredDescription
languagestringNoThe language of the routine. Options: SQL, JAVASCRIPT, PYTHON, JAVA, SCALA. Defaults to SQL if remote_function_options is absent.
argumentsarrayNoOptional. The list of arguments for the routine.
dataset_idstringYesThe dataset ID of the routine to update. Used in the URL path.
project_idstringYesThe project ID of the routine to update. Used in the URL path.
returnTypeobjectNoData type specification for BigQuery routine arguments and return values.
routine_idstringYesThe routine ID of the routine to update. Used in the URL path.
strictModebooleanNoOptional. For procedures, enables additional error checking. Default is TRUE.
descriptionstringNoOptional. A description of the routine.
routineTypestringYesREQUIRED. The type of routine. Options: SCALAR_FUNCTION, PROCEDURE, TABLE_VALUED_FUNCTION, AGGREGATE_FUNCTION.
securityModestringNoOptional. The security mode of the routine. Options: DEFINER, INVOKER.
sparkOptionsobjectNoOptions for a user-defined Spark routine.
definitionBodystringYesREQUIRED. The body of the routine. For SQL functions, this is the expression (without parentheses). For JavaScript, this is the evaluated string.
returnTableTypeobjectNoTable type returned by table-valued functions.
determinismLevelstringNoOptional. The determinism level of JavaScript UDFs. Options: DETERMINISTIC, NOT_DETERMINISTIC.
routineReferenceobjectYesREQUIRED. The routine reference in the request body. Must match the path parameters.
importedLibrariesarrayNoOptional. For JavaScript routines, the paths of imported JavaScript libraries.
dataGovernanceTypestringNoOptional. If set to DATA_MASKING, the function is validated as a masking function.
remoteFunctionOptionsobjectNoOptions for a remote user-defined function.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not

GOOGLEBIGQUERY_UPDATE_TABLE

Tool to update an existing BigQuery table. The update method replaces the entire Table resource, whereas the patch method only replaces fields that are provided. Use when you need to modify table properties like schema, description, labels, partitioning, or clustering configuration.

NameTypeRequiredDescription
labelsobjectNoOptional. Labels to organize and group your tables. Keys and values must be lowercase, max 63 characters.
schemaobjectNoSchema of a table.
table_idstringYesRequired. Table ID of the table to update.
clusteringobjectNoConfigures table clustering.
dataset_idstringYesRequired. Dataset ID of the table to update.
project_idstringYesRequired. Project ID of the table to update.
descriptionstringNoOptional. A user-friendly description of this table.
friendlyNamestringNoOptional. A descriptive name for this table.
expirationTimestringNoOptional. The time when this table expires, in milliseconds since the epoch.
tableReferenceobjectYesRequired. Reference identifying the table. Must match the path parameters.
defaultCollationstringNoOptional. Defines the default collation specification of new STRING fields in the table.
timePartitioningobjectNoConfigures time-based partitioning for the table.
autodetect_schemabooleanNoOptional. When true will autodetect schema, else will keep original schema.
rangePartitioningobjectNoConfigures range-based partitioning for the table.
requirePartitionFilterbooleanNoOptional. If set to true, queries over this table require a partition filter.
encryptionConfigurationobjectNoEncryption configuration for the table.
externalDataConfigurationobjectNoConfiguration for external data sources.
NameTypeRequiredDescription
datastringYesData from the action execution
errorstringNoError if any occurred during the execution of the action
successfulbooleanYesWhether or not the action execution was successful or not