{
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/cloud-billing": {
"description": "View and manage your Google Cloud Platform billing accounts"
},
"https://www.googleapis.com/auth/cloud-billing.readonly": {
"description": "View your Google Cloud Platform billing accounts"
},
"https://www.googleapis.com/auth/cloud-platform": {
"description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account."
}
}
}
},
"basePath": "",
"baseUrl": "https://cloudbilling.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Cloudbilling",
"description": "Allows developers to manage billing for their Google Cloud Platform projects programmatically.",
"discoveryVersion": "v1",
"documentationLink": "https://cloud.google.com/billing/docs/apis",
"fullyEncodeReservedExpansion": true,
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"id": "cloudbilling:v1beta",
"kind": "discovery#restDescription",
"mtlsRootUrl": "https://cloudbilling.mtls.googleapis.com/",
"name": "cloudbilling",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"$.xgafv": {
"description": "V1 error format.",
"enum": [
"1",
"2"
],
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query",
"type": "string"
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
"alt": {
"default": "json",
"description": "Data format for response.",
"enum": [
"json",
"media",
"proto"
],
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query",
"type": "string"
},
"callback": {
"description": "JSONP",
"location": "query",
"type": "string"
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
"key": {
"description": "API 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.",
"location": "query",
"type": "string"
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"type": "string"
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
"resources": {
"billingAccounts": {
"resources": {
"services": {
"methods": {
"get": {
"description": "Gets a Google Cloud service visible to a billing account.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/services/{servicesId}",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.services.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the billing account service to retrieve. Format: billingAccounts/{billing_account}/services/{service}",
"location": "path",
"pattern": "^billingAccounts/[^/]+/services/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+name}",
"response": {
"$ref": "GoogleCloudBillingBillingaccountservicesV1betaBillingAccountService"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
},
"list": {
"description": "Lists services visible to a billing account.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/services",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.services.list",
"parameterOrder": [
"parent"
],
"parameters": {
"pageSize": {
"description": "Maximum number of billing account service to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Page token received from a previous ListBillingAccountServices call to retrieve the next page of results. If this field is empty, the first page is returned.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. The billing account to list billing account service from. Format: billingAccounts/{billing_account}",
"location": "path",
"pattern": "^billingAccounts/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+parent}/services",
"response": {
"$ref": "GoogleCloudBillingBillingaccountservicesV1betaListBillingAccountServicesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
},
"skuGroups": {
"methods": {
"get": {
"description": "Gets a SKU group visible to a billing account.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/skuGroups/{skuGroupsId}",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.skuGroups.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the BillingAccountSkuGroup to retrieve. Format: billingAccounts/{billing_account}/skuGroups/{sku_group}",
"location": "path",
"pattern": "^billingAccounts/[^/]+/skuGroups/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+name}",
"response": {
"$ref": "GoogleCloudBillingBillingaccountskugroupsV1betaBillingAccountSkuGroup"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
},
"list": {
"description": "Lists SKU groups visible to a billing account.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/skuGroups",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.skuGroups.list",
"parameterOrder": [
"parent"
],
"parameters": {
"pageSize": {
"description": "Maximum number of billing account SKU groups to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Page token received from a previous ListBillingAccountSkuGroups call to retrieve the next page of results. If this field is empty, the first page is returned.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. The billing account to list billing account SKU groups from. Format: billingAccounts/{billing_account}",
"location": "path",
"pattern": "^billingAccounts/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+parent}/skuGroups",
"response": {
"$ref": "GoogleCloudBillingBillingaccountskugroupsV1betaListBillingAccountSkuGroupsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
},
"resources": {
"skus": {
"methods": {
"get": {
"description": "Gets a SKU that is part of a billing account SKU group.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/skuGroups/{skuGroupsId}/skus/{skusId}",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.skuGroups.skus.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the billing account SKU group SKU to retrieve. Format: billingAccounts/{billing_account}/skuGroups/{sku_group}/skus/{sku}",
"location": "path",
"pattern": "^billingAccounts/[^/]+/skuGroups/[^/]+/skus/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+name}",
"response": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaBillingAccountSkuGroupSku"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
},
"list": {
"description": "Lists SKUs that is part of billing account SKU groups.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/skuGroups/{skuGroupsId}/skus",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.skuGroups.skus.list",
"parameterOrder": [
"parent"
],
"parameters": {
"pageSize": {
"description": "Maximum number of billing account SKU group SKUs to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Page token received from a previous ListBillingAccountSkuGroupSkus call to retrieve the next page of results. If this field is empty, the first page is returned.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. The billing account SKU group to list billing account SKU group SKUs from. Format: billingAccounts/{billing_account}/skuGroups/{sku_group}",
"location": "path",
"pattern": "^billingAccounts/[^/]+/skuGroups/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+parent}/skus",
"response": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaListBillingAccountSkuGroupSkusResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
}
}
},
"skus": {
"methods": {
"get": {
"description": "Gets a SKU visible to a billing account.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/skus/{skusId}",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.skus.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the billing account SKU to retrieve. Format: billingAccounts/{billing_account}/skus/{sku}",
"location": "path",
"pattern": "^billingAccounts/[^/]+/skus/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+name}",
"response": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaBillingAccountSku"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
},
"list": {
"description": "Lists SKUs visible to a billing account.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/skus",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.skus.list",
"parameterOrder": [
"parent"
],
"parameters": {
"filter": {
"description": "Options for how to filter the billing account SKUs. Currently, only filter on `billing_account_service` is supported. Only !=, = operators are supported. Examples: - billing_account_service = \"billingAccounts/012345-567890-ABCDEF/services/DA34-426B-A397\"",
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Maximum number of billing account SKUs to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Page token received from a previous ListBillingAccountSkus call to retrieve the next page of results. If this field is empty, the first page is returned.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. The billing account to list billing account SKU from. Format: billingAccounts/{billing_account}",
"location": "path",
"pattern": "^billingAccounts/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+parent}/skus",
"response": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaListBillingAccountSkusResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
},
"resources": {
"price": {
"methods": {
"get": {
"description": "Gets the latest price for SKUs available to your Cloud Billing account.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/skus/{skusId}/price",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.skus.price.get",
"parameterOrder": [
"name"
],
"parameters": {
"currencyCode": {
"description": "Optional. ISO-4217 currency code for the price. If not specified, the currency of the billing account is used.",
"location": "query",
"type": "string"
},
"name": {
"description": "Required. Name of the billing account price to retrieve. Format: billingAccounts/{billing_account}/skus/{sku}/price",
"location": "path",
"pattern": "^billingAccounts/[^/]+/skus/[^/]+/price$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+name}",
"response": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaBillingAccountPrice"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
},
"prices": {
"methods": {
"list": {
"description": "Lists the latest prices for SKUs available to your Cloud Billing account.",
"flatPath": "v1beta/billingAccounts/{billingAccountsId}/skus/{skusId}/prices",
"httpMethod": "GET",
"id": "cloudbilling.billingAccounts.skus.prices.list",
"parameterOrder": [
"parent"
],
"parameters": {
"currencyCode": {
"description": "Optional. ISO-4217 currency code for the price. If not specified, currency of billing account will be used.",
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Optional. Maximum number of billing account price to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Optional. Page token received from a previous ListBillingAccountPrices call to retrieve the next page of results. If this field is empty, the first page is returned.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. To list all Billing Account SKUs, use `-` as the SKU ID. Format: `billingAccounts/{billing_account}/skus/-` Note: Specifying an actual SKU resource id will return a collection of one Billing Account Price.",
"location": "path",
"pattern": "^billingAccounts/[^/]+/skus/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+parent}/prices",
"response": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
}
}
}
}
},
"skuGroups": {
"methods": {
"get": {
"description": "Gets a publicly listed SKU group.",
"flatPath": "v1beta/skuGroups/{skuGroupsId}",
"httpMethod": "GET",
"id": "cloudbilling.skuGroups.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the SKU group to retrieve. Format: skuGroups/{sku_group}",
"location": "path",
"pattern": "^skuGroups/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+name}",
"response": {
"$ref": "GoogleCloudBillingSkugroupsV1betaSkuGroup"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
},
"list": {
"description": "Lists all publicly listed SKU groups.",
"flatPath": "v1beta/skuGroups",
"httpMethod": "GET",
"id": "cloudbilling.skuGroups.list",
"parameterOrder": [],
"parameters": {
"pageSize": {
"description": "Maximum number of SKU groups to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Page token received from a previous ListSkuGroups call to retrieve the next page of results. If this field is empty, the first page is returned.",
"location": "query",
"type": "string"
}
},
"path": "v1beta/skuGroups",
"response": {
"$ref": "GoogleCloudBillingSkugroupsV1betaListSkuGroupsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
},
"resources": {
"skus": {
"methods": {
"get": {
"description": "Gets a publicly listed SKU that is part of a publicly listed SKU group.",
"flatPath": "v1beta/skuGroups/{skuGroupsId}/skus/{skusId}",
"httpMethod": "GET",
"id": "cloudbilling.skuGroups.skus.get",
"parameterOrder": [
"name"
],
"parameters": {
"name": {
"description": "Required. The name of the SKU group SKU to retrieve. Format: skuGroups/{sku_group}/skus/{sku}",
"location": "path",
"pattern": "^skuGroups/[^/]+/skus/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+name}",
"response": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaSkuGroupSku"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
},
"list": {
"description": "Lists all publicly listed SKUs contained by a publicly listed SKU group.",
"flatPath": "v1beta/skuGroups/{skuGroupsId}/skus",
"httpMethod": "GET",
"id": "cloudbilling.skuGroups.skus.list",
"parameterOrder": [
"parent"
],
"parameters": {
"pageSize": {
"description": "Maximum number of SKU group SKUs to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Page token received from a previous ListSkuGroupSkus call to retrieve the next page of results. If this field is empty, the first page is returned.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. The SkuGroup to list SkuGroupSku from. Format: skuGroups/{sku_group}",
"location": "path",
"pattern": "^skuGroups/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+parent}/skus",
"response": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaListSkuGroupSkusResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
}
}
},
"skus": {
"resources": {
"price": {
"methods": {
"get": {
"description": "Gets the latest price for the given SKU.",
"flatPath": "v1beta/skus/{skusId}/price",
"httpMethod": "GET",
"id": "cloudbilling.skus.price.get",
"parameterOrder": [
"name"
],
"parameters": {
"currencyCode": {
"description": "Optional. ISO-4217 currency code for the price. If not specified, USD will be used.",
"location": "query",
"type": "string"
},
"name": {
"description": "Required. Name of the latest price to retrieve. Format: skus/{sku}/price",
"location": "path",
"pattern": "^skus/[^/]+/price$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+name}",
"response": {
"$ref": "GoogleCloudBillingPricesV1betaPrice"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
},
"prices": {
"methods": {
"list": {
"description": "Lists the latest prices for all SKUs.",
"flatPath": "v1beta/skus/{skusId}/prices",
"httpMethod": "GET",
"id": "cloudbilling.skus.prices.list",
"parameterOrder": [
"parent"
],
"parameters": {
"currencyCode": {
"description": "Optional. ISO-4217 currency code for the price. If not specified, USD will be used.",
"location": "query",
"type": "string"
},
"pageSize": {
"description": "Optional. Maximum number of prices to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Optional. Page token received from a previous ListPrices call to retrieve the next page of results. If this field is empty, the first page is returned.",
"location": "query",
"type": "string"
},
"parent": {
"description": "Required. To list the prices for all SKUs, use `-` as the SKU ID. Format: `skus/-` Specifying a specific SKU ID returns a collection with one Price object for the SKU.",
"location": "path",
"pattern": "^skus/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v1beta/{+parent}/prices",
"response": {
"$ref": "GoogleCloudBillingPricesV1betaListPricesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
}
}
},
"v1beta": {
"methods": {
"generateInsights": {
"description": "Analyzes cost data for a billing account and/or specific projects. Returns a natural language summary and supporting datasets.",
"flatPath": "v1beta:generateInsights",
"httpMethod": "POST",
"id": "cloudbilling.generateInsights",
"parameterOrder": [],
"parameters": {},
"path": "v1beta:generateInsights",
"request": {
"$ref": "GenerateInsightsRequest"
},
"response": {
"$ref": "GenerateInsightsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-billing",
"https://www.googleapis.com/auth/cloud-billing.readonly",
"https://www.googleapis.com/auth/cloud-platform"
]
}
}
}
},
"revision": "20260320",
"rootUrl": "https://cloudbilling.googleapis.com/",
"schemas": {
"AgenticQueryInfo": {
"description": "A local representation of the query used to fetch the data. This is used instead of the raw QueryBillingDataRequest to avoid pulling in Cloud Policy Enforcement (CPE) resource_type annotations into the response payload, which causes ESF validation failures.",
"id": "AgenticQueryInfo",
"properties": {
"columns": {
"description": "The columns queried.",
"type": "string"
},
"filter": {
"description": "The filter applied to the query.",
"type": "string"
},
"groupBy": {
"description": "The group-by clause applied to the query.",
"type": "string"
},
"limit": {
"description": "The row limit applied to the query.",
"format": "int32",
"type": "integer"
},
"orderBy": {
"description": "The order-by clause applied to the query.",
"type": "string"
},
"parents": {
"description": "The parents (e.g. projects, billing accounts) queried.",
"items": {
"type": "string"
},
"type": "array"
},
"view": {
"description": "The view queried.",
"type": "string"
}
},
"type": "object"
},
"Array": {
"description": "An ordered collection of elements of arbitrary count.",
"id": "Array",
"properties": {
"element": {
"description": "The elements of the array.",
"items": {
"$ref": "ValueProto"
},
"type": "array"
}
},
"type": "object"
},
"BillingData": {
"description": "Encapsulates billing data.",
"id": "BillingData",
"properties": {
"columnInfo": {
"description": "Information about columns.",
"items": {
"$ref": "ColumnInfo"
},
"type": "array"
},
"rows": {
"description": "Rows.",
"items": {
"$ref": "Row"
},
"type": "array"
}
},
"type": "object"
},
"BillingDataResource": {
"description": "Specifies a Billing data resource that can be used for authorization to access billing data.",
"id": "BillingDataResource",
"properties": {
"billingAccount": {
"description": "Optional. If not provided the billing account currently associated with the resource will be used.",
"type": "string"
},
"resource": {
"description": "Required. Resource name for an entitity that can be used for authorization to access billing data such as `projects/{project}` or `billingAccounts/{billing_account}`",
"type": "string"
}
},
"type": "object"
},
"ColumnInfo": {
"description": "Represents a column header.",
"id": "ColumnInfo",
"properties": {
"column": {
"description": "Name of the column.",
"type": "string"
}
},
"type": "object"
},
"DataSet": {
"description": "A dataset used to support an insight, suitable for UI rendering (tables/charts).",
"id": "DataSet",
"properties": {
"billingData": {
"$ref": "BillingData",
"description": "Output only. Actual billing data returned from the Data Mart. Uses the formal message from the Billing Data Service.",
"readOnly": true
},
"queryInfo": {
"$ref": "AgenticQueryInfo",
"description": "Output only. The query used to fetch this data.",
"readOnly": true
},
"suggestedChart": {
"$ref": "SuggestedChart",
"description": "Output only. A suggested chart for the data set, used for UI rendering.",
"readOnly": true
}
},
"type": "object"
},
"Datetime": {
"description": "A datetime value.",
"id": "Datetime",
"properties": {
"bitFieldDatetimeSeconds": {
"description": "Represents bit field encoding of year/month/day/hour/minute/second. See class DatetimeValue in civil_time.h for details of encoding.",
"format": "int64",
"type": "string"
},
"nanos": {
"description": "Non-negative fractions of a second at nanosecond resolution.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"Decimal": {
"description": "A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's [BigDecimal](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/math/BigDecimal.html) or Python's [decimal.Decimal](https://docs.python.org/3/library/decimal.html).",
"id": "Decimal",
"properties": {
"value": {
"description": "The decimal value, as a string. The string representation consists of an optional sign, `+` (`U+002B`) or `-` (`U+002D`), followed by a sequence of zero or more decimal digits (\"the integer\"), optionally followed by a fraction, optionally followed by an exponent. An empty string **should** be interpreted as `0`. The fraction consists of a decimal point followed by zero or more decimal digits. The string must contain at least one digit in either the integer or the fraction. The number formed by the sign, the integer and the fraction is referred to as the significand. The exponent consists of the character `e` (`U+0065`) or `E` (`U+0045`) followed by one or more decimal digits. Services **should** normalize decimal values before storing them by: - Removing an explicitly-provided `+` sign (`+2.5` -> `2.5`). - Replacing a zero-length integer value with `0` (`.5` -> `0.5`). - Coercing the exponent character to upper-case, with explicit sign (`2.5e8` -> `2.5E+8`). - Removing an explicitly-provided zero exponent (`2.5E0` -> `2.5`). Services **may** perform additional normalization based on its own needs and the internal decimal implementation selected, such as shifting the decimal point and exponent value together (example: `2.5E-1` <-> `0.25`). Additionally, services **may** preserve trailing zeroes in the fraction to indicate increased precision, but are not required to do so. Note that only the `.` character is supported to divide the integer and the fraction; `,` **should not** be supported regardless of locale. Additionally, thousand separators **should not** be supported. If a service does support them, values **must** be normalized. The ENBF grammar is: DecimalString = '' | [Sign] Significand [Exponent]; Sign = '+' | '-'; Significand = Digits '.' | [Digits] '.' Digits; Exponent = ('e' | 'E') [Sign] Digits; Digits = { '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' }; Services **should** clearly document the range of supported values, the maximum supported precision (total number of digits), and, if applicable, the scale (number of digits after the decimal point), as well as how it behaves when receiving out-of-bounds values. Services **may** choose to accept values passed as input even when the value has a higher precision or scale than the service supports, and **should** round the value to fit the supported scale. Alternatively, the service **may** error with `400 Bad Request` (`INVALID_ARGUMENT` in gRPC) if precision would be lost. Services **should** error with `400 Bad Request` (`INVALID_ARGUMENT` in gRPC) if the service receives a value outside of the supported range.",
"type": "string"
}
},
"type": "object"
},
"FinalResult": {
"description": "Encapsulates all structured data and the completed summary.",
"id": "FinalResult",
"properties": {
"dataSets": {
"description": "Output only. Data sets used to support the insights, suitable for UI rendering (tables/charts).",
"items": {
"$ref": "DataSet"
},
"readOnly": true,
"type": "array"
},
"fullAnalysis": {
"description": "Output only. Contains the full natural language analysis, including thoughts, reasoning, and references.",
"readOnly": true,
"type": "string"
},
"insights": {
"description": "Output only. A list of discrete insights gleaned from the data.",
"items": {
"$ref": "Insight"
},
"readOnly": true,
"type": "array"
},
"interopLinks": {
"description": "Output only. Links to interoperable tools (e.g., pre-filtered Cost Reports or BQE queries).",
"items": {
"$ref": "InteropLink"
},
"readOnly": true,
"type": "array"
},
"suggestedQueries": {
"description": "Output only. A list of suggested follow-up queries for the user.",
"items": {
"$ref": "SuggestedQuery"
},
"readOnly": true,
"type": "array"
},
"summary": {
"description": "Output only. The full natural language summary (re-sent for consistency).",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"GenerateInsightsRequest": {
"description": "Request for GenerateInsights.",
"id": "GenerateInsightsRequest",
"properties": {
"filter": {
"description": "Optional. Filters cost data by service id. Follows https://google.aip.dev/160 for the filter syntax. eg. filter: \"service = 'C7E2-9256-1C43'\"",
"type": "string"
},
"overriddenMaxIterationCounts": {
"description": "Optional. Overrides the maximum iterations for any selected strategy.",
"format": "int32",
"type": "integer"
},
"parents": {
"description": "Optional. The billing account or projects to analyze.",
"items": {
"$ref": "BillingDataResource"
},
"type": "array"
},
"prompt": {
"description": "Required. The natural language prompt from the user.",
"type": "string"
},
"userContext": {
"$ref": "UserContext",
"description": "Optional. Additional context for personalization (e.g., user persona, role)."
}
},
"type": "object"
},
"GenerateInsightsResponse": {
"description": "Response for GenerateInsights.",
"id": "GenerateInsightsResponse",
"properties": {
"finalResult": {
"$ref": "FinalResult",
"description": "Output only. The final structured results and metadata. Usually sent as the final message in the stream.",
"readOnly": true
},
"rejection": {
"$ref": "Rejection",
"description": "Output only. The request was rejected (e.g. out of scope).",
"readOnly": true
},
"summaryChunk": {
"description": "Output only. A chunk of the natural language summary (customer-facing). The UI can append these chunks to provide a real-time \"typing\" effect.",
"readOnly": true,
"type": "string"
},
"thoughtChunk": {
"description": "Output only. A chunk of the agent's internal reasoning process. The UI can use this to render a \"Thinking...\" log or status.",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaAggregationInfo": {
"description": "Encapsulates the aggregation information such as aggregation level and interval for a billing account price.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaAggregationInfo",
"properties": {
"interval": {
"description": "Interval at which usage is aggregated to compute cost. Example: \"MONTHLY\" interval indicates that usage is aggregated every month.",
"enum": [
"INTERVAL_UNSPECIFIED",
"INTERVAL_MONTHLY",
"INTERVAL_DAILY"
],
"enumDescriptions": [
"Default unspecified value.",
"Usage is aggregated every month.",
"Usage is aggregated every day."
],
"type": "string"
},
"level": {
"description": "Level at which usage is aggregated to compute cost. Example: \"ACCOUNT\" level indicates that usage is aggregated across all projects in a single account.",
"enum": [
"LEVEL_UNSPECIFIED",
"LEVEL_ACCOUNT",
"LEVEL_PROJECT"
],
"enumDescriptions": [
"Default unspecified value.",
"Usage is aggregated at an account level.",
"Usage is aggregated at a project level."
],
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaBillingAccountPrice": {
"description": "Encapsulates the latest price for a billing account SKU.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaBillingAccountPrice",
"properties": {
"currencyCode": {
"description": "ISO-4217 currency code for the price.",
"type": "string"
},
"name": {
"description": "Resource name for the latest billing account price.",
"type": "string"
},
"priceReason": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaPriceReason",
"description": "Background information on the origin of the price."
},
"rate": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaRate",
"description": "Rate price metadata. Billing account SKUs with `Rate` price are offered by pricing tiers. The price can have 1 or more rate pricing tiers."
},
"valueType": {
"description": "Type of the price. The possible values are: [\"unspecified\", \"rate\"].",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaDefaultPrice": {
"description": "Encapsulates a default price which is the current list price.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaDefaultPrice",
"properties": {},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaFixedDiscount": {
"description": "Encapsulates a discount off the list price, anchored to the list price as of a fixed time.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaFixedDiscount",
"properties": {
"discountPercent": {
"$ref": "Decimal",
"description": "Percentage of the fixed discount."
},
"discountScopeType": {
"description": "Type of the fixed discount scope which indicates the source of the discount. It can have values such as 'unspecified' and 'sku-group'.",
"type": "string"
},
"fixTime": {
"description": "Time that the fixed discount is anchored to.",
"format": "google-datetime",
"type": "string"
},
"skuGroup": {
"description": "SKU group where the fixed discount comes from.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaFixedPrice": {
"description": "Encapsulates a set fixed price applicable during the terms of a contract agreement.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaFixedPrice",
"properties": {},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaFloatingDiscount": {
"description": "Encapsulates a discount off the current list price, not anchored to any list price as of a fixed time.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaFloatingDiscount",
"properties": {
"discountPercent": {
"$ref": "Decimal",
"description": "Percentage of the floating discount."
},
"discountScopeType": {
"description": "Type of the floating discount scope which indicates the source of the discount. It can have values such as 'unspecified' and 'sku-group'.",
"type": "string"
},
"skuGroup": {
"description": "SKU group where the floating discount comes from.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse": {
"description": "Response message for ListBillingAccountPrices.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaListBillingAccountPricesResponse",
"properties": {
"billingAccountPrices": {
"description": "The returned billing account prices.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaBillingAccountPrice"
},
"type": "array"
},
"nextPageToken": {
"description": "Token that can be sent as `page_token` in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaListPriceAsCeiling": {
"description": "Encapsulates a contract feature that the list price (DefaultPrice) will be used for the price if the current list price drops lower than the custom fixed price. Available to new contracts after March 21, 2022. Applies to all fixed price SKUs in the contract, including FixedPrice, FixedDiscount, MigratedPrice, and MergedPrice.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaListPriceAsCeiling",
"properties": {},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaMergedPrice": {
"description": "Encapsulates a price after merging from multiple sources. With merged tiers, each individual tier can be from a different source with different discount types.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaMergedPrice",
"properties": {},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaMigratedPrice": {
"description": "Encapsulates a price migrated from other SKUs.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaMigratedPrice",
"properties": {
"sourceSku": {
"description": "Source SKU where the discount is migrated from. Format: billingAccounts/{billing_account}/skus/{sku}",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaPriceReason": {
"description": "Encapsulates a price reason which contains background information about the origin of the price.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaPriceReason",
"properties": {
"defaultPrice": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaDefaultPrice",
"description": "Default price which is the current list price."
},
"fixedDiscount": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaFixedDiscount",
"description": "Discount off the list price, anchored to the list price as of a fixed time."
},
"fixedPrice": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaFixedPrice",
"description": "Fixed price applicable during the terms of a contract agreement."
},
"floatingDiscount": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaFloatingDiscount",
"description": "Discount off the current list price, not anchored to any list price as of a fixed time."
},
"listPriceAsCeiling": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaListPriceAsCeiling",
"description": "Contract feature that the list price (DefaultPrice) will be used for the price if the current list price drops lower than the custom fixed price. Available to new contracts after March 21, 2022. Applies to all fixed price SKUs in the contract, including FixedPrice, FixedDiscount, MigratedPrice, and MergedPrice."
},
"mergedPrice": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaMergedPrice",
"description": "Price after merging from multiple sources."
},
"migratedPrice": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaMigratedPrice",
"description": "Price migrated from other SKUs."
},
"type": {
"description": "Type of the price reason. It can have values such as 'unspecified', 'default-price', 'fixed-price', 'fixed-discount', 'floating-discount', 'migrated-price', 'merged-price', 'list-price-as-ceiling'.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaRate": {
"description": "Encapsulates a `Rate` price. Billing account SKUs with `Rate` price are offered by pricing tiers. The price have 1 or more rate pricing tiers.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaRate",
"properties": {
"aggregationInfo": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaAggregationInfo",
"description": "Aggregation info for tiers such as aggregation level and interval."
},
"tiers": {
"description": "All tiers associated with the `Rate` price.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaRateTier"
},
"type": "array"
},
"unitInfo": {
"$ref": "GoogleCloudBillingBillingaccountpricesV1betaUnitInfo",
"description": "Unit info such as name and quantity."
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaRateTier": {
"description": "Encapsulates a rate price tier.",
"id": "GoogleCloudBillingBillingaccountpricesV1betaRateTier",
"properties": {
"contractPrice": {
"$ref": "Money",
"description": "Negotiated contract price specific for a billing account."
},
"effectiveDiscountPercent": {
"$ref": "Decimal",
"description": "Percentage of effective discount calculated using the current list price per pricing tier. Formula used: effective_discount_percent = (list_price - contract_price) / list_price \u00d7 100 If list_price and contract_price are zero, this field is the same as `discount_percent` of FixedDiscount and FloatingDiscount. If your contract does NOT have the feature LIST_PRICE_AS_CEILING enabled, the effective_discount_percent can be negative if the SKU has a FixedDiscount and the current list price is lower than the list price on the date of the contract agreement. See the `FixedDiscount.fix_time` on when the discount was set. If you have questions regarding pricing per SKU, contact your Account team for more details."
},
"listPrice": {
"$ref": "Money",
"description": "List price of one tier."
},
"startAmount": {
"$ref": "Decimal",
"description": "Lower bound amount for a tier. Tiers 0-100, 100-200 will be represented with two tiers with `start_amount` 0 and 100."
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountpricesV1betaUnitInfo": {
"description": "Encapsulates the unit information for a Rate",
"id": "GoogleCloudBillingBillingaccountpricesV1betaUnitInfo",
"properties": {
"unit": {
"description": "Shorthand for the unit. Example: GiBy.mo.",
"type": "string"
},
"unitDescription": {
"description": "Human-readable description of the unit. Example: gibibyte month.",
"type": "string"
},
"unitQuantity": {
"$ref": "Decimal",
"description": "Unit quantity for the tier. Example: if the RateTier price is $1 per 1000000 Bytes, then `unit_quantity` is set to 1000000."
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountservicesV1betaBillingAccountService": {
"description": "Encapsulates a Google Cloud service visible to a billing account.",
"id": "GoogleCloudBillingBillingaccountservicesV1betaBillingAccountService",
"properties": {
"displayName": {
"description": "Description of the BillingAccountService. Example: \"BigQuery\", \"Compute Engine\".",
"type": "string"
},
"name": {
"description": "Resource name for the BillingAccountService. Example: \"billingAccounts/012345-567890-ABCDEF/services/DA34-426B-A397\".",
"type": "string"
},
"serviceId": {
"description": "Identifier for the service. It is the string after the collection identifier \"services/\". Example: \"DA34-426B-A397\".",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountservicesV1betaListBillingAccountServicesResponse": {
"description": "Response message for ListBillingAccountServices.",
"id": "GoogleCloudBillingBillingaccountservicesV1betaListBillingAccountServicesResponse",
"properties": {
"billingAccountServices": {
"description": "The returned billing account services.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountservicesV1betaBillingAccountService"
},
"type": "array"
},
"nextPageToken": {
"description": "Token that can be sent as `page_token` in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupsV1betaBillingAccountSkuGroup": {
"description": "Encapsulates a stock keeping (SKU) group visible to a billing account. A SKU group represents a collection of SKUs that are related to each other. For example, the `AI Platform APIs` SKU group includes SKUs from the Cloud Dialogflow API, the Cloud Text-to-Speech API, and additional related APIs.",
"id": "GoogleCloudBillingBillingaccountskugroupsV1betaBillingAccountSkuGroup",
"properties": {
"displayName": {
"description": "Description of the BillingAccountSkuGroup. Example: \"A2 VMs (1 Year CUD)\".",
"type": "string"
},
"name": {
"description": "Resource name for the BillingAccountSkuGroup. Example: \"billingAccounts/012345-567890-ABCDEF/skuGroups/0e6403d1-4694-44d2-a696-7a78b1a69301\".",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupsV1betaListBillingAccountSkuGroupsResponse": {
"description": "Response message for ListBillingAccountSkuGroups.",
"id": "GoogleCloudBillingBillingaccountskugroupsV1betaListBillingAccountSkuGroupsResponse",
"properties": {
"billingAccountSkuGroups": {
"description": "The returned publicly listed billing account SKU groups.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountskugroupsV1betaBillingAccountSkuGroup"
},
"type": "array"
},
"nextPageToken": {
"description": "Token that can be sent as `page_token` in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupskusV1betaBillingAccountSkuGroupSku": {
"description": "Encapsulates a SKU that is part of a billing account SKU group.",
"id": "GoogleCloudBillingBillingaccountskugroupskusV1betaBillingAccountSkuGroupSku",
"properties": {
"billingAccountService": {
"description": "BillingAccountService that the BillingAccountSkuGroupSku belongs to.",
"type": "string"
},
"displayName": {
"description": "Description of the BillingAccountSkuGroupSku. Example: \"A2 Instance Core running in Hong Kong\".",
"type": "string"
},
"geoTaxonomy": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomy",
"description": "Geographic metadata that applies to the BillingAccountSkuGroupSku."
},
"name": {
"description": "Resource name for the BillingAccountSkuGroupSku. Example: \"billingAccounts/012345-567890-ABCDEF/skuGroups/0e6403d1-4694-44d2-a696-7a78b1a69301/skus/AA95-CD31-42FE\".",
"type": "string"
},
"productTaxonomy": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaProductTaxonomy",
"description": "List of product categories that apply to the BillingAccountSkuGroupSku."
},
"skuId": {
"description": "Unique identifier for the SKU. It is the string after the collection identifier \"skus/\" Example: \"AA95-CD31-42FE\".",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomy": {
"description": "Encapsulates geographic metadata, such as regions and multi-regions like `us-east4` or `European Union`.",
"id": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomy",
"properties": {
"globalMetadata": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyGlobal",
"description": "Global geographic metadata with no regions."
},
"multiRegionalMetadata": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyMultiRegional",
"description": "Multi-regional geographic metadata with 2 or more regions."
},
"regionalMetadata": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyRegional",
"description": "Regional geographic metadata with 1 region."
},
"type": {
"description": "Type of geographic taxonomy associated with the billing account SKU group SKU.",
"enum": [
"TYPE_UNSPECIFIED",
"TYPE_GLOBAL",
"TYPE_REGIONAL",
"TYPE_MULTI_REGIONAL"
],
"enumDescriptions": [
"Default value. Unspecified type.",
"Global geographic taxonomy with no regions.",
"Regional geographic taxonomy with 1 region.",
"Multi-regional geographic taxonomy with 2 or more regions."
],
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyGlobal": {
"description": "Encapsulates a global geographic taxonomy.",
"id": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyGlobal",
"properties": {},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyMultiRegional": {
"description": "Encapsulates a multi-regional geographic taxonomy.",
"id": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyMultiRegional",
"properties": {
"regions": {
"description": "Google Cloud regions associated with the multi-regional geographic taxonomy.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyRegion"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyRegion": {
"description": "Encapsulates a Google Cloud region.",
"id": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyRegion",
"properties": {
"region": {
"description": "Description of a Google Cloud region. Example: \"us-west2\".",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyRegional": {
"description": "Encapsulates a regional geographic taxonomy.",
"id": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyRegional",
"properties": {
"region": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaGeoTaxonomyRegion",
"description": "Google Cloud region associated with the regional geographic taxonomy."
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupskusV1betaListBillingAccountSkuGroupSkusResponse": {
"description": "Response message for ListBillingAccountSkuGroupSkus.",
"id": "GoogleCloudBillingBillingaccountskugroupskusV1betaListBillingAccountSkuGroupSkusResponse",
"properties": {
"billingAccountSkuGroupSkus": {
"description": "The returned billing account SKU group SKUs.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaBillingAccountSkuGroupSku"
},
"type": "array"
},
"nextPageToken": {
"description": "Token that can be sent as `page_token` in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupskusV1betaProductTaxonomy": {
"description": "Encapsulates product categories, such as `Serverless`, `Cloud Run`, `TaskQueue`, and others.",
"id": "GoogleCloudBillingBillingaccountskugroupskusV1betaProductTaxonomy",
"properties": {
"taxonomyCategories": {
"description": "All product categories that the billing account SKU group SKU belong to.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountskugroupskusV1betaTaxonomyCategory"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskugroupskusV1betaTaxonomyCategory": {
"description": "Encapsulates a product category.",
"id": "GoogleCloudBillingBillingaccountskugroupskusV1betaTaxonomyCategory",
"properties": {
"category": {
"description": "Name of the product category.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskusV1betaBillingAccountSku": {
"description": "Encapsulates a stock keeping unit (SKU) visible to a billing account. A SKU distinctly identifies a resource that you can purchase. For a list of available SKUs, see [SKUs](https://cloud.google.com/skus).",
"id": "GoogleCloudBillingBillingaccountskusV1betaBillingAccountSku",
"properties": {
"billingAccountService": {
"description": "BillingAccountService that the BillingAccountSku belongs to.",
"type": "string"
},
"displayName": {
"description": "Description of the BillingAccountSku. Example: \"A2 Instance Core running in Hong Kong\".",
"type": "string"
},
"geoTaxonomy": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomy",
"description": "Geographic metadata that applies to the BillingAccountSku."
},
"name": {
"description": "Resource name for the BillingAccountSku. Example: \"billingAccounts/012345-567890-ABCDEF/skus/AA95-CD31-42FE\".",
"type": "string"
},
"productTaxonomy": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaProductTaxonomy",
"description": "List of product categories that apply to the BillingAccountSku."
},
"skuId": {
"description": "Unique identifier for the SKU. It is the string after the collection identifier \"skus/\" Example: \"AA95-CD31-42FE\".",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomy": {
"description": "Encapsulates geographic metadata, such as regions and multi-regions like `us-east4` or `European Union`.",
"id": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomy",
"properties": {
"globalMetadata": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyGlobal",
"description": "Global geographic metadata with no regions."
},
"multiRegionalMetadata": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyMultiRegional",
"description": "Multi-regional geographic metadata with 2 or more regions."
},
"regionalMetadata": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyRegional",
"description": "Regional geographic metadata with 1 region."
},
"type": {
"description": "Type of geographic taxonomy associated with the billing account SKU.",
"enum": [
"TYPE_UNSPECIFIED",
"TYPE_GLOBAL",
"TYPE_REGIONAL",
"TYPE_MULTI_REGIONAL"
],
"enumDescriptions": [
"Default value. Unspecified type.",
"Global geographic taxonomy with no regions.",
"Regional geographic taxonomy with 1 region.",
"Multi-regional geographic taxonomy with 2 or more regions."
],
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyGlobal": {
"description": "Encapsulates a global geographic taxonomy.",
"id": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyGlobal",
"properties": {},
"type": "object"
},
"GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyMultiRegional": {
"description": "Encapsulates a multi-regional geographic taxonomy.",
"id": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyMultiRegional",
"properties": {
"regions": {
"description": "Google Cloud regions associated with the multi-regional geographic taxonomy.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyRegion"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyRegion": {
"description": "Encapsulates a Google Cloud region.",
"id": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyRegion",
"properties": {
"region": {
"description": "Description of a Google Cloud region. Example: \"us-west2\".",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyRegional": {
"description": "Encapsulates a regional geographic taxonomy.",
"id": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyRegional",
"properties": {
"region": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaGeoTaxonomyRegion",
"description": "Google Cloud region associated with the regional geographic taxonomy."
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskusV1betaListBillingAccountSkusResponse": {
"description": "Response message for ListBillingAccountSkus.",
"id": "GoogleCloudBillingBillingaccountskusV1betaListBillingAccountSkusResponse",
"properties": {
"billingAccountSkus": {
"description": "The returned billing account SKUs.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaBillingAccountSku"
},
"type": "array"
},
"nextPageToken": {
"description": "Token that can be sent as `page_token` in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskusV1betaProductTaxonomy": {
"description": "Encapsulates product categories, such as `Serverless`, `Cloud Run`, `TaskQueue`, and others.",
"id": "GoogleCloudBillingBillingaccountskusV1betaProductTaxonomy",
"properties": {
"taxonomyCategories": {
"description": "All product categories that the billing account SKU belong to.",
"items": {
"$ref": "GoogleCloudBillingBillingaccountskusV1betaTaxonomyCategory"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudBillingBillingaccountskusV1betaTaxonomyCategory": {
"description": "Encapsulates a product category.",
"id": "GoogleCloudBillingBillingaccountskusV1betaTaxonomyCategory",
"properties": {
"category": {
"description": "Name of the product category.",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingPricesV1betaAggregationInfo": {
"description": "Encapsulates the aggregation information such as aggregation level and interval for a price.",
"id": "GoogleCloudBillingPricesV1betaAggregationInfo",
"properties": {
"interval": {
"description": "Interval at which usage is aggregated to compute cost. Example: \"MONTHLY\" interval indicates that usage is aggregated every month.",
"enum": [
"INTERVAL_UNSPECIFIED",
"INTERVAL_MONTHLY",
"INTERVAL_DAILY"
],
"enumDescriptions": [
"Default unspecified value.",
"Usage is aggregated every month.",
"Usage is aggregated every day."
],
"type": "string"
},
"level": {
"description": "Level at which usage is aggregated to compute cost. Example: \"ACCOUNT\" level indicates that usage is aggregated across all projects in a single account.",
"enum": [
"LEVEL_UNSPECIFIED",
"LEVEL_ACCOUNT",
"LEVEL_PROJECT"
],
"enumDescriptions": [
"Default unspecified value.",
"Usage is aggregated at an account level.",
"Usage is aggregated at a project level."
],
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingPricesV1betaListPricesResponse": {
"description": "Response message for ListPrices.",
"id": "GoogleCloudBillingPricesV1betaListPricesResponse",
"properties": {
"nextPageToken": {
"description": "Token that can be sent as `page_token` in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.",
"type": "string"
},
"prices": {
"description": "The returned publicly listed prices.",
"items": {
"$ref": "GoogleCloudBillingPricesV1betaPrice"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudBillingPricesV1betaPrice": {
"description": "Encapsulates the latest price for a SKU.",
"id": "GoogleCloudBillingPricesV1betaPrice",
"properties": {
"currencyCode": {
"description": "ISO-4217 currency code for the price.",
"type": "string"
},
"name": {
"description": "Resource name for the latest price.",
"type": "string"
},
"rate": {
"$ref": "GoogleCloudBillingPricesV1betaRate",
"description": "Rate price metadata. SKUs with `Rate` price are offered by pricing tiers. The price can have 1 or more rate pricing tiers."
},
"valueType": {
"description": "Type of the price. It can have values: [\"unspecified\", \"rate\"].",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingPricesV1betaRate": {
"description": "Encapsulates a `Rate` price. SKUs with `Rate` price are offered by pricing tiers. The price have 1 or more rate pricing tiers.",
"id": "GoogleCloudBillingPricesV1betaRate",
"properties": {
"aggregationInfo": {
"$ref": "GoogleCloudBillingPricesV1betaAggregationInfo",
"description": "Aggregation info for tiers such as aggregation level and interval."
},
"tiers": {
"description": "All tiers associated with the `Rate` price.",
"items": {
"$ref": "GoogleCloudBillingPricesV1betaRateTier"
},
"type": "array"
},
"unitInfo": {
"$ref": "GoogleCloudBillingPricesV1betaUnitInfo",
"description": "Unit info such as name and quantity."
}
},
"type": "object"
},
"GoogleCloudBillingPricesV1betaRateTier": {
"description": "Encapsulates a rate price tier.",
"id": "GoogleCloudBillingPricesV1betaRateTier",
"properties": {
"listPrice": {
"$ref": "Money",
"description": "List price of one tier."
},
"startAmount": {
"$ref": "Decimal",
"description": "Lower bound amount for a tier. Tiers 0-100, 100-200 will be represented with two tiers with `start_amount` 0 and 100."
}
},
"type": "object"
},
"GoogleCloudBillingPricesV1betaUnitInfo": {
"description": "Encapsulates the unit information for a Rate",
"id": "GoogleCloudBillingPricesV1betaUnitInfo",
"properties": {
"unit": {
"description": "Shorthand for the unit. Example: GiBy.mo.",
"type": "string"
},
"unitDescription": {
"description": "Human-readable description of the unit. Example: gibibyte month.",
"type": "string"
},
"unitQuantity": {
"$ref": "Decimal",
"description": "Unit quantity for the tier. Example: if the RateTier price is $1 per 1000000 Bytes, then `unit_quantity` is set to 1000000."
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupsV1betaListSkuGroupsResponse": {
"description": "Response message for ListSkuGroups.",
"id": "GoogleCloudBillingSkugroupsV1betaListSkuGroupsResponse",
"properties": {
"nextPageToken": {
"description": "Token that can be sent as `page_token` in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.",
"type": "string"
},
"skuGroups": {
"description": "The returned publicly listed SKU groups.",
"items": {
"$ref": "GoogleCloudBillingSkugroupsV1betaSkuGroup"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupsV1betaSkuGroup": {
"description": "Encapsulates a publicly listed stock keeping unit (SKU) group. A SKU group represents a collection of SKUs that are related to each other. For example, the `AI Platform APIs` SKU group includes SKUs from the Cloud Dialogflow API, the Cloud Text-to-Speech API, and additional related APIs.",
"id": "GoogleCloudBillingSkugroupsV1betaSkuGroup",
"properties": {
"displayName": {
"description": "Description of the SKU group. Example: \"A2 VMs (1 Year CUD)\".",
"type": "string"
},
"name": {
"description": "Resource name for the SKU group. Example: \"skuGroups/0e6403d1-4694-44d2-a696-7a78b1a69301\".",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupskusV1betaGeoTaxonomy": {
"description": "Encapsulates geographic metadata, such as regions and multi-regions like `us-east4` or `European Union`.",
"id": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomy",
"properties": {
"globalMetadata": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyGlobal",
"description": "Global geographic metadata with no regions."
},
"multiRegionalMetadata": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyMultiRegional",
"description": "Multi-regional geographic metadata with 2 or more regions."
},
"regionalMetadata": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyRegional",
"description": "Regional geographic metadata with 1 region."
},
"type": {
"description": "Type of geographic taxonomy associated with the SKU group SKU.",
"enum": [
"TYPE_UNSPECIFIED",
"TYPE_GLOBAL",
"TYPE_REGIONAL",
"TYPE_MULTI_REGIONAL"
],
"enumDescriptions": [
"Default value. Unspecified type.",
"Global geographic taxonomy with no regions.",
"Regional geographic taxonomy with 1 region.",
"Multi-regional geographic taxonomy with 2 or more regions."
],
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyGlobal": {
"description": "Encapsulates a global geographic taxonomy.",
"id": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyGlobal",
"properties": {},
"type": "object"
},
"GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyMultiRegional": {
"description": "Encapsulates a multi-regional geographic taxonomy.",
"id": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyMultiRegional",
"properties": {
"regions": {
"description": "Google Cloud regions associated with the multi-regional geographic taxonomy.",
"items": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyRegion"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyRegion": {
"description": "Encapsulates a Google Cloud region.",
"id": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyRegion",
"properties": {
"region": {
"description": "Description of a Google Cloud region. Example: \"us-west2\".",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyRegional": {
"description": "Encapsulates a regional geographic taxonomy.",
"id": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyRegional",
"properties": {
"region": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomyRegion",
"description": "Google Cloud region associated with the regional geographic taxonomy."
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupskusV1betaListSkuGroupSkusResponse": {
"description": "Response message for ListSkuGroupSkus.",
"id": "GoogleCloudBillingSkugroupskusV1betaListSkuGroupSkusResponse",
"properties": {
"nextPageToken": {
"description": "Token that can be sent as `page_token` in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.",
"type": "string"
},
"skuGroupSkus": {
"description": "The returned SKU group SKUs.",
"items": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaSkuGroupSku"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupskusV1betaProductTaxonomy": {
"description": "Encapsulates product categories, such as `Serverless`, `Cloud Run`, `TaskQueue`, and others.",
"id": "GoogleCloudBillingSkugroupskusV1betaProductTaxonomy",
"properties": {
"taxonomyCategories": {
"description": "All product categories that the SKU group SKU belongs to.",
"items": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaTaxonomyCategory"
},
"type": "array"
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupskusV1betaSkuGroupSku": {
"description": "Encapsulates a publicly listed stock keeping unit (SKU) that is part of a publicly listed SKU group. A SKU group represents a collection of SKUs that are related to each other. For example, the `AI Platform APIs` SKU group includes SKUs from the Cloud Dialogflow API, the Cloud Text-to-Speech API, and additional related APIs.",
"id": "GoogleCloudBillingSkugroupskusV1betaSkuGroupSku",
"properties": {
"displayName": {
"description": "Description of the SkuGroupSku. Example: \"A2 Instance Core running in Hong Kong\".",
"type": "string"
},
"geoTaxonomy": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaGeoTaxonomy",
"description": "Geographic metadata that applies to the SkuGroupSku."
},
"name": {
"description": "Resource name for the SkuGroupSku. Example: \"skuGroups/0e6403d1-4694-44d2-a696-7a78b1a69301/skus/AA95-CD31-42FE\".",
"type": "string"
},
"productTaxonomy": {
"$ref": "GoogleCloudBillingSkugroupskusV1betaProductTaxonomy",
"description": "List of product categories that apply to the SkuGroupSku."
},
"service": {
"description": "Service that the SkuGroupSku belongs to.",
"type": "string"
},
"skuId": {
"description": "Unique identifier for the SKU. It is the string after the collection identifier \"skus/\" Example: \"AA95-CD31-42FE\".",
"type": "string"
}
},
"type": "object"
},
"GoogleCloudBillingSkugroupskusV1betaTaxonomyCategory": {
"description": "Encapsulates a product category.",
"id": "GoogleCloudBillingSkugroupskusV1betaTaxonomyCategory",
"properties": {
"category": {
"description": "Name of the product category.",
"type": "string"
}
},
"type": "object"
},
"Insight": {
"description": "e.g. insight: title: \"Cost Increase (The Explanation)\" description: \"Your cost increase was driven by Vertex AI Online Prediction in us-central1...\" severity: INFO",
"id": "Insight",
"properties": {
"description": {
"description": "Output only. The description of the insight.",
"readOnly": true,
"type": "string"
},
"severity": {
"description": "Output only. The severity of the insight, used for UI rendering (e.g., color-coding).",
"enum": [
"SEVERITY_UNSPECIFIED",
"INFO",
"WARNING",
"CRITICAL"
],
"enumDescriptions": [
"Default value. Should not be used.",
"The insight is useful, but no action is required.",
"The insight is useful, and some action may be required.",
"The insight is useful, and immediate action is required."
],
"readOnly": true,
"type": "string"
},
"title": {
"description": "Output only. The title of the insight.",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"InteropLink": {
"description": "A link to interoperable tools (e.g., pre-filtered Cost Reports, BQE queries).",
"id": "InteropLink",
"properties": {
"label": {
"description": "Output only. The label of the link, suitable for UI rendering.",
"readOnly": true,
"type": "string"
},
"linkType": {
"description": "Output only. The type of the interop link, e.g., \"COST_REPORT\", \"BQE_QUERY\", etc.",
"enum": [
"LINK_TYPE_UNSPECIFIED",
"COST_REPORT",
"BQE_QUERY",
"FINOPS_HUB"
],
"enumDescriptions": [
"Default value. Should not be used.",
"A link to a Cost Report in Google Cloud Console.",
"A link to a BigQuery Export query.",
"A link to a FinOps Hub page."
],
"readOnly": true,
"type": "string"
},
"url": {
"description": "Output only. The URL of the link.",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"Map": {
"description": "An unordered mapping from key to value, represented as a collection of map entries.",
"id": "Map",
"properties": {
"entry": {
"description": "Represents the map entries in the map.",
"items": {
"$ref": "MapEntry"
},
"type": "array"
}
},
"type": "object"
},
"MapEntry": {
"description": "A single entry in a Map, representing the mapping between `key` and `value`.",
"id": "MapEntry",
"properties": {
"key": {
"$ref": "ValueProto",
"description": "Represents the serialized map key for the entry."
},
"value": {
"$ref": "ValueProto",
"description": "Represents the serialized map value of the entry."
}
},
"type": "object"
},
"Money": {
"description": "Represents an amount of money with its currency type.",
"id": "Money",
"properties": {
"currencyCode": {
"description": "The three-letter currency code defined in ISO 4217.",
"type": "string"
},
"nanos": {
"description": "Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.",
"format": "int32",
"type": "integer"
},
"units": {
"description": "The whole units of the amount. For example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"Range": {
"description": "A range of values, bounded by the values 'start' (inclusive) and 'end' (exclusive). A range has an element type, and values must be of this element type. A range is contiguous, ie it contains all values of the given element type starting at 'start' and ending before 'end'. A \"null\" value on start or end represents an unbounded start or end value respectively. Start and end values must always be present.",
"id": "Range",
"properties": {
"end": {
"$ref": "ValueProto",
"description": "Represents the end of the range."
},
"start": {
"$ref": "ValueProto",
"description": "Represents the start of the range."
}
},
"type": "object"
},
"Rejection": {
"description": "Encapsulates details about why a request was rejected.",
"id": "Rejection",
"properties": {
"displayMessage": {
"description": "Output only. A user-facing message explaining the rejection.",
"readOnly": true,
"type": "string"
},
"reason": {
"description": "Output only. The reason for the rejection.",
"enum": [
"REASON_UNSPECIFIED",
"EXPLICIT_OUT_OF_SCOPE"
],
"enumDescriptions": [
"Default value. Should not be used.",
"The user explicitly asked about a service that is not Gemini or Vertex AI."
],
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"Row": {
"description": "Represents a row in the query result.",
"id": "Row",
"properties": {
"values": {
"description": "Values for a row in the column order.",
"items": {
"$ref": "ValueProto"
},
"type": "array"
}
},
"type": "object"
},
"Struct": {
"description": "A collection of fields. The count, order, and type of the fields is determined by the type associated with this value.",
"id": "Struct",
"properties": {
"field": {
"description": "The fields in the struct",
"items": {
"$ref": "ValueProto"
},
"type": "array"
}
},
"type": "object"
},
"SuggestedChart": {
"description": "A suggested chart for the data set, used for UI rendering.",
"id": "SuggestedChart",
"properties": {
"chartTitle": {
"description": "The title of the chart.",
"type": "string"
},
"chartType": {
"description": "The type of the chart.",
"enum": [
"CHART_TYPE_UNSPECIFIED",
"BAR_CHART",
"UNCHARTABLE",
"LINE_CHART",
"AREA_CHART"
],
"enumDescriptions": [
"Default value. Should not be used.",
"Represents a bar chart.",
"The data set cannot be rendered as a chart.",
"Represents a line chart. Suitable for quantitative and temporal data on the x-axis.",
"Represents an area chart."
],
"type": "string"
},
"seriesField": {
"description": "The field used for the series (e.g., color-coding). Optional, but recommended for time-series data.",
"type": "string"
},
"xAxisField": {
"description": "The field used for the x-axis.",
"type": "string"
},
"xAxisLabel": {
"description": "The label of the x-axis.",
"type": "string"
},
"yAxisField": {
"description": "The field used for the y-axis.",
"type": "string"
},
"yAxisLabel": {
"description": "The label of the y-axis.",
"type": "string"
}
},
"type": "object"
},
"SuggestedQuery": {
"description": "A suggested follow-up query for the user.",
"id": "SuggestedQuery",
"properties": {
"query": {
"description": "The natural language query.",
"type": "string"
}
},
"type": "object"
},
"UserContext": {
"description": "Additional context for personalization (e.g., user persona, role).",
"id": "UserContext",
"properties": {
"persona": {
"description": "Optional. The user's persona (e.g., FinOps Manager, Developer).",
"enum": [
"PERSONA_UNSPECIFIED",
"FINOPS_MANAGER",
"DEVELOPER"
],
"enumDescriptions": [
"Default value. Should not be used.",
"The user is a FinOps Manager.",
"The user is a Developer."
],
"type": "string"
},
"role": {
"description": "Optional. The user's role (e.g., Billing Admin, Project Owner, etc.).",
"type": "string"
}
},
"type": "object"
},
"ValueProto": {
"description": "This is a copy of storage/googlesql/public/value.proto. ValueProto represents the serialized form of the googlesql::Value. The intention is to support multiple languages including Java and C++, so we must be sensitive to the distinction between Java Strings and byte arrays or ByteStrings. We also want to support use-cases which do not want to serialize a copy of the GoogleSQL type for every instance (which might be very repetitive). Therefore, unlike googlesql::Value, ValueProto does not carry full type information with every instance, and can only be fully interpreted with an associated TypeProto.",
"id": "ValueProto",
"properties": {
"ValueProtoSwitchMustHaveADefault": {
"description": "User code that switches on this oneoff enum must have a default case so builds won't break when new fields are added.",
"type": "boolean"
},
"arrayValue": {
"$ref": "Array",
"description": "An array of value"
},
"bignumericValue": {
"description": "Encoded bignumeric value. For the encoding format see documentation for BigNumericValue::SerializeAsProtoBytes().",
"format": "byte",
"type": "string"
},
"boolValue": {
"description": "Primitive for bool.",
"type": "boolean"
},
"bytesValue": {
"description": "Primitive for bytes.",
"format": "byte",
"type": "string"
},
"dateValue": {
"description": "Primitive for date.",
"format": "int32",
"type": "integer"
},
"datetimeValue": {
"$ref": "Datetime",
"description": "primitive for datetime"
},
"doubleValue": {
"description": "Primitive for double.",
"format": "double",
"type": "number"
},
"enumValue": {
"description": "Tag 11 was used for specifying micros timestamps as int64, now obsolete.",
"format": "int32",
"type": "integer"
},
"floatValue": {
"description": "Primitive for float.",
"format": "float",
"type": "number"
},
"geographyValue": {
"description": "Geography encoded using ::stlib::STGeographyEncoder",
"format": "byte",
"type": "string"
},
"int32Value": {
"description": "Primitive value for int32.",
"format": "int32",
"type": "integer"
},
"int64Value": {
"description": "Primitive for int64.",
"format": "int64",
"type": "string"
},
"intervalValue": {
"description": "Encoded interval value. For the encoding format see documentation for IntervalValue::SerializeAsBytes().",
"format": "byte",
"type": "string"
},
"jsonValue": {
"description": "Tag 22 was used for json value as bytes, now obsolete. Json value represented as a string document.",
"type": "string"
},
"mapValue": {
"$ref": "Map",
"description": "Encoded map value. See go/googlesql_map."
},
"numericValue": {
"description": "Encoded numeric value. For the encoding format see documentation for NumericValue::SerializeAsProtoBytes().",
"format": "byte",
"type": "string"
},
"protoValue": {
"description": "Stores a serialized protocol message.",
"format": "byte",
"type": "string"
},
"rangeValue": {
"$ref": "Range",
"description": "Encoded range value. See go/googlesql_range."
},
"stringValue": {
"description": "Primitive for string.",
"type": "string"
},
"structValue": {
"$ref": "Struct",
"description": "A struct of values"
},
"timeValue": {
"description": "Bit field encoding of hour/minute/second/nanos. See TimeValue class for details.",
"format": "int64",
"type": "string"
},
"timestampPicoValue": {
"description": "Encoded timestamp_pico value. For the encoding format see documentation for googlesql::TimestampPico::SerializeAsBytes().",
"format": "byte",
"type": "string"
},
"timestampValue": {
"description": "primitive for timestamp",
"format": "google-datetime",
"type": "string"
},
"tokenlistValue": {
"description": "Encoded tokenlist value. copybara:strip_begin(internal-comment) See //search/tokens:token_list. copybara:strip_end",
"format": "byte",
"type": "string"
},
"uint32Value": {
"description": "Primitive for uint32.",
"format": "uint32",
"type": "integer"
},
"uint64Value": {
"description": "Primitive for uint64.",
"format": "uint64",
"type": "string"
},
"uuidValue": {
"description": "Encoded uuid value. For the encoding format see documentation for UuidValue::SerializeAsBytes().",
"format": "byte",
"type": "string"
}
},
"type": "object"
}
},
"servicePath": "",
"title": "Cloud Billing API",
"version": "v1beta",
"version_module": true
}