Mengelola lisensi Gemini Code Assist Standard dan Enterprise

Sebelum menggunakan Gemini Code Assist Standard dan Enterprise, setiap pengguna di organisasi Anda memerlukan lisensi.

Secara default, penetapan lisensi otomatis diaktifkan untuk semua langganan. Pengguna di organisasi Anda yang memiliki izin yang diperlukan akan otomatis diberi lisensi saat mereka mulai menggunakan Gemini Code Assist di IDE yang didukung. Izin tersebut akan dijelaskan lebih lanjut dalam dokumen ini. Setelah menyiapkan produk Gemini for Google Cloud tertentu, Anda dapat memilih untuk menetapkan lisensi secara manual atau melanjutkan dengan penetapan otomatis.

Anda dapat menetapkan lisensi kepada pengguna mana pun yang memiliki akses ke project yang ditautkan ke akun penagihan yang relevan.

Catatan: Anda tidak dapat menetapkan lisensi tempat Gemini Code Assist Standard kepada pengguna yang memiliki langganan Premium Program Developer Google, karena pengguna tersebut sudah memiliki lisensi Gemini Code Assist Standard sebagai bagian dari langganannya sendiri.

Sebelum memulai

• Pastikan Anda memiliki peran IAM Billing Account Administrator (roles/billing.admin) atau Consumer Procurement Order Administrator (roles/consumerprocurement.orderAdmin) sehingga Anda dapat memberikan izin tambahan yang diperlukan di akun penagihan untuk tugas pengelolaan lisensi tertentu yang dijelaskan di bagian berikut.

• Pastikan Anda telah menyiapkan Gemini Code Assist.

• Jika Anda ingin mengelola lisensi menggunakan API, bukan Google Cloud konsol, pastikan hal berikut:

  • Siapkan project kuota untuk akun penagihan Anda.
  • Aktifkan Cloud Commerce Consumer Procurement API di project kuota Anda.
  • Pastikan pasangan nilai kunci header berikut ada di semua panggilan API:
    • Authorization: token akses Anda dari Google Cloud CLIGoogle Cloud
    • x-goog-user-project: Project ID project kuota Anda

Mengubah jumlah lisensi Gemini Code Assist Standard dan Enterprise dalam langganan

Anda dapat menambah atau menghapus jumlah lisensi Gemini for Google Cloud langsung melalui Google Cloud konsol, atau melalui perwakilan akun Google Anda atau reseller resmi.

Untuk mengubah jumlah lisensi dalam langganan, ikuti langkah-langkah berikut:

1. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut di akun penagihan yang memiliki langganan:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.orders.modify
   • resourcemanager.projects.get

2. Di Google Cloud konsol, buka halaman Admin for Gemini.

   Buka Gemini for Google Cloud

3. Pilih langganan yang ingin Anda ubah, lalu pilih Modify Subscription. Perhatikan bahwa jika Anda berada dalam periode uji coba aktif, tombol ini akan ditampilkan sebagai Disable Auto-renew.

4. Masukkan jumlah lisensi yang ingin Anda miliki. Informasi berikut akan ditampilkan:

   • Jumlah total lisensi setelah pembelian.
   • Jumlah lisensi yang tersedia untuk penetapan setelah pembelian.
   • Harga langganan baru per jangka waktu. Jumlah tambahan untuk lisensi yang ditambahkan akan dihitung secara prorata berdasarkan sisa waktu dalam jangka waktu saat ini.

5. Pilih Save.

Melihat penetapan lisensi Gemini Code Assist Standard dan Enterprise

Pilih salah satu opsi berikut:

Konsol

1. Pastikan Anda memiliki izin IAM berikut di akun penagihan yang memiliki langganan:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • resourcemanager.projects.get

2. Buka halaman Admin for Gemini dan pilih project yang dilampirkan ke akun penagihan Anda dengan langganan Gemini Code Assist Standard atau Enterprise.

   Buka Gemini for Google Cloud

3. Pilih langganan yang ingin Anda ubah, lalu pilih Modify Subscription.

   Informasi berikut tersedia untuk setiap pengguna yang telah diberi lisensi:

   • Nama.
   • Email.
   • Tanggal lisensi ditetapkan.
   • Tanggal dan waktu lisensi terakhir digunakan.

4. Untuk menemukan kumpulan pengguna tertentu, Anda dapat memfilter dan mengurutkan daftar sebagai berikut:

   • Untuk memfilter daftar, di kolom Filter , masukkan properti dan nilai.
   • Untuk mengurutkan daftar, pilih judul kolom yang ingin Anda urutkan. Misalnya, untuk mengurutkan nama pengguna menurut abjad, pilih judul kolom Name.

API

Untuk melihat penetapan lisensi Gemini Code Assist Standard atau Enterprise, gunakan billingAccounts.orders.licensePool.enumerateLicensedUsers metode.

1. Pastikan Anda memiliki izin IAM consumerprocurement.licensePools.enumerateLicensedUsers di akun penagihan yang berisi gabungan lisensi yang penetapan lisensinya ingin Anda lihat.

2. Gunakan cURL untuk memanggil metode:

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/"
   

   Ganti kode berikut:

   • PROJECT_ID: ID untuk project. Penggunaan kuota dan biaya yang terkait dengan permintaan API diterapkan pada project ini.
   • BILLING_ACCOUNT_ID: ID untuk akun penagihan yang terkait dengan gabungan lisensi.
   • ORDER_ID: ID pesanan. Jika tidak mengetahui ID pesanan, Anda dapat mengambilnya dengan mencantumkan pesanan yang terkait dengan akun penagihan Anda.

Jika berhasil, perintah akan menampilkan output licensedUsers dalam format berikut:

{
  "licensedUsers": [
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

Jika tidak ada penetapan lisensi Gemini Code Assist Standard atau Enterprise atau ORDER_ID tidak valid, perintah akan menampilkan output licensedUsers dalam format berikut:

{}

Menetapkan lisensi Gemini Code Assist Standard dan Enterprise secara otomatis

Anda dapat mengaktifkan penetapan lisensi otomatis untuk langganan.

Penetapan lisensi otomatis hanya didukung di VS Code, IntelliJ, dan IDE JetBrains lain yang didukung.

Jika memilih untuk otomatis menetapkan lisensi Gemini Code Assist Standard atau Enterprise, Anda tidak dapat menghapus atau menambahkan lisensi pengguna individu di akun tersebut. Pengguna yang memiliki penetapan lisensi dan belum menggunakan fitur Gemini Code Assist Standard atau Enterprise akan otomatis dihentikan penyediaannya pada akhir periode tidak aktif yang ditetapkan oleh administrator.

1. Di Google Cloud konsol, buka halaman Admin for Gemini.

   Buka Gemini for Google Cloud

2. Pilih Manage Gemini Code Assist, lalu pilih Manage Subscription.

3. Pilih License Management, lalu pilih Enable Automatic License Assignment. Dialog Enable automatic licenses akan muncul.

   Mengalihkan langganan ini untuk otomatis menetapkan lisensi akan menonaktifkan penetapan lisensi manual setelah perubahan, tetapi penetapan lisensi yang sudah ada tidak akan terpengaruh.

4. Tetapkan jangka waktu lisensi akan dibatalkan penetapannya jika penerima tidak aktif, lalu pilih Confirm Change. Dialog Automatic license assignment has been enabled akan muncul.

   Jika Anda mengonfigurasi T hari tidak aktif untuk pembatalan penetapan, maka lisensi akan otomatis dibatalkan penetapannya dan tersedia di gabungan lisensi pada hari T+1. Misalnya, jika Anda mengonfigurasi 7 hari tidak aktif untuk pembatalan penetapan, lisensi akan dibatalkan penetapannya dan tersedia di gabungan lisensi pada hari 8.

5. Pilih Close.

6. Pastikan Anda memberikan peran IAM Gemini for Google Cloud User dan Service Usage Consumer kepada pengguna yang diberi lisensi.

   Pengguna dengan izin cloudaicompanion.licenses.selfAssign akan otomatis menerima lisensi saat pertama kali mengakses Gemini Code Assist Standard atau Enterprise di project yang dibayar oleh akun penagihan yang memiliki langganan valid yang dikonfigurasi untuk penetapan lisensi otomatis dan memiliki lisensi yang tersedia yang tercakup oleh langganan Anda di akun penagihan.

Untuk menonaktifkan penetapan lisensi otomatis, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Admin for Gemini.

   Buka Gemini for Google Cloud

2. Pilih Manage Gemini Code Assist, lalu pilih Manage Subscription.

3. Pilih License Management, lalu pilih Manage Automatic License Assignment. Dialog Manage automatic license assignment akan muncul.

4. Pilih Disable automatic license management.

5. Pilih Confirm change.

Menetapkan lisensi Gemini Code Assist Standard dan Enterprise secara manual kepada pengguna individu

Dengan penetapan lisensi manual, Anda dapat menambahkan dan menghapus lisensi untuk pengguna individu. Metode ini memberi Anda kontrol langsung atas siapa yang dapat mengakses Gemini Code Assist, yang ideal untuk memberikan akses kepada kumpulan pengguna tertentu.

Pilih salah satu opsi berikut:

Konsol

1. Pastikan Anda memiliki izin IAM berikut di akun penagihan yang memiliki langganan:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.assign
   • resourcemanager.projects.get

2. Buka halaman Admin for Gemini.

   Buka Gemini for Google Cloud

3. Pilih Manage Gemini Code Assist, lalu pilih Modify Subscription.

4. Untuk langganan Gemini Code Assist Standard atau Enterprise ini, pastikan Anda menetapkan License Assignment ke Manually Assign Licenses. Jika langganan Gemini Code Assist Standard atau Enterprise ditetapkan ke Automatically Assign Licenses, maka Anda tidak dapat mengelola lisensi individu. Mengalihkan akun penagihan ini ke Manually Assign Licenses akan menonaktifkan penetapan lisensi otomatis setelah perubahan, tetapi penetapan lisensi yang sudah ada tidak akan terpengaruh.

5. Pilih Add licensed user. Dialog pemilihan pengguna akan muncul. Hanya alamat email Akun Google individu yang didukung, seperti domain @gmail.com, @googlegroups.com, dan Google Workspace. Workforce Identity Federation (BYOID) tidak didukung.

6. Pilih Add licensed user.

7. Pastikan Anda memberikan peran IAM Gemini for Google Cloud User dan Service Usage Consumer kepada pengguna yang diberi lisensi.

API

Untuk menetapkan lisensi Gemini Code Assist Standard dan Enterprise, gunakan metode billingAccounts.orders.licensePool.assign.

1. Pastikan Anda memiliki izin IAM berikut di akun penagihan yang berisi gabungan lisensi yang lisensinya ingin Anda tetapkan:

• billing.accounts.get
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.unassign
• consumerprocurement.orders.get

1. Buat file JSON yang berisi informasi berikut:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Ganti USER_EMAILS dengan daftar yang dipisahkan koma berisi akun pengguna yang diberi lisensi—misalnya, "[e-mail]", "[e-mail]". Hanya alamat email Akun Google individu yang didukung, seperti domain @gmail.com, @googlegroups.com, dan Google Workspace. Workforce Identity Federation (BYOID) tidak didukung.

2. Gunakan cURL untuk memanggil metode:

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

   Ganti kode berikut:

   • JSON_FILE_NAME: jalur untuk file JSON yang Anda buat pada Langkah 2.
   • PROJECT_ID: ID untuk project. Penggunaan kuota dan biaya yang terkait dengan permintaan API diterapkan pada project ini.
   • BILLING_ACCOUNT_ID: ID untuk akun penagihan yang terkait dengan gabungan lisensi.
   • ORDER_ID: ID pesanan. Jika tidak mengetahui ID pesanan, Anda dapat mengambilnya dengan mencantumkan pesanan yang terkait dengan akun penagihan Anda.

Jika berhasil, responsnya akan terlihat mirip dengan contoh berikut:

{}

Untuk memverifikasi penetapan, lihat daftar penetapan.

Kemudian, pastikan Anda memberikan peran IAM Gemini for Google Cloud User dan Service Usage Consumer kepada pengguna yang diberi lisensi.

Membatalkan penetapan lisensi Gemini Code Assist Standard dan Enterprise secara manual

Pilih salah satu opsi berikut:

Konsol

1. Pastikan Anda memiliki izin IAM berikut di akun penagihan yang memiliki langganan:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.unassign
   • resourcemanager.projects.get

2. Buka halaman Admin for Gemini.

   Buka Gemini for Google Cloud

3. Pilih Manage Gemini Code Assist, lalu pilih Manage Subscription.

4. Pilih License Management, lalu pilih Manage Automatic License Assignment. Dialog Manage automatic license assignment akan muncul.

5. Pilih pengguna yang lisensinya ingin Anda batalkan penetapannya, lalu pilih Unassign License.

6. Pilih Confirm.

API

Untuk membatalkan penetapan lisensi Gemini Code Assist Standard dan Enterprise, gunakan metode billingAccounts.orders.licensePool.unassign.

1. Untuk melakukan tugas ini, Anda harus memiliki izin Identity and Access Management (IAM) consumerprocurement.licensePools.unassign di akun penagihan yang berisi gabungan lisensi yang lisensinya ingin Anda batalkan penetapannya.

2. Buat file JSON yang berisi informasi berikut:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Ganti USER_EMAILS dengan daftar yang dipisahkan koma berisi akun pengguna yang diberi lisensi—misalnya, "[e-mail]", "[e-mail]".

3. Gunakan cURL untuk memanggil metode:

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/"

   Ganti kode berikut:

   • JSON_FILE_NAME: jalur untuk file JSON yang Anda buat pada Langkah 2.
   • PROJECT_ID: ID untuk project. Penggunaan kuota dan biaya yang terkait dengan permintaan API diterapkan pada project ini.
   • BILLING_ACCOUNT_ID: ID untuk akun penagihan yang terkait dengan gabungan lisensi.
   • ORDER_ID: ID pesanan. Jika tidak mengetahui ID pesanan, Anda dapat mengambilnya dengan mencantumkan pesanan yang terkait dengan akun penagihan Anda.

Jika berhasil, responsnya akan terlihat mirip dengan contoh berikut:

{}

Untuk memverifikasi pembatalan penetapan, lihat daftar penetapan.

Mentransfer lisensi Gemini Code Assist Standard dan Enterprise

Lisensi Gemini Code Assist Standard dan Enterprise tidak dapat ditransfer langsung antar-pengguna. Sebagai gantinya, batalkan penetapan lisensi dari pengguna, lalu tetapkan lisensi kepada pengguna baru.

Mencegah penggunaan lisensi lintas organisasi

Lisensi Gemini Code Assist Standard dan Enterprise ditetapkan kepada pengguna individu, bukan organisasi atau project, sehingga pengguna individu dapat menggunakan Gemini Code Assist Standard dan Enterprise di beberapa organisasi.

Log yang dihasilkan dari penggunaan Gemini Code Assist berada di project tempat penggunaan terjadi, bukan di pemegang lisensi. Selain itu, penyesuaian atau konfigurasi Gemini Code Assist (seperti penyesuaian kode) dilakukan di project, bukan di tingkat lisensi atau langganan.

Untuk lebih mencegah penggunaan Gemini Code Assist Standard dan Enterprise lintas organisasi di sebuah project, Anda dapat melakukan salah satu hal berikut:

• Menonaktifkan Gemini for Google Cloud API di project.
• Menggunakan izin untuk menolak akses pengguna ke project.

Batasan

• Pengelolaan lisensi Gemini for Google Cloud tidak mendukung Workforce Identity Federation.

Langkah berikutnya

• Pelajari cara membantu mencegah penggunaan lisensi lintas organisasi.