# Google Cloud Channel V1 Client - Class ChangeOfferRequest (2.4.1)

2.4.1 (latest) 2.4.0 2.3.1 2.2.1 2.1.4 2.0.0 1.9.5 1.8.2 1.7.0 1.6.0 1.5.0 1.4.0 1.3.0 1.2.1 1.1.1 1.0.1 Reference documentation and code samples for the Google Cloud Channel V1 Client class ChangeOfferRequest.

Request message for
[CloudChannelService.ChangeOffer](https://docs.cloud.google.com/php/docs/reference/cloud-channel/latest/V1.Client.CloudChannelServiceClient#_Google_Cloud_Channel_V1_Client_CloudChannelServiceClient__changeOffer__).

Generated from protobuf message `google.cloud.channel.v1.ChangeOfferRequest`

## Namespace

Google \\ Cloud \\ Channel \\ V1

## Methods

### __construct

Constructor.

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `data` | `array` Optional. Data for populating the Message object. |
| `↳ name` | `string` Required. The resource name of the entitlement to update. Name uses the format: accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id} |
| `↳ offer` | `string` Required. New Offer. Format: accounts/{account_id}/offers/{offer_id}. |
| `↳ parameters` | `array<https://docs.cloud.google.com/php/docs/reference/cloud-channel/latest/V1.Parameter>` Optional. Parameters needed to purchase the Offer. To view the available Parameters refer to the [Offer.parameter_definitions](https://docs.cloud.google.com/php/docs/reference/cloud-channel/latest/V1.Offer#_Google_Cloud_Channel_V1_Offer__getParameterDefinitions__) from the desired offer. |
| `↳ purchase_order_id` | `string` Optional. Purchase order id provided by the reseller. |
| `↳ request_id` | `string` Optional. You can specify an optional unique request ID, and if you need to retry your request, the server will know to ignore the request if it's complete. For example, you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if it received the original operation with the same request ID. If it did, it will ignore the second request. The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122) with the exception that zero UUID is not supported (`00000000-0000-0000-0000-000000000000`). |
| `↳ billing_account` | `string` Optional. The billing account resource name that is used to pay for this entitlement when setting up billing on a trial subscription. This field is only relevant for multi-currency accounts. It should be left empty for single currency accounts. |
| `↳ price_reference_id` | `string` Optional. Price reference ID for the offer. Only for offers that require additional price information. Used to guarantee that the pricing is consistent between quoting the offer and placing the order. |

### getName

Required. The resource name of the entitlement to update.

Name uses the format:
accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id}

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setName

Required. The resource name of the entitlement to update.

Name uses the format:
accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id}

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getOffer

Required. New Offer.

Format: accounts/{account_id}/offers/{offer_id}.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setOffer

Required. New Offer.

Format: accounts/{account_id}/offers/{offer_id}.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getParameters

Optional. Parameters needed to purchase the Offer. To view the available
Parameters refer to the
[Offer.parameter_definitions](https://docs.cloud.google.com/php/docs/reference/cloud-channel/latest/V1.Offer#_Google_Cloud_Channel_V1_Offer__getParameterDefinitions__)
from the desired offer.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://protobuf.dev/reference/php/api-docs/Google/Protobuf/RepeatedField<https://docs.cloud.google.com/php/docs/reference/cloud-channel/latest/V1.Parameter>` |   |

### setParameters

Optional. Parameters needed to purchase the Offer. To view the available
Parameters refer to the
[Offer.parameter_definitions](https://docs.cloud.google.com/php/docs/reference/cloud-channel/latest/V1.Offer#_Google_Cloud_Channel_V1_Offer__getParameterDefinitions__)
from the desired offer.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `array<https://docs.cloud.google.com/php/docs/reference/cloud-channel/latest/V1.Parameter>` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getPurchaseOrderId

Optional. Purchase order id provided by the reseller.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setPurchaseOrderId

Optional. Purchase order id provided by the reseller.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getRequestId

Optional. You can specify an optional unique request ID, and if you need to
retry your request, the server will know to ignore the request if it's
complete.

For example, you make an initial request and the request times out. If you
make the request again with the same request ID, the server can check if
it received the original operation with the same request ID. If it did, it
will ignore the second request.
The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
with the exception that zero UUID is not supported
(`00000000-0000-0000-0000-000000000000`).

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setRequestId

Optional. You can specify an optional unique request ID, and if you need to
retry your request, the server will know to ignore the request if it's
complete.

For example, you make an initial request and the request times out. If you
make the request again with the same request ID, the server can check if
it received the original operation with the same request ID. If it did, it
will ignore the second request.
The request ID must be a valid [UUID](https://tools.ietf.org/html/rfc4122)
with the exception that zero UUID is not supported
(`00000000-0000-0000-0000-000000000000`).

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getBillingAccount

Optional. The billing account resource name that is used to pay for this
entitlement when setting up billing on a trial subscription.

This field is only relevant for multi-currency accounts. It should be
left empty for single currency accounts.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setBillingAccount

Optional. The billing account resource name that is used to pay for this
entitlement when setting up billing on a trial subscription.

This field is only relevant for multi-currency accounts. It should be
left empty for single currency accounts.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |

### getPriceReferenceId

Optional. Price reference ID for the offer. Only for offers that require
additional price information. Used to guarantee that the pricing is
consistent between quoting the offer and placing the order.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `string` |   |

### setPriceReferenceId

Optional. Price reference ID for the offer. Only for offers that require
additional price information. Used to guarantee that the pricing is
consistent between quoting the offer and placing the order.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `var` | `string` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `$this` |   |