このページは Cloud Translation API によって翻訳されました。

Gemini Code Assist を設定する

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

Gemini Code Assist のサブスクリプションを購入します。
組織内の個人ユーザーにライセンスを割り当てます。
Google Cloud プロジェクトで Gemini for Google Cloud API を有効にします。
Google Cloud プロジェクトで Identity and Access Management（IAM）ロールを付与します。
組織のユーザーが Gemini Code Assist プラグインをインストールして、IDE で Gemini Code Assist を使用します。

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

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

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

Gemini Code Assist Enterprise は、2025 年 3 月 31 日までは 12 か月契約を 1 ユーザーあたり月額 19 ドルでご利用いただけます。このプロモーション特典をご利用になるには、Google のセールスチームにお問い合わせください。

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 for Google Cloud] ページが開きます。
[Gemini Code Assist を入手する] を選択します。請求先アカウントで Gemini Code Assist のサブスクリプションが購入されていない場合は、最大 50 ライセンスの 30 日間無料トライアルの対象というメッセージが表示されます。プロジェクトに Gemini Code Assist がすでにある場合は、[Gemini Code Assist を管理する] と表示されます。

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

[続行] を選択します。
[サブスクリプションの構成] で、次のようなサブスクリプションを構成するフィールドに入力します。
- サブスクリプション名
- サブスクリプションのライセンス数。Enterprise エディションを購入する場合は、少なくとも 10 ライセンスを購入する必要があります。
- サブスクリプション期間（月単位または年単位）。年間サブスクリプションでは、まとめ払いではなく、月単位で割引料金が請求されます。
- コミットメント期間（月単位または年単位）の終了後のサブスクリプションの自動更新。自動更新では、サブスクリプションとライセンスが有効のままになります。サブスクリプションが自動更新されない場合、現在の期間が終了するとサブスクリプションが終了し、購入プロセスをもう一度行ってライセンスを再割り当てする必要があります。
サブスクリプションを確定するには、[続行] を選択します。
利用規約に同意する場合は、[この購入の利用規約に同意します] を選択し、[サブスクリプションを確認] を選択します。
[次へ: 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 の管理] ページに移動します。

[Gemini for Google Cloud] に移動
変更するサブスクリプションを選択して、[サブスクリプションを変更] をクリックします。
[ライセンスを割り当て] をクリックします。ユーザー選択のダイアログが表示されます。特定のユーザーを検索するには、検索ボックスに名前を入力します。
リストから 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: 請求先アカウント ID
ORDER_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] ページに移動します。

[Gemini for Google Cloud] に移動
プロジェクトセレクタでプロジェクトを選択します。
[有効にする] をクリックします。

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

gcloud CLI

In the Google Cloud console, activate Cloud Shell.

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 を使用できるようになりました。

ファイアウォールの背後にいるユーザーに必要な API

ファイアウォールの背後にいるユーザーは、Gemini for Google Cloud API を有効にするだけでなく、次の 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 ブラウザ機能で使用されます。

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

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

Gemini for Google Cloud API
Gemini Code Assist API

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

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

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

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

コンソール

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

[IAM と管理] に移動
[プリンシパル] 列で、Gemini へのアクセスを許可するプリンシパルを見つけて、その行で [プリンシパルを編集] をクリックします。
権限の編集ペインで、[ 別のロールを追加] をクリックします。
[ロールを選択] で、[Gemini for Google Cloud ユーザー] を選択します。
[別のロールを追加] をクリックし、[Service Usage ユーザー] を選択します。
[保存] をクリックします。

gcloud CLI

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

プロジェクト選択メニューで、プロジェクトを選択します。
Gemini for Google Cloud ユーザーロールを付与してください
```
gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/cloudaicompanion.user
```
PRINCIPAL は、プリンシパルの ID に置き換えます。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 の概要をご覧ください。

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

組織のユーザーが、適切な IDE に Gemini Code Assist をインストールします。詳しくは以下をご覧ください。

VS Code: Gemini Code Assist を使用したコード
IntelliJ とその他の JetBrains IDE: Gemini Code Assist を使用したコード

Gemini Code Assist は、デフォルトで次の IDE に含まれています。

Cloud Workstations: Gemini Code Assist を使用したコード
Cloud Shell エディタ: 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 を有効にする必要があります。

次のステップ

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