# REST Resource: skus

- [Resource: Sku](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Sku)
  - [JSON representation](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Sku.SCHEMA_REPRESENTATION)
- [ProductTaxonomy](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#ProductTaxonomy)
  - [JSON representation](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#ProductTaxonomy.SCHEMA_REPRESENTATION)
- [TaxonomyCategory](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#TaxonomyCategory)
  - [JSON representation](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#TaxonomyCategory.SCHEMA_REPRESENTATION)
- [GeoTaxonomy](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#GeoTaxonomy)
  - [JSON representation](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#GeoTaxonomy.SCHEMA_REPRESENTATION)
- [Global](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Global)
- [Regional](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Regional)
  - [JSON representation](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Regional.SCHEMA_REPRESENTATION)
- [Region](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Region)
  - [JSON representation](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Region.SCHEMA_REPRESENTATION)
- [MultiRegional](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#MultiRegional)
  - [JSON representation](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#MultiRegional.SCHEMA_REPRESENTATION)
- [Type](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Type)
- [Methods](https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#METHODS_SUMMARY)

## Resource: Sku

Encapsulates a stock keeping unit (`SKU`). A SKU distinctly identifies a resource that you can purchase. For a list of available SKUs, see [SKUs](https://cloud.google.com/skus).

| JSON representation |
|---|
| ``` { "name": string, "skuId": string, "displayName": string, "service": string, "productTaxonomy": { object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#ProductTaxonomy`) }, "geoTaxonomy": { object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#GeoTaxonomy`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Resource name for the `SKU`. Example: "skus/AA95-CD31-42FE". |
| `skuId` | `string` Unique identifier for the `SKU`. Example: "AA95-CD31-42FE". |
| `displayName` | `string` Description of the `SKU`. Example: "A2 Instance Core running in Hong Kong". |
| `service` | `string` `Service` that the `SKU` belongs to. |
| `productTaxonomy` | ``object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#ProductTaxonomy`)`` List of product categories that apply to the `SKU`. |
| `geoTaxonomy` | ``object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#GeoTaxonomy`)`` Geographic metadata that applies to the `SKU`. |

## ProductTaxonomy

Encapsulates product categories, such as `Serverless`, `Cloud Run`, `TaskQueue`, and others.

| JSON representation |
|---|
| ``` { "taxonomyCategories": [ { object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#TaxonomyCategory`) } ] } ``` |

| Fields ||
|---|---|
| `taxonomyCategories[]` | ``object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#TaxonomyCategory`)`` All product categories that the `SKU` belong to. |

## TaxonomyCategory

Encapsulates a product category.

| JSON representation |
|---|
| ``` { "category": string } ``` |

| Fields ||
|---|---|
| `category` | `string` Name of the product category. |

## GeoTaxonomy

Encapsulates geographic metadata, such as regions and multi-regions like `us-east4` or `European Union`.

| JSON representation |
|---|
| ``` { "type": enum (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Type`), // Union field `metadata` can be only one of the following: "globalMetadata": { object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Global`) }, "regionalMetadata": { object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Regional`) }, "multiRegionalMetadata": { object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#MultiRegional`) } // End of list of possible types for union field `metadata`. } ``` |

| Fields ||
|---|---|
| `type` | ``enum (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Type`)`` Type of geographic taxonomy associated with the `SKU`. |
| Union field `metadata`. `metadata` can be only one of the following: ||
| `globalMetadata` | ``object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Global`)`` Global geographic metadata with no regions. |
| `regionalMetadata` | ``object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Regional`)`` Regional geographic metadata with 1 region. |
| `multiRegionalMetadata` | ``object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#MultiRegional`)`` Multi-regional geographic metadata with 2 or more regions. |

## Global

This type has no fields.
Encapsulates a global geographic taxonomy.

## Regional

Encapsulates a regional geographic taxonomy.

| JSON representation |
|---|
| ``` { "region": { object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Region`) } } ``` |

| Fields ||
|---|---|
| `region` | ``object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Region`)`` Google Cloud region associated with the regional geographic taxonomy. |

## Region

Encapsulates a Google Cloud region.

| JSON representation |
|---|
| ``` { "region": string } ``` |

| Fields ||
|---|---|
| `region` | `string` Description of a Google Cloud region. Example: "us-west2". |

## MultiRegional

Encapsulates a multi-regional geographic taxonomy.

| JSON representation |
|---|
| ``` { "regions": [ { object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Region`) } ] } ``` |

| Fields ||
|---|---|
| `regions[]` | ``object (`https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus#Region`)`` Google Cloud regions associated with the multi-regional geographic taxonomy. |

## Type

Different types of geographic taxonomy.

| Enums ||
|---|---|
| `TYPE_UNSPECIFIED` | Default value. Unspecified type. |
| `TYPE_GLOBAL` | Global geographic taxonomy with no regions. |
| `TYPE_REGIONAL` | Regional geographic taxonomy with 1 region. |
| `TYPE_MULTI_REGIONAL` | Multi-regional geographic taxonomy with 2 or more regions. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus/get` | Gets a publicly listed `SKU`. |
| ### `https://docs.cloud.google.com/billing/docs/reference/pricing-api/rest/v2beta/skus/list` | Lists all publicly listed `SKUs`. |