- [Resource: BillingAccountLicenseConfig](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs#BillingAccountLicenseConfig)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs#BillingAccountLicenseConfig.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs#State)
- [Methods](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs#METHODS_SUMMARY)

## Resource: BillingAccountLicenseConfig

Information about license configs at billing account level.

| JSON representation |
|---|
| ``` { "name": string, "licenseCount": string, "licenseConfigDistributions": { string: string, ... }, "subscriptionName": string, "subscriptionTier": enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/SubscriptionTier`), "subscriptionTerm": enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/SubscriptionTerm`), "startDate": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/Shared.Types/Date`) }, "endDate": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/Shared.Types/Date`) }, "state": enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs#State`), "autoRenew": boolean, "procurementEntitlementId": string, "subscriptionDisplayName": string, "geminiBundle": boolean, "earlyTerminated": boolean, "earlyTerminationDate": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/Shared.Types/Date`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Immutable. Identifier. The fully qualified resource name of the billing account license config. Format: `billingAccounts/{billingAccount}/billingAccountLicenseConfigs/{billingAccountLicenseConfig}`. |
| `licenseCount` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The number of licenses purchased under this billing account license config. |
| `licenseConfigDistributions` | `map (key: string, value: string (https://developers.google.com/discovery/v1/type-format format))` A map of LicenseConfig names to the number of licenses distributed to each. The key is the full resource name of the LicenseConfig, such as `projects/{project}/locations/{location}/licenseConfigs/{licenseConfig}`. The value is the count of licenses allocated to it. |
| `subscriptionName` | `string` Output only. The corresponding SubV3 subscription name. |
| `subscriptionTier` | ``enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/SubscriptionTier`)`` Required. The subscription tier. |
| `subscriptionTerm` | ``enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/SubscriptionTerm`)`` Required. The subscription term. |
| `startDate` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/Shared.Types/Date`)`` Required. The subscription start date. |
| `endDate` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/Shared.Types/Date`)`` Optional. The planed subscription end date. |
| `state` | ``enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs#State`)`` Output only. The state of the BillingAccountLicenseConfig. |
| `autoRenew` | `boolean` Whether the BillingAccountLicenseConfig is auto renewed when it reaches the end date. |
| `procurementEntitlementId` | `string` The procurement entitlement ID of the subscription. |
| `subscriptionDisplayName` | `string` The subscription display name. |
| `geminiBundle` | `boolean` Whether the license config is for Gemini bundle. |
| `earlyTerminated` | `boolean` Indication of whether the subscription is terminated earlier than the expiration date. This is usually terminated by pipeline once the subscription gets terminated from subsv3. |
| `earlyTerminationDate` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/Shared.Types/Date`)`` The date when the subscription is terminated earlier than the expiration date. |

## State

BillingAccountLicenseConfig state enumeration.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | The BillingAccountLicenseConfig does not exist. Default value. Do not use. |
| `ACTIVE` | The BillingAccountLicenseConfig is active and being used. |
| `EXPIRED` | The BillingAccountLicenseConfig has expired. |
| `NOT_STARTED` | The BillingAccountLicenseConfig has not started yet, and its start date is in the future. |
| `DEACTIVATING` | The BillingAccountLicenseConfig is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs/distributeLicenseConfig` | Distributes a `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#LicenseConfig` from billing account level to project level. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs/get` | Gets a `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs#BillingAccountLicenseConfig`. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs/list` | Lists all `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs#BillingAccountLicenseConfig`s for a given billing account. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs/retractLicenseConfig` | This method is called from the billing account side to retract the `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#LicenseConfig` from the given project back to the billing account. |