Before using Gemini Code Assist, each user in your organization needs a license.
By default, new subscriptions require you to manually assign licenses. After you set up certain Gemini for Google Cloud products, you can then choose to assign licenses manually or automatically.
Before you begin
- Ensure that you have the Billing Account Administrator
(
roles/billing.admin
) or Consumer Procurement Order Administrator (roles/consumerprocurement.orderAdmin
) IAM roles so that you can grant additional permissions required for specific license management tasks detailed in the following sections.
- If you want to manage licenses using an API rather than the Google Cloud console,
then ensure the following:
- Set up a quota project for your billing account.
- Enable the Cloud Commerce Consumer Procurement API in your quota project.
- Ensure the following header key-value pairs are present on all API calls:
Authorization
: your Google Cloud access token from the Google Cloud CLIx-goog-user-project
: the project ID of your quota project
Change the number of Gemini Code Assist licenses in a subscription
You can add or remove the number of Gemini for Google Cloud licenses directly through the Google Cloud console, or through your Google account representative or an authorized reseller.
To change the number of licenses in a subscription, follow these steps:
Ensure that you have the following Identity and Access Management (IAM) permissions on the billing account that owns the subscription:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.orders.modify
resourcemanager.projects.get
In the Google Cloud console, go to the Admin for Gemini page.
Choose the subscription that you want to change, and then select Modify Subscription.
Enter the number of licenses that you want to have. The following information is displayed:
- Number of total licenses after purchase.
- Number of licenses available for assignment after purchase.
- New subscription price per term. The additional amount for the added licenses is prorated based on how much time remains in the current term.
Select Save.
View Gemini Code Assist license assignments
Select one of the following options:
Console
Ensure that you have the following IAM permissions on the billing account that owns the subscription:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
resourcemanager.projects.get
Go to the Admin for Gemini page.
Choose the subscription that you want to change, and then select Modify Subscription.
The following information is available for each user that has been assigned a license:
- Name
- Account type
- Licenses assigned
To find a specific set of users, you can filter and sort the list as follows:
- To filter the list, in the Filter field, enter the properties and values.
- To sort the list, select the heading of the column that you want to sort by. For example, to sort alphabetically by the user names, select the Name column heading.
API
To view Gemini Code Assist license assignments, use
the
billingAccounts.orders.licensePool.enumerateLicensedUsers
method.
To perform this task, you must have the
consumerprocurement.licensePools.enumerateLicensedUsers
permission on the
billing account that owns the subscription.
GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/
Replace the following:
BILLING_ACCOUNT_ID
: the billing account IDORDER_ID
: the IAM policy
If the command succeeds, it returns licensedUsers
output in the following
format:
{
"licensedUsers": [
{
"username": "dana@example.com",
"assignTime": "2024-09-26T16:24:40.559222Z"
},
{
"username": "lee@example.com",
"assignTime": "2024-09-26T16:24:40.559222Z"
},
{
"username": "taylor@example.com",
"assignTime": "2024-09-26T16:24:40.559222Z"
},
{
"username": "bola@example.com",
"assignTime": "2024-09-26T16:24:14.610828Z"
}
]
}
Manually assign Gemini Code Assist licenses to individual users
Select one of the following options:
Console
Ensure that you have the following IAM permissions on the billing account that owns the subscription:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign
resourcemanager.projects.get
Go to the Admin for Gemini page.
Select Manage Gemini Code Assist, and then select Modify Subscription.
For this Gemini Code Assist subscription, ensure that you set License Assignment to Manually Assign Licenses. If the Gemini Code Assist subscription is set to Automatically Assign Licenses, then you cannot manage individual licenses. Switching this billing account to Manually Assign Licenses turns off automatic license assignment after the change, but pre-existing license assignments are unaffected.
Select Assign Licenses. A user selection dialog appears. To search for specific users, enter their email address and then select Next.
Select Assign Licenses.
API
To assign Gemini Code Assist licenses, use the
billingAccounts.orders.licensePool.assign
method.
To perform this task, ensure you have the following permissions on the billing account that owns the subscription:
billing.accounts.get
consumerprocurement.licensePools.assign
consumerprocurement.licensePools.get
consumerprocurement.licensePools.unassign
consumerprocurement.orders.get
POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/
{
"usernames": [
"dana@example.com",
"lee@example.com"
]
}
Replace the following:
BILLING_ACCOUNT_ID
: the billing account IDORDER_ID
: the IAM policy
If the command succeeds, it returns an empty response body in the following format:
{}
To verify the assignment, view the list of assignments.
Automatically assign Gemini Code Assist licenses
You can automatically assign a license to any user in your organization who requires access to Gemini Code Assist from the License Assignment page. Automatic license assignment is set individually for each subscription.
If you choose to automatically assign licenses for a Gemini Code Assist, you can't remove or add individual user licenses under that account. Users with license assignments who haven't used any Gemini Code Assist features are automatically de-provisioned at the end of the billing period after a specified number of days of inactivity as set by the administrator.
In the Google Cloud console, go to the Admin for Gemini page.
Select Manage Gemini Code Assist, and then select Manage Subscription.
Select License Management, and then select Enable Automatic License Assignment. The Enable automatic licenses dialog appears.
Switching this subscription to automatically assign licenses turns off manual license assignment after the change, but pre-existing license assignments are unaffected.
Set the length of time for a license to unassign if the assignee is inactive, then select Confirm Change. The Automatic license assignment has been enabled dialog appears.
Select Close.
As long as licenses are available for assignment, new users automatically receive a license when they first access Gemini Code Assist covered by your subscriptions in this billing account.
To disable automatic license assignment, follow these steps:
In the Google Cloud console, go to the Admin for Gemini page.
Select Manage Gemini Code Assist, and then select Manage Subscription.
Select License Management, and then select Manage Automatic License Assignment. The Manage automatic license assignment dialog appears.
Select Disable automatic license management.
Select Confirm change.
Manually unassign Gemini Code Assist licenses
Select one of the following options:
Console
Ensure that you have the following IAM permissions on the billing account that owns the subscription:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.unassign
resourcemanager.projects.get
Go to the Admin for Gemini page.
Select Manage Gemini Code Assist, and then select Manage Subscription.
Select License Management, and then select Manage Automatic License Assignment. The Manage automatic license assignment dialog appears.
Select the users for which you want to unassign licenses, then select Unassign License.
Select Confirm.
API
To unassign Gemini Code Assist licenses, use the
billingAccounts.orders.licensePool.unassign
method.
To perform this task, you must have the
consumerprocurement.licensePools.unassign
permission on the billing account
that owns the subscription.
POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/
{
"usernames": [
"dana@example.com",
"lee@example.com"
]
}
Replace the following:
BILLING_ACCOUNT_ID
: the billing account IDORDER_ID
: the IAM policy
If the command succeeds, it returns an empty response body in the following format:
{}
To verify the unassignment, view the list of assignments.
Transfer Gemini Code Assist licenses
Gemini Code Assist licenses cannot be transferred directly between users. Instead, unassign the license from a user and then assign a license to the new user.
Prevent cross-organization license usage
Gemini Code Assist licenses are assigned to individual users, not organizations or projects, allowing individual users to use Gemini Code Assist across multiple organizations.
Any logs generated from Gemini Code Assist usage sit with the project in which the usage occurred, and not with the licensee. Additionally, any customization or configuration of Gemini Code Assist (such as code customization) is done on the project, not at the license or subscription level.
To further prevent cross-organization usage of Gemini Code Assist in a project, you can do one of the following:
- Disable the Gemini for Google Cloud API in the project.
- Use permissions to deny user access to the project.
Limitations
- Gemini for Google Cloud license management does not support Workforce Identity Federation.