Google Cloud Channel V1 Client - Class Entitlement (2.2.0)

Reference documentation and code samples for the Google Cloud Channel V1 Client class Entitlement.

An entitlement is a representation of a customer's ability to use a service.

Generated from protobuf message google.cloud.channel.v1.Entitlement

Namespace

Google \ Cloud \ Channel \ V1

Methods

__construct

Constructor.

Parameters
Name
Description
data
array

Optional. Data for populating the Message object.

↳ name
string

Output only. Resource name of an entitlement in the form: accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id}.

↳ create_time
Google\Protobuf\Timestamp

Output only. The time at which the entitlement is created.

↳ update_time
Google\Protobuf\Timestamp

Output only. The time at which the entitlement is updated.

↳ offer
string

Required. The offer resource name for which the entitlement is to be created. Takes the form: accounts/{account_id}/offers/{offer_id}.

↳ commitment_settings
CommitmentSettings

Commitment settings for a commitment-based Offer. Required for commitment based offers.

↳ provisioning_state
int

Output only. Current provisioning state of the entitlement.

↳ provisioned_service
ProvisionedService

Output only. Service provisioning details for the entitlement.

↳ suspension_reasons
array

Output only. Enumerable of all current suspension reasons for an entitlement.

↳ purchase_order_id
string

Optional. This purchase order (PO) information is for resellers to use for their company tracking usage. If a purchaseOrderId value is given, it appears in the API responses and shows up in the invoice. The property accepts up to 80 plain text characters. This is only supported for Google Workspace entitlements.

↳ trial_settings
TrialSettings

Output only. Settings for trial offers.

↳ association_info
AssociationInfo

Association information to other entitlements.

↳ parameters
array< Parameter >

Extended entitlement parameters. When creating an entitlement, valid parameter names and values are defined in the Offer.parameter_definitions . For Google Workspace, the following Parameters may be accepted as input: - max_units: The maximum assignable units for a flexible offer OR - num_units: The total commitment for commitment-based offers The response may additionally include the following output-only Parameters: - assigned_units: The number of licenses assigned to users. For Google Cloud billing subaccounts, the following Parameter may be accepted as input: - display_name: The display name of the billing subaccount.

↳ billing_account
string

Optional. The billing account resource name that is used to pay for this entitlement.

getName

Output only. Resource name of an entitlement in the form: accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id}.

Returns
Type
Description
string

setName

Output only. Resource name of an entitlement in the form: accounts/{account_id}/customers/{customer_id}/entitlements/{entitlement_id}.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getCreateTime

Output only. The time at which the entitlement is created.

Returns
Type
Description

hasCreateTime

clearCreateTime

setCreateTime

Output only. The time at which the entitlement is created.

Parameter
Name
Description
Returns
Type
Description
$this

getUpdateTime

Output only. The time at which the entitlement is updated.

Returns
Type
Description

hasUpdateTime

clearUpdateTime

setUpdateTime

Output only. The time at which the entitlement is updated.

Parameter
Name
Description
Returns
Type
Description
$this

getOffer

Required. The offer resource name for which the entitlement is to be created. Takes the form: accounts/{account_id}/offers/{offer_id}.

Returns
Type
Description
string

setOffer

Required. The offer resource name for which the entitlement is to be created. Takes the form: accounts/{account_id}/offers/{offer_id}.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getCommitmentSettings

Commitment settings for a commitment-based Offer.

Required for commitment based offers.

Returns
Type
Description

hasCommitmentSettings

clearCommitmentSettings

setCommitmentSettings

Commitment settings for a commitment-based Offer.

Required for commitment based offers.

Parameter
Name
Description
Returns
Type
Description
$this

getProvisioningState

Output only. Current provisioning state of the entitlement.

Returns
Type
Description
int

setProvisioningState

Output only. Current provisioning state of the entitlement.

Parameter
Name
Description
var
int
Returns
Type
Description
$this

getProvisionedService

Output only. Service provisioning details for the entitlement.

Returns
Type
Description

hasProvisionedService

clearProvisionedService

setProvisionedService

Output only. Service provisioning details for the entitlement.

Parameter
Name
Description
Returns
Type
Description
$this

getSuspensionReasons

Output only. Enumerable of all current suspension reasons for an entitlement.

Returns
Type
Description

setSuspensionReasons

Output only. Enumerable of all current suspension reasons for an entitlement.

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

getPurchaseOrderId

Optional. This purchase order (PO) information is for resellers to use for their company tracking usage. If a purchaseOrderId value is given, it appears in the API responses and shows up in the invoice. The property accepts up to 80 plain text characters. This is only supported for Google Workspace entitlements.

Returns
Type
Description
string

setPurchaseOrderId

Optional. This purchase order (PO) information is for resellers to use for their company tracking usage. If a purchaseOrderId value is given, it appears in the API responses and shows up in the invoice. The property accepts up to 80 plain text characters. This is only supported for Google Workspace entitlements.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getTrialSettings

Output only. Settings for trial offers.

Returns
Type
Description

hasTrialSettings

clearTrialSettings

setTrialSettings

Output only. Settings for trial offers.

Parameter
Name
Description
Returns
Type
Description
$this

getAssociationInfo

Association information to other entitlements.

Returns
Type
Description

hasAssociationInfo

clearAssociationInfo

setAssociationInfo

Association information to other entitlements.

Parameter
Name
Description
Returns
Type
Description
$this

getParameters

Extended entitlement parameters. When creating an entitlement, valid parameter names and values are defined in the Offer.parameter_definitions .

For Google Workspace, the following Parameters may be accepted as input:

  • max_units: The maximum assignable units for a flexible offer OR
  • num_units: The total commitment for commitment-based offers The response may additionally include the following output-only Parameters:
  • assigned_units: The number of licenses assigned to users. For Google Cloud billing subaccounts, the following Parameter may be accepted as input:
  • display_name: The display name of the billing subaccount.
Returns
Type
Description

setParameters

Extended entitlement parameters. When creating an entitlement, valid parameter names and values are defined in the Offer.parameter_definitions .

For Google Workspace, the following Parameters may be accepted as input:

  • max_units: The maximum assignable units for a flexible offer OR
  • num_units: The total commitment for commitment-based offers The response may additionally include the following output-only Parameters:
  • assigned_units: The number of licenses assigned to users. For Google Cloud billing subaccounts, the following Parameter may be accepted as input:
  • display_name: The display name of the billing subaccount.
Parameter
Name
Description
var
array< Parameter >
Returns
Type
Description
$this

getBillingAccount

Optional. The billing account resource name that is used to pay for this entitlement.

Returns
Type
Description
string

setBillingAccount

Optional. The billing account resource name that is used to pay for this entitlement.

Parameter
Name
Description
var
string
Returns
Type
Description
$this
Design a Mobile Site
View Site in Mobile | Classic
Share by: