Gemini Code Assist Standard と Enterprise を設定する

Gemini Code Assist Standard または Enterprise を使用するには、まずこのドキュメントで説明する設定を行う必要があります。

注: 通常、ステップ 1～4 は管理者が行います。

1. Gemini Code Assist Standard または Enterprise のサブスクリプションを購入します。

2. 組織内のユーザーにライセンスを割り当てます。

3. Google Cloud プロジェクトで Gemini for Google Cloud API を有効にします。

4. Google Cloud プロジェクトで Identity and Access Management ロールを付与します。

5. 組織のユーザーが Gemini Code Assist プラグインをインストールして、IDE で Gemini Code Assist Standard または Enterprise を使用します。 Gemini CLI ユーザーまたは Gemini in Android Studio ユーザーの場合、この手順は必要ありません。

Gemini Code Assist のサブスクリプションを購入する

各エディションで利用可能な機能の一覧については、サポートされている機能をご覧ください。

Gemini Code Assist のサブスクリプションを一度も利用したことがない請求先アカウントを持つ Gemini Code Assist の新規ユーザーには、Gemini Code Assist のエディションに関係なく、最初の 1 か月間、最大 50 個の無料ライセンスに相当するクレジットが自動的に適用されます。最初の無料ライセンスのクレジットが割り当てられた後に、無料クレジットの数を増やすことはできません。また、最初の 1 か月間は Gemini Code Assist のエディションを変更できません。

Google Cloud と既存の契約を結んでいる場合は、サブスクリプションを購入する前に セールスチームにお問い合わせください。

注: Gemini のサブスクリプションを購入するには、請求先アカウントに対する consumerprocurement.orders.place Identity and Access Management 権限が付与されていることが必要です。consumerprocurement.orders.place 権限は、roles/billing.admin IAM ロールまたは roles/consumerprocurement.orderAdmin ロールに含まれています。また、カスタムロールに権限を追加することもできます。

1. [Gemini の管理] ページに移動します。

   [Gemini の管理] に移動

   [Gemini の管理] ページが開きます。

2. [Gemini Code Assist を入手する] を選択します。

   必要な consumerprocurement.orders.place 権限がない場合は、このボタンが無効になります。プロジェクトに関連付けられている請求先アカウントに Gemini Code Assist サブスクリプションがすでに存在する場合、このボタンは [Gemini Code Assist を管理] と表示され、サブスクリプションを編集できます。

   [Gemini Code Assist のサブスクリプションを入手する] ページが開きます。

3. [Gemini Code Assist のサブスクリプション エディションを選択する] で、Gemini Code Assist のエディションを選択します。[Gemini Code Assist のエディションを比較する] を選択すると、各エディションで利用可能な機能の詳細なリストが表示されます。

   [続行] を選択します。

4. [サブスクリプションの構成] で、次のようなサブスクリプションを構成するフィールドに入力します。

   • サブスクリプション名
   • サブスクリプションのライセンス数。Enterprise エディションを購入する場合は、少なくとも 10 ライセンスを購入する必要があります。
   • サブスクリプション期間（月単位または年単位）。年間サブスクリプションでは、まとめ払いではなく、月単位で割引料金が請求されます。

   デフォルトでは、新しいサブスクリプションはライセンスの自動割り当て用に設定されています。組織内のユーザーがサポートされている IDE 内で Gemini Code Assist を使用すると、次の条件がすべて満たされている場合に、ライセンスが自動的に割り当てられます。

   • ユーザーが、サブスクリプションの請求先アカウントに関連付けられているプロジェクトを選択した。
   • 選択したプロジェクトに対する cloudaicompanion.licences.selfAssign IAM 権限がユーザーに付与されている。

   Gemini Code Assist を設定したら、ライセンスを手動で割り当てるかどうかを選択できます。

5. サブスクリプションを確定するには、[続行] を選択します。

6. 利用規約に同意する場合は、[この購入の利用規約に同意します] を選択し、[サブスクリプションの確認] を選択します。

7. [次へ: Gemini ライセンスの割り当てを管理] を選択します。

Gemini Code Assist Standard または Enterprise のサブスクリプションが購入されました。次に、組織内の Gemini ライセンスの割り当てを管理する必要があります。

ライセンスを割り当て

Gemini Code Assist ライセンスを使用する前に、ユーザーは、API がすでに有効になっているプロジェクトで Gemini for Google Cloud ユーザーロールまたは同等の権限を持っている必要があります。

Gemini Code Assist のサブスクリプションを一度も利用したことがない請求先アカウントを持つ Gemini Code Assist の新規ユーザーには、Gemini Code Assist のエディションに関係なく、最初の 1 か月間、最大 50 個の無料ライセンスに相当するクレジットが自動的に適用されます。最初の無料ライセンスのクレジットが割り当てられた後に、無料クレジットの数を増やすことはできません。また、最初の 1 か月間は Gemini Code Assist のエディションを変更できません。

デフォルトでは、新しいサブスクリプションはライセンスの自動割り当て用に設定されています。組織内のユーザーがサポートされている IDE で Gemini Code Assist を使用すると、次の条件がすべて満たされている場合に、ライセンスが自動的に割り当てられます。

• ユーザーが、サブスクリプションの請求先アカウントに関連付けられているプロジェクトを選択した。
• 選択したプロジェクトに対する cloudaicompanion.licences.selfAssign IAM 権限がユーザーに付与されている。

ライセンスが 30 日間非アクティブな状態になると、上記の条件を満たす組織内の別のユーザーに自動的に割り当てられます。

Gemini Code Assist を設定すると、[Gemini の管理者] ページに移動し、請求先アカウントを選択して [Gemini Code Assist サブスクリプションを管理] をクリックし、[ライセンス管理] タブを選択することで、ライセンスの割り当てを確認できます。ライセンスの割り当てをより細かく制御する必要がある場合は、このタブを使用して、自動ライセンス管理から手動ライセンス管理に切り替えることもできます。

この請求先アカウントに関連付けられている 1 つ以上のプロジェクトで Gemini for Google Cloud API を有効にする必要があります。少なくとも 1 つのプロジェクトで Gemini Code Assist を有効化するまでは、ユーザーには Gemini Code Assist が表示されません。

Cloud プロジェクトで Gemini for Google Cloud API を有効にする

このセクションでは、Cloud プロジェクトで Gemini for Google Cloud API を有効にするために必要な手順について説明します。Gemini Code Assist には、API アクセス、割り当て、課金を管理するために Cloud プロジェクトが必要です。そのため、ユーザーが Gemini Code Assist にアクセスできるように、選択した Cloud プロジェクトで Gemini for Google Cloud API を有効にする必要があります。

コンソール

1. Gemini for Google Cloud API を有効にするには、[Gemini for Google Cloud] ページに移動します。

   [Gemini for Google Cloud] に移動

2. プロジェクト セレクタで、プロジェクトを選択します。

3. [有効にする] をクリックします。

   ページが更新され、[有効] のステータスが表示されます。これで、必要な IAM ロールを持つすべてのユーザーが、選択した Cloud プロジェクトで Gemini を使用できるようになりました。

gcloud

ローカル開発環境を使用するには、gcloud CLI をインストールして初期化します。

1. プロジェクト選択メニューで、プロジェクトを選択します。

2. gcloud services enable コマンドを使用して、Gemini 用の Gemini for Google Cloud API を有効にします。

   gcloud services enable cloudaicompanion.googleapis.com
   

   別の Cloud プロジェクトで Gemini for Google Cloud API を有効にする場合は、--project パラメータを追加します。

   gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
   

   PROJECT_ID を Cloud プロジェクト ID に置き換えます。

   出力は次のようになります。

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

これで、必要な IAM ロールを持つすべてのユーザーが、指定された Cloud プロジェクトで Gemini for Google Cloud を使用できるようになりました。

IDE と Google 間の API トラフィック用にファイアウォールを構成する

ファイアウォールで保護されているユーザーは、Gemini for Google Cloud を有効にするだけでなく、次の API のトラフィックが通過できるようにする必要があります。

• oauth2.googleapis.com: Google Cloud へのログインに使用されます。
• serviceusage.googleapis.com: ユーザーの Gemini Code Assist プロジェクトが正しく構成されていることを確認するために使用されます。
• cloudaicompanion.googleapis.com: プライマリ Gemini for Google Cloud API エンドポイント。
• cloudcode-pa.googleapis.com: IDE に関連のある機能を提供する内部 API。
• cloudresourcemanager.googleapis.com: IDE のプロジェクト選択ツールで使用されます。プロジェクトが settings.json ファイルで明示的に構成されている場合は、Resource Manager API が必要ない場合があります。
• people.googleapis.com: プロフィールと連絡先に関する情報へのアクセスを提供します。
• firebaselogging-pa.googleapis.com: 提案が承認されたかどうかに関するイベントなど、プロダクトのテレメトリーを送信するために使用される内部 API。
• feedback-pa.googleapis.com: IDE 内のフィードバックの送信に使用される内部 API。
• apihub.googleapis.com: Cloud Code API ブラウザ機能で使用されます。
• lh3.googleusercontent.com、lh5.googleusercontent.com: ユーザーの写真を取得するために使用されます。

Google Cloud のデフォルト ドメインの IP アドレスを特定する

IDE から Google Cloud APIs への接続を有効にするには、ファイアウォールで、Google の公開ドキュメントに記載されている IP アドレス範囲へのアウトバウンド TCP トラフィックを許可する必要があります。これらの範囲は Google によって動的に管理されます。

Google Cloud ドメインにアクセスする IP 範囲のリストを維持するには、次の方法があります。

• 公開されているリストを使用するか、Google の IP アドレス範囲を取得するスクリプトを自動化します。
• private.googleapis.com の仮想 IP を使用します。
• Private Service Connect を使用する

省略可: VPC Service Controls を構成する

組織にサービス境界がある場合は、次のリソースを境界に追加する必要があります。

• Gemini for Google Cloud API
• Gemini Code Assist API

サービス境界外から Gemini Code Assist Standard または Enterprise を使用している場合は、上り（内向き）ポリシーを変更して、これらのサービスへのアクセスを許可する必要があります。

詳細については、Gemini 用に VPC Service Controls を構成するをご覧ください。

Google Cloud プロジェクトで IAM ロールを付与する

このセクションでは、Gemini for Google Cloud ユーザーと Service Usage ユーザーの IAM ロールをユーザーに付与するために必要な手順について説明します。

コンソール

1. Gemini の使用に必要な IAM ロールを付与するには、[IAM と管理] ページに移動します。

   [IAM と管理] に移動

2. [アクセス権を付与] をクリックし、Gemini へのアクセス権を付与するプリンシパル名を入力します。

3. [アクセス権を付与] ペインで、[ 別のロールを追加] をクリックします。

4. [ロールを割り当てる] で、[Gemini for Google Cloud ユーザー] を選択します。

5. [ロールを追加] をクリックし、[Service Usage ユーザー] を選択します。

6. [保存] をクリックします。

gcloud

ローカル開発環境を使用するには、gcloud CLI をインストールして初期化します。

1. プロジェクト選択メニューで、プロジェクトを選択します。

2. Gemini for Google Cloud ユーザーロールを付与します。

   gcloud projects add-iam-policy-binding PROJECT_ID \
     --member=PRINCIPAL --role=roles/cloudaicompanion.user
   

   次のように置き換えます。

   • PROJECT_ID: Cloud プロジェクトの ID（例: 1234567890）。
   • PRINCIPAL: プリンシパルの ID（例: user:[e-mail]）。

   以下を含むポリシー バインディングのリストが出力されます。

   - members:
     - user:PRINCIPAL
     role: roles/cloudaicompanion.user
   

3. ロール roles/serviceusage.serviceUsageConsumer に対しても前の手順を繰り返します。

詳細については、単一のロールを付与すると gcloud projects add-iam-policy-binding をご覧ください。

これらのロールが付与されたすべてのユーザーは、指定したプロジェクト内で Google Cloud コンソールで Gemini for Google Cloud 機能にアクセスできます。詳細については、Gemini for Google Cloud の概要をご覧ください。

Gemini Code Assist プラグインをインストールする

組織のユーザーが、適切なサポート対象の IDE に Gemini Code Assist プラグインをインストールします。サポート対象の JetBrains IDE のユーザーは、IntelliJ の手順に沿って操作してください。

VS Code

1. VS Code で （Extensions）をクリックするか、Ctrl/Cmd+Shift+X キーを押して、[Extensions] ビューを開きます。

2. Gemini Code Assist を検索します。

3. [インストール] をクリックします。

4. プロンプトが表示されたら、VS Code を再起動します。

   拡張機能が正常にインストールされたら、Gemini Code Assist がアクティビティ バーに表示され、使用できるようになります。Gemini Code Assist のインストールをさらに構成するには、最上位のアプリケーション タスクバーを使用して [Code] > [Settings] > [Settings] > [Extensions] に移動し、Gemini Code Assist を検索して、設定を指定します。

IntelliJ

1. settings [IDE and Project Settings] > [Plugins] をクリックします。
2. [Marketplace] タブで Gemini Code Assist を検索します。
3. [Install] をクリックしてプラグインをインストールします。
4. インストールが完了したら、[Restart IDE] をクリックします。

5. IDE が再起動すると、アクティビティ バーに Gemini Code Assist が表示されます。

   

これで、ユーザーは IDE で Gemini Code Assist Standard または Gemini Code Assist Enterprise を使用できるようになりました。サポートされている機能の詳細をご確認ください。

• コード機能の概要
• チャット機能の概要

まずは、以下のガイドをご覧ください。

• Gemini Code Assist によるコード
• Gemini Code Assist とチャットする

Gemini Code Assist が情報をキャッシュに保存するディレクトリのリスト

次の表に、Gemini Code Assist が認証トークンなどの拡張機能の情報を保存するディレクトリの一覧を示します。

Windows

• %LOCALAPPDATA%/cloud-code
• %LOCALAPPDATA%/google-vscode-extension

macOS

• ~/Library/Application Support/cloud-code
• ~/Library/Application Support/google-vscode-extension

Linux

• ~/.cache/cloud-code
• ~/.cache/google-vscode-extension

Google にログインして Google Cloud プロジェクトを選択する

IDE に Gemini Code Assist をインストールしたら、ユーザーは Google アカウントにログインする必要があります。IDE で初めて Gemini Code Assist Standard または Gemini Code Assist Enterprise を使用する場合は、Google Cloud プロジェクトを選択します。これは Gemini Code Assist の設定時に使用したのと同じプロジェクトであり、API アクセス、割り当て、課金の管理に使用されます。

VS Code

Gemini for Google Cloud API を有効にせずに Google Cloud プロジェクトを選択すると、IDE から API を有効にするオプションを示す通知が届きます。通知ウィンドウで [API を有効にする] を選択して、プロジェクトに対してこの API を有効にします。詳細については、プロジェクトに Gemini Code Assist の Standard と Enterprise を設定するをご覧ください。

IDE で直接 Gemini Code Assist によるコードのチュートリアルを進める場合は、[Launch VS Code] をクリックして、そのチュートリアルの説明に従って Google Cloud に接続し、Gemini Code Assist の Standard と Enterprise を有効にしてください。

VS Code を起動する

それ以外の場合は、次の手順を行います。

1. IDE を起動します。

2. アクティビティ バーで、[Gemini Code Assist] をクリックします。

3. [Gemini Code Assist] チャットペインで、[Login to Google Cloud] をクリックします。

4. Gemini Code Assist で外部のウェブサイトを開くように求められたら、[Open] をクリックします。

5. 画面の指示に沿って Google アカウントにログインします。

6. Gemini Code Assist を Google からダウンロードしたことを確認するメッセージが表示されたら、[ログイン] をクリックします。

   注: ログイン試行が常にタイムアウトになる場合のトラブルシューティングの詳細については、ログイン試行が常にタイムアウトになるという既知の問題をご覧ください。

   これで Google Cloud に接続されました。

   次に、Gemini for Google Cloud API が有効になっている Google Cloud プロジェクトを選択するには、次の手順に沿って操作します。

7. [Gemini Code Assist] ステータスバーで [Gemini Code Assist] をクリックします。

   

8. [Gemini Code Assist] メニューで、[Gemini Code プロジェクトを選択] を選択します。

9. Gemini for Google Cloud API が有効になっている Google Cloud プロジェクトを選択します。

   これで、Gemini Code Assist の Standard または Enterprise を使用できるようになりました。

   

IntelliJ

Google アカウントにログインする手順は次のとおりです。

1. アクティビティ バーで、[spark Gemini Code Assist] をクリックします。

2. [Log in to Google] をクリックします。または、[Copy link] をクリックして、URL をブラウザに貼り付けることもできます。

3. ウェブブラウザで開いたページで、Google アカウントを選択します。

4. このアプリを Google からダウンロードしたことを確認する画面で、[ログイン] をクリックします。

   これで、Gemini Code Assist からアカウントにアクセスできるようになりました。

   次に、IDE で初めて Gemini Code Assist の Standard または Enterprise を使用する場合は、次の手順で Google Cloud プロジェクトを選択する必要があります。

5. IDE に戻ります。Gemini Code Assist ツール ウィンドウで、選択したプロジェクトで Gemini Code Assist を使用するのに必要な API を Google が有効にすることに同意する場合は、[Select a GCP project] をクリックして続行します。

6. [Google Cloud プロジェクトを選択] ダイアログで、Google Cloud プロジェクトを検索して選択し、[OK] をクリックします。

7. [完了] をクリックします。

Gemini Code Assist API が有効になっている状態で Google Cloud プロジェクトが選択されています。これで、IDE で Gemini Code Assist の Standard または Enterprise を使用できるようになりました。

高度な設定タスク

以降のセクションでは、Gemini Code Assist をカスタマイズするための高度な設定タスクについて説明します。

高度な IAM に関する考慮事項

Google Cloud コンソールまたは gcloud を使用して事前定義された IAM ロールを付与する代わりに、次のいずれかを行うことができます。

• IAM REST API または IAM クライアント ライブラリを使用してロールを付与します。

  これらのインターフェースを使用する場合は、完全修飾ロール名を使用します。

  • roles/cloudaicompanion.user
  • roles/serviceusage.serviceUsageConsumer

  ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

• カスタムロールを作成して付与します。

  作成するカスタムロールには、Gemini Code Assist Standard と Enterprise にアクセスするために次の権限が必要です。

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.completeCode
  • cloudaicompanion.instances.completeTask
  • cloudaicompanion.instances.generateCode
  • cloudaicompanion.instances.generateText
  • cloudaicompanion.instances.exportMetrics
  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • 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 の機能は、一般提供またはプレビューのいずれかのリリース チャンネルでリリースされます。Gemini Code Assist を設定すると、プロジェクトは自動的に一般提供リリース チャンネルに設定されます。

Gemini Code Assist のリリース チャンネルは、いつでもプレビュー チャンネルに変更できます。また、一般提供チャンネルに戻すこともできます。

次のステップ

• Gemini for Google Cloud で利用できる生成 AI アシスタンスの種類の詳細について学習する。
• Gemini for Google Cloud がデータを使用する方法について学習する。
• Gemini Code Assist Standard と Enterprise の管理者コントロールにアクセスして管理する方法を学習する。
• Gemini Code Assist Enterprise のコード カスタマイズを構成する方法を学習する。
• Gemini Code Assist Standard と Enterprise 用に VPC Service Controls を構成する。