Billing API, gRPC: SkuService
A set of methods for managing Sku resources.
| Call | Description |
|---|---|
| Get | Returns the specified SKU. |
| List | Retrieves the list of SKUs. |
Calls SkuService
Get
Returns the specified SKU.
rpc Get (GetSkuRequest) returns (Sku)
GetSkuRequest
| Field | Description |
|---|---|
| id | string Required. ID of the SKU to return. To get the SKU ID, use SkuService.List request. The maximum string length in characters is 50. |
| currency | string Required. Currency of the SKU. Can be one of the following:
|
| billing_account_id | string Optional ID of the billing account. If specified, contract prices for a particular billing account are included in the response. To get the billing account ID, use BillingAccountService.List request. |
Sku
| Field | Description |
|---|---|
| id | string ID of the SKU. |
| name | string Name of the SKU. |
| description | string Description of the sku. |
| service_id | string ID of the service that sku belongs to. |
| pricing_unit | string Pricing unit of the SKU, e.g. core*hour, gbyte*hour. |
| pricing_versions[] | PricingVersion List of pricing versions. |
PricingVersion
| Field | Description |
|---|---|
| type | enum PricingVersionType Type of the pricing version.
|
| effective_time | google.protobuf.Timestamp Timestamp pricing version is active since inclusive. The pricing version is active until next pricing version effective time exclusive. |
| pricing_expressions[] | PricingExpression List of pricing expressions. |
PricingExpression
| Field | Description |
|---|---|
| rates[] | Rate List of rates. |
Rate
| Field | Description |
|---|---|
| start_pricing_quantity | string Start of the pricing quantity interval. The end of the interval is the start pricing quantity of the next rate. |
| unit_price | string Unit price for the pricing quantity interval. |
| currency | string Currency of the unit price. Can be one of the following:
|
List
Retrieves the list of SKUs.
rpc List (ListSkusRequest) returns (ListSkusResponse)
ListSkusRequest
| Field | Description |
|---|---|
| currency | string Required. Currency of the prices. Can be one of the following:
|
| billing_account_id | string Optional ID of the billing account. If specified, contract prices for a particular billing account are included in the response. To get the billing account ID, use BillingAccountService.List request. |
| filter | string A filter expression that filters resources listed in the response. The expression must specify:
|
| page_size | int64 The maximum number of results per page to return. If the number of available results is larger than page_size, the service returns a ListSkusResponse.next_page_token that can be used to get the next page of results in subsequent list requests. The maximum value is 1000. |
| page_token | string Page token. To get the next page of results, set page_token to the ListSkusResponse.next_page_token returned by a previous list request. The maximum string length in characters is 100. |
ListSkusResponse
| Field | Description |
|---|---|
| skus[] | Sku List of skus. |
| next_page_token | string This token allows you to get the next page of results for list requests. If the number of results is larger than ListSkusRequest.page_size, use next_page_token as the value for the ListSkusRequest.page_token query parameter in the next list request. Each subsequent list request will have its own next_page_token to continue paging through the results. |
Sku
| Field | Description |
|---|---|
| id | string ID of the SKU. |
| name | string Name of the SKU. |
| description | string Description of the sku. |
| service_id | string ID of the service that sku belongs to. |
| pricing_unit | string Pricing unit of the SKU, e.g. core*hour, gbyte*hour. |
| pricing_versions[] | PricingVersion List of pricing versions. |
PricingVersion
| Field | Description |
|---|---|
| type | enum PricingVersionType Type of the pricing version.
|
| effective_time | google.protobuf.Timestamp Timestamp pricing version is active since inclusive. The pricing version is active until next pricing version effective time exclusive. |
| pricing_expressions[] | PricingExpression List of pricing expressions. |
PricingExpression
| Field | Description |
|---|---|
| rates[] | Rate List of rates. |
Rate
| Field | Description |
|---|---|
| start_pricing_quantity | string Start of the pricing quantity interval. The end of the interval is the start pricing quantity of the next rate. |
| unit_price | string Unit price for the pricing quantity interval. |
| currency | string Currency of the unit price. Can be one of the following:
|