Halaman ini diterjemahkan oleh Cloud Translation API.

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, langganan baru mengharuskan Anda menetapkan lisensi secara manual. Setelah menyiapkan Gemini tertentu untuk produk Google Cloud , 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 di akun penagihan 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: Google Cloud token akses Anda dari Google Cloud CLI
  - x-goog-user-project: project ID project kuota Anda

Mengubah jumlah lisensi Gemini Code Assist Standard dan Enterprise 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:

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
Di konsol Google Cloud, buka halaman Admin untuk Gemini.

Buka Gemini untuk Google Cloud
Pilih langganan yang ingin diubah, lalu pilih Ubah Langganan.
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.
Pilih Simpan.

Melihat penetapan lisensi Gemini Code Assist Standard dan Enterprise

Pilih salah satu opsi berikut:

Konsol

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
Buka halaman Admin untuk Gemini, lalu pilih project yang terlampir ke akun penagihan Anda dengan langganan Gemini Code Assist Standard atau Enterprise.

Buka Gemini untuk Google Cloud
Pilih langganan yang ingin diubah, 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.
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 menurut 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.

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: 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, kode ini akan menampilkan output licensedUsers dalam format berikut:

{}

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

Pilih salah satu opsi berikut:

Konsol

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
Buka halaman Admin untuk Gemini.

Buka Gemini untuk Google Cloud
Pilih Kelola Gemini Code Assist, lalu pilih Ubah Langganan.
Untuk langganan Gemini Code Assist Standard atau Enterprise ini, pastikan Anda menetapkan Pemberian Lisensi ke Tetapkan Lisensi secara Manual. Jika langganan Gemini Code Assist Standard atau Enterprise 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.
Pilih Tetapkan Lisensi. Dialog pemilihan pengguna akan muncul. Untuk menelusuri pengguna tertentu, masukkan alamat emailnya, lalu pilih Berikutnya.
Pilih Tetapkan Lisensi.
Pastikan Anda memberikan peran IAM Pengguna Gemini untuk Google Cloud dan Pengguna Layanan Konsumen kepada pengguna kepada pengguna berlisensi.

API

Untuk menetapkan lisensi Gemini Code Assist Standard dan Enterprise, 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": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Ganti kode berikut:

BILLING_ACCOUNT_ID: ID akun penagihan
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 isi respons kosong dalam format berikut:

{}

Untuk memverifikasi tugas, lihat daftar tugas.

Kemudian, pastikan Anda memberikan peran IAM Pengguna Gemini untuk Google Cloud dan Pengguna Layanan kepada pengguna berlisensi.

Secara otomatis menetapkan lisensi Gemini Code Assist Standard dan Enterprise

Anda dapat menetapkan lisensi secara otomatis kepada pengguna di organisasi yang memerlukan akses ke Gemini Code Assist Standard atau Enterprise dari halaman Penetapan Lisensi. Penetapan lisensi otomatis ditetapkan secara terpisah untuk setiap langganan.

Jika memilih untuk otomatis menetapkan lisensi untuk Gemini Code Assist Standard atau Enterprise, Anda tidak dapat menghapus atau menambahkan lisensi pengguna individu dalam akun tersebut. Pengguna dengan penetapan lisensi yang belum menggunakan fitur Gemini Code Assist Standard atau Enterprise akan otomatis dibatalkan penyediaannya pada akhir periode penagihan setelah tidak aktif selama sejumlah hari yang ditentukan seperti yang ditetapkan oleh administrator.

Di konsol Google Cloud, buka halaman Admin untuk Gemini.

Buka Gemini untuk Google Cloud
Pilih Kelola Gemini Code Assist, lalu pilih Kelola Langganan.
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.
Tetapkan durasi waktu untuk membatalkan penetapan lisensi jika penerima tidak aktif, lalu pilih Konfirmasi Perubahan. Dialog Penetapan lisensi otomatis telah diaktifkan akan muncul.
Pilih Tutup.
Pastikan Anda memberikan peran IAM Pengguna Gemini untuk Google Cloud dan Konsumen Penggunaan Layanan kepada pengguna kepada pengguna berlisensi.

Pengguna dengan izin cloudaicompanion.licenses.selfAssign 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:

Di konsol Google Cloud, buka halaman Admin untuk Gemini.

Buka Gemini untuk Google Cloud
Pilih Kelola Gemini Code Assist, lalu pilih Kelola Langganan.
Pilih Pengelolaan Lisensi, lalu pilih Kelola Penetapan Lisensi Otomatis. Dialog Kelola penetapan lisensi otomatis akan muncul.
Pilih Nonaktifkan pengelolaan lisensi otomatis.
Pilih Konfirmasi perubahan.

Membatalkan penetapan lisensi Gemini Code Assist Standard dan Enterprise secara manual

Pilih salah satu opsi berikut:

Konsol

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
Buka halaman Admin untuk Gemini.

Buka Gemini untuk Google Cloud
Pilih Kelola Gemini Code Assist, lalu pilih Kelola Langganan.
Pilih Pengelolaan Lisensi, lalu pilih Kelola Penetapan Lisensi Otomatis. Dialog Kelola penetapan lisensi otomatis akan muncul.
Pilih pengguna yang lisensinya ingin Anda batalkan penetapannya, lalu pilih Batalkan Penetapan Lisensi.
Pilih Konfirmasi.

API

Untuk membatalkan penetapan lisensi Gemini Code Assist Standard dan Enterprise, 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": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Ganti kode berikut:

BILLING_ACCOUNT_ID: ID akun penagihan
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 isi respons kosong dalam format berikut:

{}

Untuk memverifikasi penghapusan tugas, lihat daftar tugas.

Mentransfer lisensi Gemini Code Assist Standard dan Enterprise

Lisensi Gemini Code Assist Standard dan Enterprise 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 Standard dan Enterprise ditetapkan kepada pengguna perorangan, bukan organisasi atau project, sehingga pengguna perorangan dapat menggunakan Gemini Code Assist Standard dan Enterprise 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 lintas organisasi Gemini Code Assist Standar dan Enterprise dalam project, Anda dapat melakukan salah satu hal berikut:

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

Batasan

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

Langkah berikutnya

Pelajari cara membantu mencegah penggunaan lisensi lintas organisasi.