Method: projects.locations.queryConfigurablePricingUsageStats

Queries configurable pricing usage stats for a project.

HTTP request

GET https://discoveryengine.googleapis.com/v1alpha/{project=projects/*}/locations/{location}:queryConfigurablePricingUsageStats

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
project

string

Required. The project to query usage stats for. Format: projects/{project}

location

string

Required. The location to query usage stats for.

Query parameters

Parameters
timeRange

object (TimeRange)

Optional. The time range of the usage aggregation. If endDate is not set, it defaults to current date. If startDate is not set, it defaults to 30 days prior to endDate.

metricTypes[]

enum (BillingMetricType)

Optional. The metric types to return usage for.

Request body

The request body must be empty.

Response body

Response for [ProjectService.QueryConfigurablePricingUsageStats] method.

If successful, the response body contains data with the following structure:

JSON representation
{
  "metricUsages": [
    {
      object (MetricUsage)
    }
  ]
}
Fields
metricUsages[]

object (MetricUsage)

A list of metric usages, one for each requested resource type that has data in the requested time range.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the project resource:

  • discoveryengine.projects.get

For more information, see the IAM documentation.

TimeRange

The time range of the usage aggregation.

JSON representation
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Fields
startDate

object (Date)

Optional. The inclusive start date of the usage aggregation.

endDate

object (Date)

Optional. The inclusive end date of the usage aggregation.

BillingMetricType

type of billing metric for usage stats.

Enums
BILLING_METRIC_TYPE_UNSPECIFIED Default value.
DAILY_MDN_QPM Daily median search request QPM.
DAILY_MIN_QPM Daily min search request QPM.
DAILY_MAX_QPM Daily max search request QPM.
DAILY_SEARCH_REQUEST Daily search request total.
TOTAL_STORAGE Total storage bytes for indexing core.

MetricUsage

The usage of a metric over a list of days.

JSON representation
{
  "metricType": enum (BillingMetricType),
  "datedUsages": [
    {
      object (DatedUsage)
    }
  ],
  "totalUsage": number
}
Fields
metricType

enum (BillingMetricType)

The metric type.

datedUsages[]

object (DatedUsage)

The list of usages for this resource type, chronologically sorted by date. This is populated for metrics with daily aggregation like DAILY_MDN_QPM.

totalUsage

number

The total usage for this resource type. This is populated for metrics like TOTAL_STORAGE.

DatedUsage

A list of usages for a specific day.

JSON representation
{
  "date": {
    object (Date)
  },
  "usage": number
}
Fields
date

object (Date)

The date of the usage.

usage

number

The usage value on the date.