Gemini Code Assist を使用するには、まずこのドキュメントで説明する設定手順を行う必要があります。
Google Cloud プロジェクトで Identity and Access Management(IAM)ロールを付与します。
組織のユーザーが Cloud Code プラグインをインストールして、IDE で Gemini Code Assist を使用します。
Gemini Code Assist のサブスクリプションを購入する
Gemini Code Assist サブスクリプションを購入する手順は、購入するエディション(Enterprise または Standard)によって異なります。各エディションで利用可能な機能の一覧については、サポートされている機能をご覧ください。
Enterprise エディション
Gemini Code Assist Enterprise は、2025 年 3 月 31 日までは 12 か月契約で 1 ユーザーあたり月額 19 ドルでご利用いただけます。このプロモーション特典をご利用になるには、Google のセールスチームにお問い合わせください。
Standard エディション
Gemini Code Assist Standard エディションは、2024 年 11 月 8 日まで、サブスクリプションなしで料金不要でお試しいただけます。ただし、請求先アカウントごとに 1 ユーザーに限られます。1 つの請求先アカウントに複数のユーザーが存在する組織は、このセクションの説明に沿ってサブスクリプションを購入する必要があります。
Google Cloud と既存の契約を結んでいる場合は、サブスクリプションを購入する前に セールスチームに問い合わせください。
注: Gemini のサブスクリプションを購入するには、consumerprocurement.orders.place
Identity and Access Management(IAM)権限を付与されていることが必要です。consumerprocurement.orders.place
権限は、roles/billing.admin
IAM ロールまたは roles/consumerprocurement.orderAdmin
ロールに含まれています。または、カスタムロールに権限を追加することもできます。[Gemini for Google Cloud] ページに移動します。
[Gemini for Google Cloud] ページが開きます。
[Gemini Code Assist を利用する] をクリックします。プロジェクトに Gemini Code Assist がすでにある場合は、このテキストに [Gemini Code Assist を管理] と表示されます。
[Gemini Code Assist サブスクリプションを取得する] ページが開きます。
[サブスクリプションの構成] で、サブスクリプションを構成するフィールドに入力します。
- サブスクリプション名
- サブスクリプションのライセンス数。
- サブスクリプションの期間(月単位または年単位)。年間サブスクリプションでは、まとめ払いではなく、割引料金が毎月請求されます。
- コミットメント期間(月単位または年単位)の終了後にサブスクリプションが自動更新されます。自動更新では、サブスクリプションとライセンスが有効のままになります。サブスクリプションが自動更新されない場合、現在の期間が終了するとサブスクリプションが終了し、ライセンスを再割り当てするには、購入プロセスをもう一度行う必要があります。
サブスクリプションの詳細を確認するには、[続行] をクリックします。
利用規約に同意する場合は、[この購入の利用規約に同意します] を選択し、[サブスクリプションを確認] をクリックします。
[次へ: Gemini ライセンスの割り当てを管理] をクリックします。
Gemini Code Assist のサブスクリプションが購入されました。組織内の Gemini ライセンスの割り当てを管理する必要があります。
ライセンスを割り当て
Gemini Code Assist を使用するには、組織内の各ユーザーにライセンスが必要です。
コンソール
Google Cloud コンソールで Gemini ライセンスを個々のユーザーに割り当てるには、次の権限が必要です。
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign
[Gemini の管理] ページに移動します。
変更する定期購入を選択し、[定期購入を変更] をクリックします。
[ライセンスを割り当て] をクリックします。ユーザー選択ダイアログが表示されます。特定のユーザーを検索するには、検索ボックスに名前を入力します。
リストから 1 人以上のユーザーを選択し、[次へ] をクリックします。
ライセンスを割り当てる Gemini サービスを選択します。
[ライセンスを割り当て] をクリックします。
API
API で Gemini ライセンスを割り当てるには、consumerprocurement.licensePools.assign
権限が必要です。
HTTP メソッド: POST
URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/
以下を置き換えます。
BILLING_ACCOUNT_ID
: 請求先アカウント IDORDER_ID
: IAM ポリシー
リクエスト本文:
{
"usernames": [
"dana@example.com",
"lee@example.com"
]
}
出力は次のようになります。
{}
ライセンスが正常に割り当てられた場合、レスポンスは空になります。
この請求先アカウントに関連付けられている 1 つ以上のプロジェクトで Gemini for Google Cloud API を有効にする必要があります。少なくとも 1 つのプロジェクトで Gemini Code Assist を有効にするまで、Gemini Code Assist がユーザーに表示されません。
Google Cloud プロジェクトで Gemini for Google Cloud API を有効にする
このセクションでは、Google Cloud プロジェクトで Gemini for Google Cloud API を有効にするために必要な手順について説明します。
コンソール
Gemini for Google Cloud API を有効にするには、[Gemini for Google Cloud] ページに移動します。
プロジェクト セレクタでプロジェクトを選択します。
[有効にする] をクリックします。
ページが更新され、[有効] のステータスが表示されます。これで、必要な IAM ロールを持つすべてのユーザーが、選択した Google Cloud プロジェクトで Gemini を使用できるようになりました。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
プロジェクト選択メニューで、プロジェクトを選択します。
gcloud services enable
コマンドを使用して、Gemini 用の Gemini for Google Cloud API を有効にします。gcloud services enable cloudaicompanion.googleapis.com
別の Google Cloud プロジェクトで Gemini for Google Cloud API を有効にする場合は、
--project
パラメータを追加します。gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
PROJECT_ID
は、実際の Google Cloud プロジェクト ID に置き換えます。出力は次のようになります。
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete... Operation finished successfully.
これで、必要な IAM ロールを持つすべてのユーザーが、指定された Google Cloud プロジェクトで Gemini for Google Cloud を使用できるようになりました。
Google Cloud プロジェクトで IAM ロールを付与する
このセクションでは、Gemini for Google Cloud のユーザーと Service Usage コンシューマの IAM ロールをユーザーに付与するために必要な手順について説明します。
コンソール
Gemini の使用に必要な IAM ロールを付与するには、[IAM と管理] ページに移動します。
[プリンシパル] 列で、Gemini へのアクセスを許可するプリンシパルを見つけて、その行で [プリンシパルを編集] をクリックします。
権限の編集ペインで、[
別のロールを追加] をクリックします。[ロールを選択] で、[Gemini for Google Cloud ユーザー] を選択します。
[別のロールを追加] をクリックし、[Service Usage ユーザー] を選択します。
[保存] をクリックします。
gcloud
-
In the Google Cloud console, activate Cloud Shell.
プロジェクト選択メニューで、プロジェクトを選択します。
Gemini for Google Cloud ユーザーロールを付与してください
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/cloudaicompanion.user
PRINCIPAL
は、プリンシパルの ID に置き換えます。識別子の形式はuser|group|serviceAccount:email
またはdomain:domain
です(例えば、user:cloudysanfrancisco@gmail.com
、group:admins@example.com
、serviceAccount:test123@example.domain.com
、domain:example.domain.com
)。以下を含むポリシー バインディングのリストが出力されます。
- members: - user:PRINCIPAL role: roles/cloudaicompanion.user
Service Usage ユーザーロールを付与する:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
以下を含むポリシー バインディングのリストが出力されます。
- members: - user:PRINCIPAL role: roles/serviceusage.serviceUsageConsumer
詳細については、単一のロールを付与すると gcloud projects add-iam-policy-binding
をご覧ください。
これらのロールが付与されたすべてのユーザーは、指定したプロジェクト内で Google Cloud コンソールで Gemini for Google Cloud 機能にアクセスできます。詳細については、Gemini for Google Cloud の概要をご覧ください。
Cloud Code プラグインをインストールして IDE で Gemini Code Assist を使用する
組織のユーザーが、お気に入りの IDE に Gemini Code Assist をインストールします。詳しくは以下をご覧ください。
- Cloud Workstations: Gemini Code Assist を使用したコード
- Cloud Shell エディタ: Gemini Code Assist を使用したコード
- Cloud Code for VS Code: Gemini Code Assist を使用したコード
- Cloud Code for IntelliJ とその他の JetBrains IDE: Gemini Code Assist を使用したコード
高度な設定タスク
Google Cloud コンソールまたは gcloud CLI を使用して事前定義された IAM ロールを付与する代わりに、次のいずれかを行うことができます。
IAM REST API または IAM クライアント ライブラリを使用してロールを付与します。
これらのインターフェースを使用する場合は、完全修飾ロール名を使用します。
roles/cloudaicompanion.user
roles/serviceusage.serviceUsageConsumer
ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。
カスタムロールを作成して付与する。
作成するカスタムロールには、Gemini Code Assist にアクセスするために次の権限が必要です。
cloudaicompanion.companions.generateChat
cloudaicompanion.companions.generateCode
cloudaicompanion.instances.completeCode
cloudaicompanion.instances.completeTask
cloudaicompanion.instances.generateCode
cloudaicompanion.instances.generateText
serviceusage.services.enable
ライセンスを割り当て、管理する。
作成するカスタムロールには、Gemini Code Assist にアクセスするために次の権限が必要です。
consumerprocurement.orders.get
consumerprocurement.orders.licensePools..*
consumerprocurement.orders.licensePools.update
consumerprocurement.orders.licensePools.get
consumerprocurement.orders.licensePools.assign
consumerprocurement.orders.licensePools.unassign
consumerprocurement.orders.licensePools.enumerateLicensedUsers
また、上記の権限が機能するには、各権限を割り当てた同じ Google Cloud プロジェクトで Gemini for Google Cloud API を有効にする必要があります。
次のステップ
- Google Cloud の Gemini Code Assist で利用できる生成 AI アシスタンスの種類の詳細を確認する。
- Gemini Code Assist for Google Cloud がデータを使用する方法について確認する。
- Gemini Code Assist 管理者コントロールにアクセスして管理する方法を学習する。
- コードのカスタマイズを構成する方法を学習する。