Google Cloud Commerce Producer V1beta Client - Class AdditionalContractValue (0.2.0)

Reference documentation and code samples for the Google Cloud Commerce Producer V1beta Client class AdditionalContractValue.

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

Generated from protobuf message google.cloud.commerceproducer.v1beta.PrivateOffer.SingleProductOffer.AdditionalContractValue

Namespace

Google \ Cloud \ CommerceProducer \ V1beta \ PrivateOffer \ SingleProductOffer

Methods

__construct

Constructor.

Parameters
Name Description
data array

Optional. Data for populating the Message object.
↳ contract_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.
↳ eligible_skus 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}

getContractValue

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
Type Description
Google\Type\Money|null

hasContractValue

clearContractValue

setContractValue

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.
Parameter
Name Description
var Google\Type\Money
Returns
Type Description
$this

getEligibleSkus

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
Type Description
Google\Protobuf\RepeatedField<string>

setEligibleSkus

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}

Parameter
Name Description
var string[]
Returns
Type Description
$this