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 dengan 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 atau reseller resmi Anda.

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 untuk Gemini, lalu pilih project yang terlampir ke akun penagihan Anda dengan 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 sekumpulan 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 Nama.

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 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 project. Penggunaan kuota dan biaya yang terkait dengan permintaan API akan diterapkan pada project ini.
    • BILLING_ACCOUNT_ID: ID untuk akun penagihan yang terkait dengan pool lisensi.
    • ORDER_ID: ID pesanan. Jika Anda 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": "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, maka 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 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 dibatalkan penyediaannya di akhir periode tidak aktif yang ditetapkan oleh administrator.

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

    Buka Admin untuk Gemini

  2. Pilih Kelola Gemini Code Assist, lalu pilih Kelola Langganan.

  3. Pilih Pengelolaan Lisensi, lalu pilih Aktifkan Penetapan Lisensi Otomatis. Dialog Aktifkan lisensi otomatis akan muncul.

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

  4. Tetapkan jangka waktu lisensi akan dihapus jika penerima tidak aktif, lalu pilih Konfirmasi Perubahan. Dialog Penetapan lisensi otomatis telah diaktifkan akan muncul.

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

  5. Pilih Tutup.

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

    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 untuk Gemini.

    Buka Admin untuk Gemini

  2. Pilih Kelola Gemini Code Assist, lalu pilih Kelola Langganan.

  3. Pilih Pengelolaan Lisensi, lalu pilih Kelola Penetapan Lisensi Otomatis. Dialog Kelola penetapan lisensi otomatis 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 sekumpulan 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 Kelola Gemini Code Assist, lalu pilih Ubah Langganan.

  4. Untuk langganan Gemini Code Assist Standard atau Enterprise ini, pastikan Anda menyetel Penetapan Lisensi ke Tetapkan Lisensi Secara Manual. Jika langganan Gemini Code Assist Standard atau Enterprise disetel ke Tetapkan Lisensi Secara Otomatis, maka 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 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 merupakan pengguna berlisensi.

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 akan 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 pada Langkah 2.
    • PROJECT_ID: ID project. Penggunaan kuota dan biaya yang terkait dengan permintaan API akan diterapkan pada project ini.
    • BILLING_ACCOUNT_ID: ID untuk akun penagihan yang terkait dengan pool lisensi.
    • ORDER_ID: ID pesanan. Jika Anda tidak mengetahui ID pesanan, Anda dapat mengambilnya dengan mencantumkan pesanan yang terkait dengan akun penagihan Anda.

Jika berhasil, responsnya akan mirip dengan berikut ini:

{}

Untuk memverifikasi tugas, lihat daftar tugas.

Kemudian, verifikasi bahwa Anda memberikan peran IAM Gemini untuk Google Cloud User dan Service Usage Consumer kepada pengguna kepada pengguna berlisensi.

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 Kelola Gemini Code Assist, lalu pilih Kelola Langganan.

  4. Pilih Pengelolaan Lisensi, lalu pilih Kelola Penetapan Lisensi Otomatis. Dialog Kelola penetapan lisensi otomatis akan muncul.

  5. Pilih pengguna yang ingin Anda batalkan penetapan lisensinya, lalu pilih Batalkan Penetapan Lisensi.

  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 pada Langkah 2.
    • PROJECT_ID: ID project. Penggunaan kuota dan biaya yang terkait dengan permintaan API akan diterapkan pada project ini.
    • BILLING_ACCOUNT_ID: ID untuk akun penagihan yang terkait dengan pool lisensi.
    • ORDER_ID: ID pesanan. Jika Anda tidak mengetahui ID pesanan, Anda dapat mengambilnya dengan mencantumkan pesanan yang terkait dengan akun penagihan Anda.

Jika berhasil, responsnya akan 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 ke 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 dengan pemegang lisensi. Selain itu, penyesuaian atau konfigurasi Gemini Code Assist (seperti kustomisasi kode) dilakukan di project, bukan di tingkat 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, misalnya saat project tertentu memiliki akun penagihan yang berbeda atau saat project yang berbeda dikaitkan dengan pelanggan yang berbeda dengan alat dan masa sewa 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