Mengelola lisensi Gemini Code Assist

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

Secara default, langganan baru mengharuskan Anda menetapkan lisensi secara manual. Setelah menyiapkan produk Gemini untuk Google Cloud tertentu, Anda dapat memilih untuk menetapkan lisensi secara manual atau otomatis.

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 untuk tugas pengelolaan lisensi tertentu yang dijelaskan di bagian berikut.

• Jika Anda ingin mengelola lisensi menggunakan API, bukan konsol Google Cloud, 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 Google Cloud Anda dari Google Cloud CLI
    • x-goog-user-project: project ID project kuota Anda

Mengubah jumlah lisensi Gemini Code Assist dalam langganan

Anda dapat menambahkan atau menghapus jumlah lisensi Gemini untuk Google Cloud langsung melalui konsol Google Cloud, 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 konsol Google Cloud, buka halaman Admin untuk Gemini.

   Buka Admin untuk Gemini

3. Pilih langganan yang ingin diubah, lalu pilih Ubah Langganan.

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

   • Jumlah total lisensi setelah pembelian.
   • Jumlah lisensi yang tersedia untuk ditetapkan setelah pembelian.
   • Harga langganan baru per masa berlaku. Jumlah tambahan untuk lisensi tambahan dihitung secara prorata berdasarkan jumlah waktu yang tersisa dalam periode saat ini.

5. Pilih Simpan.

Melihat penetapan lisensi Gemini Code Assist

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.

   Buka Admin untuk Gemini

3. Pilih langganan yang ingin diubah, lalu pilih Ubah Langganan.

   Informasi berikut tersedia untuk setiap pengguna yang telah diberi lisensi:

   • Nama
   • Email
   • Jenis akun
   • Lisensi ditetapkan

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, gunakan metode billingAccounts.orders.licensePool.enumerateLicensedUsers.

Untuk melakukan tugas ini, Anda harus memiliki izin consumerprocurement.licensePools.enumerateLicensedUsers di akun penagihan yang memiliki langganan.

GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/

Ganti kode berikut:

• BILLING_ACCOUNT_ID: ID akun penagihan
• ORDER_ID: kebijakan IAM

Jika berhasil, perintah ini 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"
      }
  ]
}

Menetapkan lisensi Gemini Code Assist secara manual kepada masing-masing pengguna

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 ini, pastikan Anda menetapkan Penetapan Lisensi ke Tetapkan Lisensi Secara Manual. Jika langganan Gemini Code Assist ditetapkan ke Tetapkan Lisensi Secara Otomatis, Anda tidak dapat mengelola setiap lisensi. 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 Tetapkan Lisensi. Dialog pemilihan pengguna akan muncul. Untuk menelusuri pengguna tertentu, masukkan alamat email mereka, lalu pilih Berikutnya.

6. Pilih Tetapkan Lisensi.

API

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

Untuk melakukan tugas ini, pastikan Anda memiliki izin berikut di akun penagihan yang memiliki langganan:

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

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

Ganti kode berikut:

• BILLING_ACCOUNT_ID: ID akun penagihan
• ORDER_ID: kebijakan IAM

Jika berhasil, perintah ini akan menampilkan isi respons kosong dalam format berikut:

{}

Untuk memverifikasi tugas, lihat daftar tugas.

Menetapkan lisensi Gemini Code Assist secara otomatis

Anda dapat menetapkan lisensi secara otomatis kepada pengguna di organisasi yang memerlukan akses ke Gemini Code Assist dari halaman Penambahan Lisensi. Penetapan lisensi otomatis ditetapkan satu per satu untuk setiap langganan.

Jika memilih untuk otomatis menetapkan lisensi untuk Gemini Code Assist, Anda tidak dapat menghapus atau menambahkan lisensi pengguna individual dalam akun tersebut. Pengguna dengan penetapan lisensi yang belum menggunakan fitur Gemini Code Assist akan otomatis dibatalkan penyediaannya di akhir periode penagihan setelah tidak aktif selama jumlah hari tertentu seperti 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 Enable automatic licenses 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 durasi waktu untuk membatalkan penetapan lisensi jika penerima tidak aktif, lalu pilih Konfirmasi Perubahan. Dialog Penetapan lisensi otomatis telah diaktifkan akan muncul.

5. Pilih Tutup.

Selama lisensi tersedia untuk ditetapkan, pengguna baru akan otomatis menerima lisensi saat pertama kali mengakses Gemini Code Assist yang tercakup dalam langganan Anda di akun penagihan ini.

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.

Membatalkan penetapan lisensi Gemini Code Assist 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 lisensinya ingin Anda batalkan penetapannya, lalu pilih Batalkan Penetapan Lisensi.

6. Pilih Konfirmasi.

API

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

Untuk melakukan tugas ini, Anda harus memiliki izin consumerprocurement.licensePools.unassign di akun penagihan yang memiliki langganan.

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

Ganti kode berikut:

• BILLING_ACCOUNT_ID: ID akun penagihan
• ORDER_ID: kebijakan IAM

Jika berhasil, perintah ini akan menampilkan isi respons kosong dalam format berikut:

{}

Untuk memverifikasi penghapusan tugas, lihat daftar tugas.

Mentransfer lisensi Gemini Code Assist

Lisensi Gemini Code Assist tidak dapat ditransfer secara 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 ditetapkan untuk pengguna perorangan, bukan organisasi atau project, sehingga pengguna perorangan dapat menggunakan Gemini Code Assist di beberapa organisasi.

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

Untuk lebih mencegah penggunaan Gemini Code Assist lintas organisasi dalam project, Anda dapat melakukan salah satu tindakan berikut:

• Nonaktifkan Gemini untuk Google Cloud API dalam project.
• Gunakan izin untuk menolak akses pengguna ke project.

Batasan

• Gemini untuk pengelolaan lisensi Google Cloud tidak mendukung Workforce Identity Federation.