Halaman ini menjelaskan cara mendapatkan langganan untuk Gemini Enterprise dan cara mengelola lisensi pengguna.
Untuk menyiapkan akses, Anda biasanya menyelesaikan tahap-tahap berikut:
- Procure: Membeli langganan ke edisi produk untuk akun penagihan Anda.
- Distribusikan: Alokasikan lisensi dari langganan ke project dan lokasi tertentu.
- Tetapkan: Tetapkan lisensi yang didistribusikan kepada masing-masing pengguna.
Tentang lisensi
Untuk login ke aplikasi Gemini Enterprise, pengguna harus memiliki lisensi. Anda dapat menetapkan lisensi kepada pengguna secara manual atau otomatis.
Lisensi yang ditetapkan secara manual: Anda dapat menambahkan pengguna berdasarkan alamat email mereka.
Lisensi yang ditetapkan secara otomatis: Anda dapat mengonfigurasi langganan agar Gemini Enterprise otomatis menetapkan lisensi kepada pengguna saat pertama kali mereka mengakses Gemini Enterprise atau antarmuka Gemini Notebook untuk bisnis.
Tentang langganan
Untuk mendapatkan lisensi, Anda harus memiliki langganan ke edisi Gemini Enterprise terlebih dahulu. Langganan bersifat khusus untuk akun penagihan. Untuk mengetahui informasi tentang edisi yang tersedia, lihat Membandingkan edisi Gemini Enterprise.
Untuk Gemini Enterprise, Anda dapat membeli langganan bulanan atau langganan tahunan. Anda dapat menyetel langganan ini agar diperpanjang secara otomatis.
Anda dapat membeli langganan untuk edisi Gemini Enterprise Standard, Gemini Enterprise Plus, dan Gemini Enterprise bayar sesuai penggunaan menggunakan konsolGoogle Cloud .
Batas jumlah slot langganan
Saat Anda membeli atau mengubah langganan berbasis slot langsung melalui konsolGoogle Cloud , konsol akan menerapkan batas jumlah slot otomatis. Jumlah maksimum slot bergantung pada akun Penagihan Cloud Anda.
Jika organisasi Anda memerlukan lebih banyak slot atau jika Anda mengalami error batas slot maksimum saat mencoba menambahkan lisensi ke langganan yang ada, hubungi perwakilan penjualan atau Account Manager Anda Google Cloud untuk membeli lisensi tambahan melalui pesanan offline atau meminta pengecualian daftar yang diizinkan.
Tentang status langganan
Langganan dapat berada dalam salah satu status berikut:
| Negara bagian/Provinsi | Deskripsi |
|---|---|
| Belum dimulai | Anda telah membeli langganan, tetapi belum aktif. Anda dapat mendistribusikan lisensi dari langganan ini ke project, tetapi jika Anda menetapkan lisensi ini kepada pengguna, mereka tidak dapat mengakses Gemini Enterprise hingga langganan menjadi aktif. Untuk mengetahui informasi selengkapnya, lihat Mendistribusikan lisensi. |
| Aktif | Langganan aktif, dan pengguna yang memiliki lisensi dalam langganan ini dapat mengakses Gemini Enterprise. |
| Menonaktifkan | Langganan sedang dinonaktifkan, dan lisensinya akan berakhir lebih awal. Pengguna dengan lisensi dalam langganan ini akan terus mengakses Gemini Enterprise selama masa tenggang satu minggu. Setelah minggu ini, lisensi akan beralih ke status Berakhir. Untuk mengetahui informasi selengkapnya, lihat Menangani penghentian awal. |
| Telah Berakhir | Pengguna dengan lisensi dalam langganan ini akan kehilangan akses ke Gemini Enterprise saat masa langganan berakhir atau saat lisensi beralih dari status dinonaktifkan ke status habis masa berlaku setelah langganan berakhir lebih awal. |
Sebelum memulai
Sebelum memulai prosedur di halaman ini, selesaikan prasyarat berikut:
Selesaikan semua tugas yang diuraikan dalam Menyiapkan Gemini Enterprise. Hal ini mencakup:
- Menyiapkan akun penagihan untuk project Anda.
- Memberikan setidaknya peran Gemini Enterprise User kepada pengguna mana pun yang akan Anda beri lisensi untuk menggunakan Gemini Enterprise.
Pastikan penagihan diaktifkan untuk project Google Cloud Anda. Untuk mengetahui informasi selengkapnya, lihat Memastikan penagihan diaktifkan untuk project Google Cloud Anda.
Pastikan Anda memiliki peran dan izin IAM yang diperlukan:
Peran Gemini Enterprise Admin pada project.
Jika Anda mengelola penagihan untuk organisasi, Anda harus memiliki peran berikut untuk membeli dan mengelola langganan Gemini Enterprise dan pesanan pengadaan:
Di akun Penagihan Cloud yang Anda gunakan untuk langganan, salah satu dari berikut ini:
- Peran Billing Account Administrator
(
roles/billing.admin). - Peran Consumer Procurement Order Administrator
(
roles/consumerprocurement.orderAdmin) dan peran Billing Account Viewer (roles/billing.viewer).
- Peran Billing Account Administrator
(
Di project, peran Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer).
Atau, untuk mengontrol izin IAM secara terperinci, Anda dapat menggunakan peran khusus dengan izin berikut, bukan peran Billing Account Administrator. Berikan izin pada resource yang tercantum dalam tabel.
Resource Layanan Izin akun Penagihan Cloud Penagihan Cloud billing.billingAccountPrices.listakun Penagihan Cloud Pengadaan Konsumen consumerprocurement.orders.get
consumerprocurement.orders.place
consumerprocurement.licensePools.assign
consumerprocurement.licensePools.unassign
consumerprocurement.licensePools.enumerateLicensedUsersakun Penagihan Cloud Discovery Engine discoveryengine.billingAccountLicenseConfigs.distribute
discoveryengine.billingAccountLicenseConfigs.get
discoveryengine.billingAccountLicenseConfigs.list
discoveryengine.billingAccountLicenseConfigs.retractProject Discovery Engine discoveryengine.licenseConfigs.create
discoveryengine.licenseConfigs.get
discoveryengine.licenseConfigs.list
discoveryengine.licenseConfigs.update
discoveryengine.projects.get
discoveryengine.projects.provision
discoveryengine.projects.reportConsentChange
discoveryengine.userStores.batchUpdateUserLicenses
discoveryengine.userStores.listUserLicensesProject Resource Manager resourcemanager.projects.get
resourcemanager.projects.listProject Service Usage serviceusage.services.get
serviceusage.services.list
Mendapatkan langganan
Untuk mendapatkan lisensi, beli langganan edisi Gemini Enterprise untuk akun penagihan Anda. Langganan menyediakan kumpulan lisensi yang Anda distribusikan ke project dan tetapkan kepada pengguna. Anda dapat mendistribusikan lisensi dari langganan berbasis lisensi, seperti Gemini Enterprise Standard atau Plus, ke project yang ditautkan ke akun penagihan mana pun. Anda hanya dapat mendistribusikan lisensi dari langganan Bayar sesuai penggunaan ke project yang ditautkan ke akun penagihan yang memiliki langganan tersebut.
Standard dan Plus
Untuk berlangganan Gemini Enterprise edisi Standard atau Plus, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise > Plans & billing.
Dari drop-down Akun penagihan yang dipilih, pilih akun penagihan Anda.
Klik Create Subscription.
Untuk edisi Gemini Enterprise Standard atau Gemini Enterprise Plus, klik Berlangganan.
Konfigurasikan Detail penagihan:
- Konfirmasi atau pilih akun penagihan dari menu drop-down.
- Masukkan Subscription name.
- Masukkan Jumlah lisensi yang Anda perlukan untuk edisi tersebut.
Pilih Periode langganan.
Jika Anda ingin langganan diperpanjang secara otomatis, centang kotak Auto renew subscription.
Konfigurasikan Distribution details:
- Di kolom Project, masukkan project ID, lalu pilih project dari opsi pencocokan. Jika konsol meminta Anda, aktifkan API yang diperlukan.
- Pilih Location untuk langganan Anda. Jika Anda tidak memiliki alasan kepatuhan atau peraturan untuk menempatkan data di multi-region AS atau Uni Eropa, Google merekomendasikan Anda memilih multi-region global untuk ketersediaan maksimum dan latensi rendah.
Klik Create > Confirm.
Bayar sesuai penggunaan
Dengan langganan Bayar sesuai penggunaan, Anda membayar setiap bulan untuk layanan yang Anda gunakan. Untuk mengetahui informasi selengkapnya, lihat Kuota dan harga untuk edisi bayar sesuai penggunaan. Anda dapat menggunakan langganan dengan project apa pun yang terhubung ke akun penagihan Anda.
Untuk berlangganan Gemini Enterprise edisi Bayar sesuai penggunaan, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise > Plans & billing.
Dari drop-down Akun penagihan yang dipilih, pilih akun penagihan Anda.
Klik Create Subscription.
Untuk edisi Gemini Enterprise bayar sesuai penggunaan, klik Create plan.
Konfigurasikan Detail penagihan:
- Konfirmasi atau pilih akun penagihan dari menu drop-down.
- Masukkan Subscription name.
- Masukkan Jumlah lisensi Bayar sesuai penggunaan yang Anda perlukan untuk edisi tersebut.
Konfigurasikan Distribution details:
- Di kolom Project, masukkan project ID, lalu pilih project dari opsi pencocokan. Jika konsol meminta Anda, aktifkan API yang diperlukan.
- Pilih Location untuk langganan Anda. Jika Anda tidak memiliki alasan kepatuhan atau peraturan untuk menempatkan data di multi-region AS atau Uni Eropa, Google merekomendasikan Anda memilih multi-region global untuk ketersediaan maksimum dan latensi rendah.
Klik Create > Confirm.
Jika project Anda ditautkan ke akun Penagihan Cloud layanan mandiri (online), jendela Beli kredit akan terbuka. Pilih jumlah dan metode pembayaran, lalu selesaikan pembelian. Jika ingin, siapkan isi ulang otomatis.
Jika Anda belum menyiapkan kredit prabayar di akun penagihan, Anda harus membeli kredit. Jika Anda membatalkan, Anda tidak akan membuat langganan, dan Google tidak akan menagih Anda. Untuk mengetahui informasi selengkapnya, lihat Mengelola kredit prabayar.
Kelola langganan
Bagian ini menjelaskan cara melihat, memperbarui, mendistribusikan, dan mengklaim kembali langganan Gemini Enterprise.
Lihat detail langganan
Untuk melihat detail langganan Gemini Enterprise Anda, lakukan hal berikut:
Konsol
Di konsol Google Cloud , buka halaman Gemini Enterprise > Plans & billing.
Dari drop-down Akun penagihan yang dipilih, pilih akun penagihan Anda.
Di tabel Langganan Gemini, klik nama langganan Anda untuk membuka halaman Detail langganan.
REST
Untuk mendapatkan detail langganan, jalankan perintah berikut:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_NUMBER" \ "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"
Ganti kode berikut:
PROJECT_NUMBER: nomor atau ID project yang Anda gunakan untuk mengatribusikan penagihan dan kuota untuk panggilan API ini. Anda harus memiliki peran Service Usage Consumer di project ini.BILLING_ACCOUNT_ID: ID akun penagihan Google Cloud Anda.
Contoh output
{
"billingAccountLicenseConfigs": [{
"name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
"licenseCount": "2",
"licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
},
"subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
"subscriptionTier": "SUBSCRIPTION_TIER",
"subscriptionTerm": "SUBSCRIPTION_TERM",
"startDate": ...,
"endDate": ...,
"state": "ACTIVE",
"procurementEntitlementId": "...",
"subscriptionDisplayName": "...",
"geminiBundle": true
}]
}
Memperbarui setelan langganan
Setelah membuat langganan, Anda dapat memperbarui setelan, seperti jumlah lisensi atau setelan perpanjangan otomatis.
Metode untuk menambahkan lebih banyak lisensi bergantung pada cara Anda membeli langganan:
- Jika Anda membeli langganan melalui konsol Google Cloud , tambahkan lebih banyak lisensi langsung dalam konsol Google Cloud menggunakan langkah-langkah di bagian ini.
- Jika Anda membeli menggunakan formulir pesanan offline, Anda harus memperbarui formulir pesanan dengan jumlah lisensi baru. Hubungi Account Manager Google Anda untuk memperbarui formulir pesanan.
Untuk memperbarui jumlah lisensi atau setelan perpanjangan jika Anda membeli langganan melalui konsol Google Cloud , lakukan hal berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise > Plans & billing.
Dari drop-down Akun penagihan yang dipilih, pilih akun penagihan Anda.
Di tabel Langganan Gemini, klik nama langganan Anda untuk membuka halaman Detail langganan.
Di halaman Subscription detail, klik Edit.
Di panel Edit Langganan, masukkan nilai baru di kolom Jumlah lisensi, atau pilih atau hapus centang pada kotak Perpanjangan otomatis.
Klik Kirim.
Membatalkan langganan
Untuk membatalkan langganan Gemini Enterprise, Anda harus menonaktifkan perpanjangan otomatis. Langganan Anda akan tetap aktif hingga masa langganan berakhir, dan Google mungkin akan menagih Anda hingga tanggal tersebut. Untuk mengetahui informasi selengkapnya tentang langganan Anda, lihat Melihat detail langganan.
Untuk membatalkan langganan, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise > Plans & billing.
Dari drop-down Akun penagihan yang dipilih, pilih akun penagihan Anda.
Di tabel Langganan Gemini, klik nama langganan Anda untuk membuka halaman Detail langganan.
Di halaman Subscription detail, klik Edit.
Di panel Edit Subscription, hapus centang pada kotak Auto renewal.
Klik Kirim.
Mendistribusikan lisensi
Jika Anda belum mendistribusikan lisensi berlangganan ke project, yang mungkin terjadi saat Anda membeli langganan secara offline atau saat upaya sebelumnya untuk mendistribusikan lisensi gagal, lakukan hal berikut:
Konsol
Di konsol Google Cloud , buka halaman Gemini Enterprise > Plans & billing.
Dari drop-down Akun penagihan yang dipilih, pilih akun penagihan Anda.
Di tabel Langganan Gemini, klik nama langganan Anda untuk membuka halaman Detail langganan.
Di halaman Subscription detail, klik Distribute Licenses.
Panel Distribute Licenses akan terbuka, menampilkan alokasi lisensi project yang ada beserta jumlah Available licenses dan Total licenses.
Untuk mendistribusikan lisensi ke project:
- Di kolom Select a project, masukkan project ID, lalu pilih project dari opsi pencocokan.
- Jika dialog meminta Anda untuk mengaktifkan Discovery Engine API untuk project yang dipilih, klik untuk mengaktifkannya.
- Dari drop-down Region, pilih region.
- Di kolom License Count, masukkan jumlah lisensi yang akan dialokasikan.
- Opsional: Untuk mengalokasikan lisensi ke project atau region tambahan, klik Add license distribution, lalu ulangi langkah-langkah ini.
Klik Kirim.
Dalam dialog Konfirmasi Distribusi Lisensi, klik Kirim.
REST
Untuk mendistribusikan lisensi ke satu atau beberapa project, jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
"projectNumber": "TARGET_PROJECT_NUMBER",
"location": "LOCATION",
"licenseCount": LICENSE_COUNT,
"licenseConfigId": "LICENSE_CONFIG_ID"
}' \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"
Ganti kode berikut:
PROJECT_NUMBER: nomor atau ID project yang Anda gunakan untuk mengatribusikan penagihan dan kuota untuk panggilan API ini. Anda harus memiliki peran Service Usage Consumer di project ini. Anda dapat menggunakanTARGET_PROJECT_NUMBERjika Anda mengaktifkan Discovery Engine di project tersebut.ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
LOCATION: multi-region penyimpanan data Anda:global,us, ataueu.TARGET_PROJECT_NUMBER: nomor project yang ingin Anda distribusikan lisensinya.LICENSE_COUNT: jumlah lisensi yang akan didistribusikan.BILLING_ACCOUNT_ID: ID akun penagihan Google Cloud Anda.BILLING_ACCOUNT_LICENSE_CONFIG_ID: temukan ID Konfigurasi Lisensi Akun Penagihan dalam detail langganan.Opsional
LICENSE_CONFIG_ID: ID konfigurasi lisensi level project yang ada. Anda dapat menemukan ID ini di kolomlicenseConfigDistributionssaat melihat detail langganan.
Mengklaim kembali lisensi yang tidak ditetapkan dalam langganan
Bagian ini menjelaskan cara mengklaim kembali lisensi yang belum ditetapkan dari sebuah project, sehingga lisensi tersebut tersedia di akun penagihan untuk didistribusikan ulang ke project lain.
Konsol
Di konsol Google Cloud , buka halaman Gemini Enterprise > Plans & billing.
Dari drop-down Akun penagihan yang dipilih, pilih akun penagihan Anda.
Di tabel Langganan Gemini, klik nama langganan Anda untuk membuka halaman Detail langganan.
Di halaman Subscription detail, klik Distribute Licenses.
Dalam daftar alokasi, temukan baris untuk project dan region yang ingin Anda klaim kembali lisensinya.
Pilih salah satu tindakan berikut:
- Untuk mengurangi jumlah lisensi, kurangi jumlah di kolom License Count.
- Untuk mengklaim kembali semua lisensi dari baris, gerakkan kursor ke baris, lalu klik Hapus item.
Klik Kirim.
Dalam dialog Confirm License Distribution, tinjau peringatan bahwa pencabutan lisensi dibatasi sekali per hari, lalu klik Submit.
REST
Untuk mentransfer kembali lisensi langganan ke akun penagihan guna mendistribusikannya kembali, jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
"licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
"licenseCount": LICENSE_COUNT
}' \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"
Ganti kode berikut:
PROJECT_NUMBER: nomor atau ID project yang Anda gunakan untuk mengatribusikan penagihan dan kuota untuk panggilan API ini. Anda harus memiliki peran Service Usage Consumer di project ini. Anda dapat menggunakanTARGET_PROJECT_NUMBERjika Anda mengaktifkan Discovery Engine di project tersebut.ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
LOCATION: multi-region penyimpanan data Anda:global,us, ataueu.TARGET_PROJECT_NUMBER: nomor project yang ingin Anda klaim kembali lisensinya. Ini adalah project tempat Anda mengalokasikan lisensi.LICENSE_COUNT: jumlah lisensi yang akan diklaim kembali.BILLING_ACCOUNT_ID: ID akun penagihan Google Cloud Anda.BILLING_ACCOUNT_LICENSE_CONFIG_ID: temukan ID Konfigurasi Lisensi Akun Penagihan dalam detail langganan.LICENSE_CONFIG_ID: ID konfigurasi lisensi dari konfigurasi lisensi level project yang ada.
Menangani penghentian awal
Saat Anda bermigrasi di antara berbagai jenis langganan atau jika akun penagihan Anda mengalami masalah, langganan mungkin akan berakhir lebih awal dari yang Anda rencanakan.
Untuk memastikan transisi yang lebih lancar dan mencegah gangguan layanan, kami memberikan masa tenggang satu minggu (tujuh hari) saat lisensi yang terpengaruh berada dalam status penonaktifan sebelum masa berlakunya berakhir sepenuhnya. Selama masa tenggang ini, Anda dapat terus menggunakan layanan sambil beralih ke langganan baru.
Untuk memastikan pengguna Anda tetap memiliki akses, transfer lisensi mereka ke langganan baru yang aktif, baik secara otomatis maupun manual.
Gambar berikut menunjukkan contoh penonaktifan lisensi di konsolGoogle Cloud :

Kelola lisensi pengguna
Bagian ini menjelaskan cara melihat lisensi, mengekspor data pengguna, serta menetapkan, mentransfer, dan menghapus lisensi untuk setiap pengguna.
Melihat lisensi
Untuk melihat lisensi dan pengguna yang Anda tetapkan, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise.
Klik Kelola pengguna.
Pilih Multi-region lisensi yang ada.
Mengekspor data pengguna
Tabel pengguna di konsol Google Cloud tidak mendukung pengurutan atau pemfilteran. Jika perlu mengurutkan, memfilter, atau menganalisis data pengguna, Anda dapat mengekspor hingga 1.000.000 data pengguna ke file comma separated values (CSV).
File CSV yang diekspor menyertakan kolom berikut.
| Nama kolom | Deskripsi |
|---|---|
user_principal |
Alamat email pengguna. |
license_config |
Nama resource Google Cloud lengkap untuk langganan yang ditetapkan
pengguna (misalnya,
projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID).
ID konfigurasi lisensi sesuai dengan edisi Gemini Enterprise (misalnya, Standard atau Plus) yang ditetapkan administrator
kepada pengguna.
|
assignment_time |
Stempel waktu (dalam UTC) saat administrator menetapkan lisensi. |
last_login_time |
Stempel waktu (dalam UTC) saat pengguna terakhir kali login. |
license_assignment_state
|
Status penetapan lisensi. Nilai berikut ini tersedia:
|
Untuk mengekspor data pengguna ke file CSV, lakukan tindakan berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise > Manage users.
Pilih Multi-region lisensi yang ada.
Di bagian Pengguna, klik Ekspor semua pengguna.
Bergantung pada ukuran tabel pengguna, mengekspor data mungkin memerlukan waktu hingga 2,5 menit. Selama waktu ini, konsol akan menampilkan status pemuatan. Setelah ekspor selesai, browser Anda akan mendownload file CSV ke lokasi download defaultnya.
Memecahkan masalah ekspor
Tabel berikut mencantumkan masalah umum saat mengekspor data pengguna dan solusinya.
| Masalah | Resolusi |
|---|---|
| Tombol Ekspor semua pengguna disembunyikan | Pastikan Anda menetapkan lisensi kepada pengguna di multi-region yang dipilih. Jika tidak ada pengguna yang memiliki lisensi yang ditetapkan, tombol Ekspor semua pengguna tidak akan muncul. |
| Permintaan ekspor gagal dengan error batas terlampaui | Jika daftar pengguna Anda melebihi batas ekspor 1.000.000 pengguna, Google Cloud console akan menolak permintaan ekspor dan menampilkan pesan error batas terlampaui. |
| Permintaan ekspor gagal dengan error izin ditolak |
Pastikan akun Anda memiliki peran
Gemini Enterprise Admin,
yang mencakup izin
discoveryengine.userStores.listUserLicenses yang diperlukan.
|
Menetapkan lisensi kepada pengguna
Bagian ini menjelaskan cara menetapkan lisensi secara otomatis atau manual kepada pengguna baru. Anda dapat menetapkan lisensi kepada pengguna baru kapan saja, dan setelah Anda menetapkan lisensi, pengguna dapat langsung mengakses Gemini Enterprise.
Menambahkan pengguna dan menetapkan lisensi kepada mereka secara otomatis
Untuk menetapkan lisensi kepada pengguna secara otomatis saat mereka login ke aplikasi Gemini Enterprise, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise.
Klik Kelola pengguna.
Pilih Multi-region lisensi yang ada.
Pilih Tetapkan lisensi secara otomatis, lalu pilih langganan.
Setiap kali pengguna tanpa lisensi yang ditetapkan secara manual login, Gemini Enterprise akan otomatis menetapkan lisensi dari langganan ini kepada mereka. Jika tidak ada lisensi yang tersisa dalam langganan, Gemini Enterprise akan menampilkan pesan kepada pengguna yang memberi tahu bahwa mereka tidak memiliki akses.
Untuk mengetahui informasi selengkapnya tentang langganan, lihat bagian Tentang langganan.
Menambahkan pengguna dan menetapkan lisensi secara manual kepada mereka
Untuk memberi pengguna tertentu akses ke Gemini Enterprise, Anda dapat menetapkan lisensi secara manual dari langganan aktif.
Konsol
Untuk menetapkan lisensi kepada pengguna secara manual, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise.
Klik Kelola pengguna.
Pilih Multi-region lisensi yang ada.
Klik Add users.
Di halaman Tambahkan pengguna:
Masukkan alamat email pengguna. Pastikan untuk menggunakan alamat email yang sama dengan yang akan mereka gunakan untuk login ke aplikasi Gemini Enterprise.
Pilih langganan yang akan ditetapkan untuk pengguna tersebut.
Klik Kirim.
REST
Untuk menetapkan lisensi secara manual kepada pengguna, jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
-d '{
"inlineSource":{
"userLicenses":[
{
"userPrincipal":"USER_EMAIL_1",
"licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
},
{
"userPrincipal":"USER_EMAIL_2",
"licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
}
],
"updateMask": "userPrincipal,licenseConfig"
},
"deleteUnassignedUserLicenses":false
}'
Ganti kode berikut:
PROJECT_ID: ID project Anda.ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
LOCATION: multi-region penyimpanan data Anda:global,us, ataueuUSER_EMAIL: alamat email pengguna yang ingin Anda tambahkan ke lisensi.PROJECT_NUMBER: jumlah project Google Cloud Anda.SUBSCRIPTION_ID: ID langganan Gemini Enterprise Anda.
Mentransfer lisensi dari langganan yang sudah tidak berlaku
Pengguna tidak dapat login ke Gemini Enterprise jika langganan telah berakhir. Anda dapat memulihkan akses login mereka dengan dua cara:
Mentransfer pengguna secara otomatis ke langganan aktif
Untuk mentransfer pengguna secara otomatis ke langganan aktif, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise > Manage users.
Pilih Multi-region lisensi yang ada.
Pastikan Anda memiliki langganan aktif. Jika Anda belum memilikinya, dapatkan langganan.
Pilih Tetapkan lisensi secara otomatis, lalu pilih langganan yang aktif.
Pilih Perbarui lisensi yang sudah tidak berlaku secara otomatis.
Saat pengguna dengan lisensi yang sudah tidak berlaku login lagi, Gemini Enterprise akan otomatis memberinya lisensi dalam langganan yang dipilih.
Mentransfer pengguna secara manual ke langganan aktif
Untuk mentransfer pengguna secara manual ke langganan aktif, lakukan tindakan berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise > Manage users.
Pilih Multi-region lisensi yang ada.
Pastikan Anda memiliki langganan aktif. Jika Anda belum memilikinya, dapatkan langganan.
Pilih pengguna, lalu klik Tetapkan lisensi lain.
Di panel Edit Users, pilih langganan, lalu klik Submit.
Mencantumkan lisensi
Untuk mencantumkan lisensi dan pengguna yang Anda tetapkan, jalankan perintah berikut:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"
Ganti kode berikut:
PROJECT_ID: ID project Anda.ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
LOCATION: multi-region penyimpanan data Anda:global,us, ataueu
Menghapus pengguna dari lisensi
Anda dapat menghapus lisensi dari pengguna kapan saja. Jika Anda menghapus lisensi, pengguna akan langsung kehilangan akses ke Gemini Enterprise. Untuk menghapus pengguna dari lisensi, lakukan hal berikut:
Konsol
Untuk menghapus pengguna dari lisensi menggunakan konsol Google Cloud , lakukan hal berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise > Manage users.
Pilih Multi-region lisensi yang ada.
Di tabel pengguna, pilih pengguna.
Untuk menghapus pengguna dari lisensi, pilih salah satu opsi berikut:
- Untuk hanya menghapus lisensi dari pengguna yang dipilih, klik Batalkan penetapan lisensi.
- Untuk menghapus lisensi dan juga menghapus pengguna yang dipilih dari project, klik Batalkan penetapan dan hapus lisensi.
Klik Konfirmasi.
REST
Untuk menghapus pengguna dari lisensi, jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
-d '{
"inlineSource":{
"userLicenses":[
{
"userPrincipal":"USER_EMAIL_1"
},
{
"userPrincipal":"USER_EMAIL_2"
}
],
"updateMask": "userPrincipal,licenseConfig"
},
"deleteUnassignedUserLicenses":true
}'
Ganti kode berikut:
PROJECT_ID: ID project Anda.ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
LOCATION: multi-region penyimpanan data Anda:global,us, ataueuUSER_EMAIL: alamat email pengguna yang ingin Anda hapus dari lisensi.
Langkah berikutnya
- Pelajari lebih lanjut Pertanyaan umum (FAQ) tentang lisensi Gemini Enterprise.
- Pelajari peran dan izin IAM.