Console
    Contact Us Start free

    REST Resource: billingAccounts.skus.price

    Resource: BillingAccountPrice

    Encapsulates the latest price for a billing account SKU .

    JSON representation 
     { 
 "name" 
 : 
 string 
 , 
 "currencyCode" 
 : 
 string 
 , 
 "valueType" 
 : 
 string 
 , 
 "priceReason" 
 : 
 { 
 object (  PriceReason 
 
) 
 } 
 , 
 // Union field value 
can be only one of the following: 
 "rate" 
 : 
 { 
 object (  Rate 
 
) 
 } 
 // End of list of possible types for union field value 
. 
 }
    Fields
    name

    string

    Resource name for the latest billing account price.

    currencyCode

    string

    ISO-4217 currency code for the price.

    valueType

    string

    Type of the price. The possible values are: ["unspecified", "rate"].

    priceReason

    object ( PriceReason )

    Background information on the origin of the price.

    Union field value .

    value can be only one of the following:

    rate

    object ( Rate )

    Rate price metadata. Billing account SKUs with Rate price are offered by pricing tiers. The price can have 1 or more rate pricing tiers.

    Rate

    Encapsulates a Rate price. Billing account SKUs with Rate price are offered by pricing tiers. The price have 1 or more rate pricing tiers.

    JSON representation 
     { 
 "tiers" 
 : 
 [ 
 { 
 object (  RateTier 
 
) 
 } 
 ] 
 , 
 "unitInfo" 
 : 
 { 
 object (  UnitInfo 
 
) 
 } 
 , 
 "aggregationInfo" 
 : 
 { 
 object (  AggregationInfo 
 
) 
 } 
 }
    Fields
    tiers[]

    object ( RateTier )

    All tiers associated with the Rate price.
    unitInfo

    object ( UnitInfo )

    Unit info such as name and quantity.
    aggregationInfo

    object ( AggregationInfo )

    Aggregation info for tiers such as aggregation level and interval.

    RateTier

    Encapsulates a rate price tier.

    JSON representation 
     { 
 "startAmount" 
 : 
 { 
 object (  Decimal 
 
) 
 } 
 , 
 "listPrice" 
 : 
 { 
 object (  Money 
 
) 
 } 
 , 
 "contractPrice" 
 : 
 { 
 object (  Money 
 
) 
 } 
 , 
 "effectiveDiscountPercent" 
 : 
 { 
 object (  Decimal 
 
) 
 } 
 }
    Fields
    startAmount

    object ( Decimal )

    Lower bound amount for a tier. Tiers 0-100, 100-200 will be represented with two tiers with startAmount 0 and 100.
    listPrice

    object ( Money )

    List price of one tier.
    contractPrice

    object ( Money )

    Negotiated contract price specific for a billing account.
    effectiveDiscountPercent

    object ( Decimal )

    Percentage of effective discount calculated using the current list price per pricing tier. Formula used: effectiveDiscountPercent = (listPrice - contractPrice) / listPrice × 100 If listPrice and contractPrice are zero, this field is the same as discountPercent of FixedDiscount and FloatingDiscount . If your contract does NOT have the feature LIST_PRICE_AS_CEILING enabled, the effectiveDiscountPercent 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.

    UnitInfo

    Encapsulates the unit information for a Rate

    JSON representation 
     { 
 "unit" 
 : 
 string 
 , 
 "unitDescription" 
 : 
 string 
 , 
 "unitQuantity" 
 : 
 { 
 object (  Decimal 
 
) 
 } 
 }
    Fields
    unit

    string

    Shorthand for the unit. Example: GiBy.mo.
    unitDescription

    string

    Human-readable description of the unit. Example: gibibyte month.
    unitQuantity

    object ( Decimal )

    Unit quantity for the tier. Example: if the RateTier price is $1 per 1000000 Bytes, then unitQuantity is set to 1000000.

    AggregationInfo

    Encapsulates the aggregation information such as aggregation level and interval for a billing account price .

    JSON representation 
     { 
 "level" 
 : 
 enum (  Level 
 
) 
 , 
 "interval" 
 : 
 enum (  Interval 
 
) 
 }
    Fields
    level

    enum ( Level )

    Level at which usage is aggregated to compute cost. Example: "ACCOUNT" level indicates that usage is aggregated across all projects in a single account.
    interval

    enum ( Interval )

    Interval at which usage is aggregated to compute cost. Example: "MONTHLY" interval indicates that usage is aggregated every month.

    Level

    Different aggregation levels.

    Enums
    LEVEL_UNSPECIFIED Default unspecified value.
    LEVEL_PROJECT Usage is aggregated at a project level.

    Interval

    Different aggregation intervals.

    Enums
    INTERVAL_UNSPECIFIED Default unspecified value.
    INTERVAL_MONTHLY Usage is aggregated every month.
    INTERVAL_DAILY Usage is aggregated every day.

    PriceReason

    Encapsulates a price reason which contains background information about the origin of the price.

    JSON representation 
     { 
 "type" 
 : 
 string 
 , 
 // Union field metadata 
can be only one of the following: 
 "defaultPrice" 
 : 
 { 
 object (  DefaultPrice 
 
) 
 } 
 , 
 "fixedPrice" 
 : 
 { 
 object (  FixedPrice 
 
) 
 } 
 , 
 "fixedDiscount" 
 : 
 { 
 object (  FixedDiscount 
 
) 
 } 
 , 
 "floatingDiscount" 
 : 
 { 
 object (  FloatingDiscount 
 
) 
 } 
 , 
 "migratedPrice" 
 : 
 { 
 object (  MigratedPrice 
 
) 
 } 
 , 
 "mergedPrice" 
 : 
 { 
 object (  MergedPrice 
 
) 
 } 
 , 
 "listPriceAsCeiling" 
 : 
 { 
 object (  ListPriceAsCeiling 
 
) 
 } 
 // End of list of possible types for union field metadata 
. 
 }
    Fields
    type

    string

    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'.

    Union field metadata .

    metadata can be only one of the following:

    defaultPrice

    object ( DefaultPrice )

    Default price which is the current list price.

    fixedPrice

    object ( FixedPrice )

    Fixed price applicable during the terms of a contract agreement.

    fixedDiscount

    object ( FixedDiscount )

    Discount off the list price, anchored to the list price as of a fixed time.

    floatingDiscount

    object ( FloatingDiscount )

    Discount off the current list price, not anchored to any list price as of a fixed time.

    migratedPrice

    object ( MigratedPrice )

    Price migrated from other SKUs.

    mergedPrice

    object ( MergedPrice )

    Price after merging from multiple sources.

    listPriceAsCeiling

    object ( ListPriceAsCeiling )

    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 .

    DefaultPrice

    This type has no fields.

    Encapsulates a default price which is the current list price.

    FixedPrice

    This type has no fields.

    Encapsulates a set fixed price applicable during the terms of a contract agreement.

    FixedDiscount

    Encapsulates a discount off the list price, anchored to the list price as of a fixed time.

    JSON representation 
     { 
 "discountPercent" 
 : 
 { 
 object (  Decimal 
 
) 
 } 
 , 
 "fixTime" 
 : 
 string 
 , 
 "discountScopeType" 
 : 
 string 
 , 
 // Union field discount_scope 
can be only one of the following: 
 "skuGroup" 
 : 
 string 
 // End of list of possible types for union field discount_scope 
. 
 }
    Fields
    discountPercent

    object ( Decimal )

    Percentage of the fixed discount.

    fixTime

    string ( Timestamp format)

    Time that the fixed discount is anchored to.

    Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .

    discountScopeType

    string

    Type of the fixed discount scope which indicates the source of the discount. It can have values such as 'unspecified' and 'sku-group'.

    Union field discount_scope .

    discount_scope can be only one of the following:

    skuGroup

    string

    SKU group where the fixed discount comes from.

    FloatingDiscount

    Encapsulates a discount off the current list price, not anchored to any list price as of a fixed time.

    JSON representation 
     { 
 "discountPercent" 
 : 
 { 
 object (  Decimal 
 
) 
 } 
 , 
 "discountScopeType" 
 : 
 string 
 , 
 // Union field discount_scope 
can be only one of the following: 
 "skuGroup" 
 : 
 string 
 // End of list of possible types for union field discount_scope 
. 
 }
    Fields
    discountPercent

    object ( Decimal )

    Percentage of the floating discount.

    discountScopeType

    string

    Type of the floating discount scope which indicates the source of the discount. It can have values such as 'unspecified' and 'sku-group'.

    Union field discount_scope .

    discount_scope can be only one of the following:

    skuGroup

    string

    SKU group where the floating discount comes from.

    MigratedPrice

    Encapsulates a price migrated from other SKUs.

    JSON representation 
     { 
 "sourceSku" 
 : 
 string 
 }
    Fields
    sourceSku

    string

    Source SKU where the discount is migrated from. Format: billingAccounts/{billingAccount}/skus/{sku}

    MergedPrice

    This type has no fields.

    Encapsulates a price after merging from multiple sources. With merged tiers, each individual tier can be from a different source with different discount types.

    ListPriceAsCeiling

    This type has no fields.

    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 .

    Methods

    get

    		Gets the latest price for SKUs available to your Cloud Billing account .
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: