Cloud Commerce Producer V1BETA API - Class Google::Cloud::CommerceProducer::V1beta::PrivateOffer::SingleProductOffer::AdditionalContractValue (v0.3.0)

Reference documentation and code samples for the Cloud Commerce Producer V1BETA API class Google::Cloud::CommerceProducer::V1beta::PrivateOffer::SingleProductOffer::AdditionalContractValue.

Additional contract value that represents a spend obligation or target contract value tracked out-of-band by the partner.

Inherits

  • Object

Extended By

  • Google::Protobuf::MessageExts::ClassMethods

Includes

  • Google::Protobuf::MessageExts

Methods

#contract_value

def contract_value() -> ::Google::Type::Money
Returns
  • (::Google::Type::Money) — Optional. The absolute, cumulative contract value of the customer's spend obligation that is added on top of the automatically billed fees from Google. This amount is not automatically billed or invoiced by Google; instead, it is tracked as a legal spend guarantee to be met via usage reporting and manually trued-up by partners.

    The overall total contract value of the offer is calculated as the sum of Google-billed fees (from installments), plus this additional contract value.

    For amendments, this field must be set to the new cumulative additional total.

    For example:

    • Initial Offer: 3 installments of $15 (total $45 billed by Google) plus an additional_contract_value of $100 (billed by Partner, with true-ups happening at the end of the offer's term). The overall total contract value of the offer is $145 ($45 + $100).
    • Amended Offer: 6 installments of $15 (total $90 billed by Google) plus an additional_contract_value of $70 (billed by Partner, with true-ups happening at the end of the offer's term). The overall total contract value of the amended offer is $160 ($90 + $70).

    Must be non-negative. The maximum allowed value is 1,000,000,000 USD.

#contract_value=

def contract_value=(value) -> ::Google::Type::Money
Parameter
  • value (::Google::Type::Money) — Optional. The absolute, cumulative contract value of the customer's spend obligation that is added on top of the automatically billed fees from Google. This amount is not automatically billed or invoiced by Google; instead, it is tracked as a legal spend guarantee to be met via usage reporting and manually trued-up by partners.

    The overall total contract value of the offer is calculated as the sum of Google-billed fees (from installments), plus this additional contract value.

    For amendments, this field must be set to the new cumulative additional total.

    For example:

    • Initial Offer: 3 installments of $15 (total $45 billed by Google) plus an additional_contract_value of $100 (billed by Partner, with true-ups happening at the end of the offer's term). The overall total contract value of the offer is $145 ($45 + $100).
    • Amended Offer: 6 installments of $15 (total $90 billed by Google) plus an additional_contract_value of $70 (billed by Partner, with true-ups happening at the end of the offer's term). The overall total contract value of the amended offer is $160 ($90 + $70).

    Must be non-negative. The maximum allowed value is 1,000,000,000 USD.

Returns
  • (::Google::Type::Money) — Optional. The absolute, cumulative contract value of the customer's spend obligation that is added on top of the automatically billed fees from Google. This amount is not automatically billed or invoiced by Google; instead, it is tracked as a legal spend guarantee to be met via usage reporting and manually trued-up by partners.

    The overall total contract value of the offer is calculated as the sum of Google-billed fees (from installments), plus this additional contract value.

    For amendments, this field must be set to the new cumulative additional total.

    For example:

    • Initial Offer: 3 installments of $15 (total $45 billed by Google) plus an additional_contract_value of $100 (billed by Partner, with true-ups happening at the end of the offer's term). The overall total contract value of the offer is $145 ($45 + $100).
    • Amended Offer: 6 installments of $15 (total $90 billed by Google) plus an additional_contract_value of $70 (billed by Partner, with true-ups happening at the end of the offer's term). The overall total contract value of the amended offer is $160 ($90 + $70).

    Must be non-negative. The maximum allowed value is 1,000,000,000 USD.

#eligible_skus

def eligible_skus() -> ::Array<::String>
Returns
  • (::Array<::String>) — Optional. The resource names of the SKUs whose tracked usage is eligible to contribute toward satisfying this additional contract value obligation.

    This list explicitly separates core spend obligations from exclusions like overage fees, which do not count toward meeting the customer's legal spend commitment.

    Must be non-empty for the offer to be published.

    Format: projects/{project}/locations/{location}/services/{service}/skus/{sku}

#eligible_skus=

def eligible_skus=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — Optional. The resource names of the SKUs whose tracked usage is eligible to contribute toward satisfying this additional contract value obligation.

    This list explicitly separates core spend obligations from exclusions like overage fees, which do not count toward meeting the customer's legal spend commitment.

    Must be non-empty for the offer to be published.

    Format: projects/{project}/locations/{location}/services/{service}/skus/{sku}

Returns
  • (::Array<::String>) — Optional. The resource names of the SKUs whose tracked usage is eligible to contribute toward satisfying this additional contract value obligation.

    This list explicitly separates core spend obligations from exclusions like overage fees, which do not count toward meeting the customer's legal spend commitment.

    Must be non-empty for the offer to be published.

    Format: projects/{project}/locations/{location}/services/{service}/skus/{sku}