- [Resource: LicenseConfig](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#LicenseConfig)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#LicenseConfig.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#State)
- [AlertPolicyResourceConfig](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#AlertPolicyResourceConfig)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#AlertPolicyResourceConfig.SCHEMA_REPRESENTATION)
- [AlertEnrollment](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#AlertEnrollment)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#AlertEnrollment.SCHEMA_REPRESENTATION)
- [EnrollState](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#EnrollState)
- [ContactDetails](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#ContactDetails)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#ContactDetails.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#METHODS_SUMMARY)

## Resource: LicenseConfig

Information about users' licenses.

| JSON representation |
|---|
| ``` { "name": string, "licenseCount": string, "subscriptionTier": enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/SubscriptionTier`), "state": enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#State`), "autoRenew": boolean, "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`) }, "subscriptionTerm": enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/SubscriptionTerm`), "freeTrial": boolean, "alertPolicyResourceConfig": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#AlertPolicyResourceConfig`) }, "geminiBundle": boolean, "earlyTerminated": boolean, "earlyTerminationDate": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/Shared.Types/Date`) }, "lastUserUpdateTime": string, "billingAccountLicenseConfig": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Immutable. Identifier. The fully qualified resource name of the license config. Format: `projects/{project}/locations/{location}/licenseConfigs/{licenseConfig}` |
| `licenseCount` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. Number of licenses purchased. |
| `subscriptionTier` | ``enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/SubscriptionTier`)`` Required. Subscription tier information for the license config. |
| `state` | ``enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#State`)`` Output only. The state of the license config. |
| `autoRenew` | `boolean` Optional. Whether the license config should be auto renewed when it reaches the end date. |
| `startDate` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/Shared.Types/Date`)`` Required. The start date. |
| `endDate` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/Shared.Types/Date`)`` Optional. The planed end date. |
| `subscriptionTerm` | ``enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/SubscriptionTerm`)`` Required. Subscription term. |
| `freeTrial` | `boolean` Optional. Whether the license config is for free trial. |
| `alertPolicyResourceConfig` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#AlertPolicyResourceConfig`)`` Optional. The alert policy config for this license config. |
| `geminiBundle` | `boolean` Output only. Whether the license config is for Gemini bundle. |
| `earlyTerminated` | `boolean` Output only. 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`)`` Output only. The date when the subscription is terminated earlier than the expiration date. |
| `lastUserUpdateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Optional. timestamp of the most recent user-initiated update (seat count change or subscription term change). Unlike `updateTime`, this field is only stamped when a customer explicitly updates the license (e.g. via the UI), and is not touched by system-driven writes (subscription pipeline, BALC propagation, etc.). Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `billingAccountLicenseConfig` | `string` Output only. The name of the `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/billingAccounts.billingAccountLicenseConfigs#BillingAccountLicenseConfig` from which this `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#LicenseConfig` is assigned, if this field is set. |

## State

License config state enumeration.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Default value. The license config does not exist. |
| `ACTIVE` | The license config is effective and being used. |
| `EXPIRED` | The license config has expired. |
| `NOT_STARTED` | The license config has not started yet, and its start date is in the future. |
| `WITHDRAWN` | This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED. |
| `DEACTIVATING` | The license config 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. |

## AlertPolicyResourceConfig

The resource level alert config. Used in: \* UserLicense \* EngineUserData The AlertPolicyConfig in data connector is of same usage. No easy way to migrate.

| JSON representation |
|---|
| ``` { "alertPolicy": string, "alertEnrollments": [ { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#AlertEnrollment`) } ], "contactDetails": [ { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#ContactDetails`) } ], "languageCode": string, "regionCode": string } ``` |

| Fields ||
|---|---|
| `alertPolicy` | `string` Immutable. The fully qualified resource name of the AlertPolicy. |
| `alertEnrollments[]` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#AlertEnrollment`)`` Optional. The enrollment state of each alert. |
| `contactDetails[]` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#ContactDetails`)`` Optional. The contact details for each alert policy. |
| `languageCode` | `string` Optional. The language code used for notifications |
| `regionCode` | `string` Optional. The region code used of the user that subscribed to the alert policy. |

## AlertEnrollment

The alert enrollment status.

| JSON representation |
|---|
| ``` { "alertId": string, "enrollState": enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#EnrollState`), "notificationParams": { string: string, ... } } ``` |

| Fields ||
|---|---|
| `alertId` | `string` Immutable. The ID of an alert. |
| `enrollState` | ``enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#EnrollState`)`` Required. The enrollment status of a customer. |
| `notificationParams` | `map (key: string, value: string)` Optional. Parameters used to instantiate a notification. Used for notifications that are triggered when registered. Not stored. \* Gemini Business welcome emails. \* Gemini Business user invitation emails. |

## EnrollState

The enrollment status enum for the alert.

| Enums ||
|---|---|
| `ENROLL_STATE_UNSPECIFIED` | Default value. Used for customers who have not responded to the alert policy. |
| `ENROLLED` | Customer is enrolled in this policy. |
| `DECLINED` | Customer declined this policy. |

## ContactDetails

The contact info stored in resource level. If both project level and resource level is populated, the resource level contact info will override the project level contact info.

| JSON representation |
|---|
| ``` { "emailAddress": string } ``` |

| Fields ||
|---|---|
| `emailAddress` | `string` Optional. The email address of the contact. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs/create` | Creates a `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#LicenseConfig` This method should only be used for creating NotebookLm licenses or Gemini Enterprise free trial licenses. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs/get` | Gets a `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#LicenseConfig`. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs/list` | Lists all the `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#LicenseConfig`s associated with the project. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs/patch` | Updates the `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.licenseConfigs#LicenseConfig` |