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 secara mendetail nanti dalam dokumen ini. Setelah menyiapkan Gemini Code Assist, 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.

Sebelum memulai

Mengubah jumlah lisensi Gemini Code Assist Standard dan Enterprise dalam langganan

Anda dapat menambahkan atau menghapus jumlah lisensi Gemini Code Assist langsung melalui konsol Google Cloud , atau melalui account representative Google Anda atau reseller resmi.

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 terkait dengan akun penagihan Anda yang memiliki langganan Gemini Code Assist Standard atau Enterprise.

    Buka Admin untuk Gemini

  3. Pilih langganan yang ingin Anda ubah, lalu pilih Ubah Langganan.

    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 sesuai abjad berdasarkan nama pengguna, pilih judul kolom Name.

API

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

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

  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 terhadap project ini.
    • BILLING_ACCOUNT_ID: ID untuk akun penagihan yang terkait dengan kumpulan 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 ini akan menampilkan output licensedUsers dalam format berikut:

{
  "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"
      }
  ]
}

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

{}

Menetapkan lisensi Gemini Code Assist Standard dan Enterprise secara otomatis

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

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

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

    Buka Admin untuk Gemini

  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.

    Jika langganan ini dialihkan untuk menetapkan lisensi secara otomatis, penetapan lisensi manual akan dinonaktifkan setelah perubahan, tetapi penetapan lisensi yang sudah ada tidak akan terpengaruh.

  4. Tetapkan durasi waktu untuk membatalkan penetapan lisensi jika penerima lisensi tidak aktif, lalu pilih Confirm Change. Dialog Automatic license assignment has been enabled akan muncul.

    Jika Anda mengonfigurasi T hari tidak aktif untuk pencabutan, lisensi akan otomatis dicabut dan tersedia di kumpulan lisensi pada hari ke-T+1. Misalnya, jika Anda mengonfigurasi 7 hari tidak aktif untuk pencabutan, lisensi akan dicabut dan tersedia di kumpulan lisensi pada hari ke-8.

  5. Pilih Tutup.

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

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

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

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

    Buka Admin untuk Gemini

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

  3. Pilih Pengelolaan Lisensi, lalu pilih Kelola Penetapan Lisensi Otomatis. Dialog Manage automatic license assignment akan muncul.

  4. Pilih Nonaktifkan pengelolaan lisensi otomatis.

  5. Pilih Konfirmasi perubahan.

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

Dengan penetapan lisensi manual, Anda dapat menambahkan dan menghapus lisensi untuk masing-masing pengguna. Metode ini memberi Anda kontrol langsung atas siapa yang dapat mengakses Gemini Code Assist, yang ideal untuk memberikan akses kepada sekelompok 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 untuk Gemini.

    Buka Admin untuk Gemini

  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, Anda tidak dapat mengelola lisensi individual. Mengalihkan akun penagihan ini ke Tetapkan Lisensi Secara Manual akan menonaktifkan penetapan lisensi otomatis setelah perubahan, tetapi penetapan lisensi yang sudah ada tidak akan terpengaruh.

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

  6. Pilih Tambahkan pengguna berlisensi.

  7. Pastikan Anda memberikan peran IAM Gemini untuk Google Cloud User dan Service Usage Consumer kepada pengguna yang memiliki 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 kumpulan 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 akun pengguna yang dipisahkan koma yang diberi lisensi—misalnya, "dana@example.com", "lee@example.com". Hanya alamat email Akun Google perorangan yang didukung, seperti @gmail.com, @googlegroups.com, dan domain 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 di 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 kumpulan 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 berikut ini:

{}

Untuk memverifikasi penetapan, lihat daftar penetapan.

Kemudian, pastikan Anda memberikan peran IAM Gemini untuk Google Cloud User dan Service Usage Consumer kepada pengguna yang memiliki 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 untuk Gemini.

    Buka Admin untuk Gemini

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

  4. Pilih Pengelolaan Lisensi, lalu pilih Kelola Pemberian Lisensi Otomatis. Dialog Manage automatic license assignment akan muncul.

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

  6. Pilih Konfirmasi.

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 kumpulan lisensi yang lisensinya ingin Anda batalkan penetapannya.

  2. Buat file JSON yang berisi informasi berikut:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Ganti USER_EMAILS dengan daftar akun pengguna yang dipisahkan koma yang diberi lisensi—misalnya, "dana@example.com", "lee@example.com".

  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 di 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 kumpulan 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 berikut ini:

{}

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 diberikan kepada pengguna individu, bukan organisasi atau project, sehingga pengguna individu dapat menggunakan Gemini Code Assist Standard dan Enterprise di beberapa organisasi.

Setiap log yang dihasilkan dari penggunaan Gemini Code Assist disimpan dalam project tempat penggunaan terjadi, bukan pada penerima lisensi. Selain itu, penyesuaian atau konfigurasi Gemini Code Assist (seperti penyesuaian kode) dilakukan pada project, bukan pada level lisensi atau langganan.

Beberapa organisasi besar mungkin ingin mencegah developer di organisasi mereka menggunakan Gemini Code Assist Standard atau Enterprise di project tertentu dalam organisasi mereka, seperti saat project tertentu memiliki akun penagihan yang berbeda atau saat project yang berbeda dikaitkan dengan pelanggan yang berbeda dengan tenancy dan alat yang berbeda.

Dalam kasus ini, untuk membantu mencegah penggunaan Gemini Code Assist Standard dan Enterprise lintas organisasi di sebuah project, Anda dapat melakukan salah satu hal berikut:

Batasan