Mendapatkan langganan dan menetapkan lisensi untuk Gemini Enterprise

Halaman ini menjelaskan cara mendapatkan langganan Gemini Enterprise dan cara mengelola lisensi pengguna.

Menyiapkan akses biasanya melibatkan tahap-tahap berikut:

1. Dapatkan: Beli langganan edisi produk untuk akun penagihan Anda.
2. Mendistribusikan: Mengalokasikan lisensi dari langganan ke project dan lokasi tertentu.
3. Tetapkan: Tetapkan lisensi yang didistribusikan kepada masing-masing pengguna.

Tentang lisensi

Untuk login ke aplikasi Gemini Enterprise, pengguna harus memiliki lisensi. Lisensi dapat ditetapkan 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 sehingga Gemini Enterprise secara otomatis menetapkan lisensi kepada pengguna saat pertama kali mereka mengakses Gemini Enterprise atau antarmuka Gemini Notebook Enterprise.

Catatan: Lisensi khusus untuk Google Cloud project dan lokasi. Misalnya, jika pengguna memerlukan akses ke aplikasi Gemini Enterprise yang berada di project Google Cloud yang ada di multi-region AS dan global, Anda harus memiliki dua lisensi terpisah untuk dua lokasi terpisah ini dalam project Google Cloud yang sama.

Tentang langganan

Untuk mendapatkan lisensi, Anda harus memiliki langganan edisi Gemini Enterprise terlebih dahulu. Langganan 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 selama setahun. Langganan ini dapat diatur untuk 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 , batas jumlah slot otomatis berlaku berdasarkan jenis akun Penagihan Cloud Anda:

• Akun penagihan layanan mandiri (atau Online) dan yang dijual kembali: Terbatas hingga maksimum 25 kursi per akun saat mengelola langganan menggunakan konsol Google Cloud .
• Akun penagihan dengan invoice (atau Offline): Terbatas hingga maksimum 1.000 kursi per akun.

Jika organisasi Anda memerlukan lebih banyak slot atau jika Anda mengalami error batas slot maksimum saat mencoba menambahkan lisensi ke langganan yang ada, hubungi Google Cloud sales representative atau pengelola akun Anda 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	Deskripsi
Belum dimulai	Anda membeli langganan, tetapi belum aktif. Anda dapat mendistribusikan lisensi dari langganan ini ke project, tetapi pengguna yang diberi lisensi ini tidak akan memiliki akses ke 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 dalam status penonaktifan, dengan lisensi yang dijadwalkan untuk penghentian awal. Pengguna dengan lisensi dalam langganan ini akan terus memiliki akses ke Gemini Enterprise selama masa tenggang satu minggu. Setelah minggu ini, lisensi akan bertransisi ke status Expired. Untuk mengetahui informasi selengkapnya, lihat Menangani penghentian awal.
Telah Berakhir	Pengguna dengan lisensi dalam langganan ini akan kehilangan akses ke Gemini Enterprise saat masa berlaku langganan berakhir atau saat lisensi bertransisi dari status nonaktif ke status habis masa berlaku setelah penghentian awal.

Sebelum memulai

Sebelum memulai prosedur di halaman ini, pastikan Anda memenuhi prasyarat berikut:

• Selesaikan semua tugas yang diuraikan dalam Menyiapkan Gemini Enterprise. Hal ini mencakup:

  • Menyiapkan akun penagihan untuk project Anda.
  • Memberi peran Pengguna Gemini Enterprise kepada pengguna yang akan Anda beri lisensi untuk menggunakan Gemini Enterprise.

• Pastikan penagihan diaktifkan untuk project Google Cloud Anda. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  Catatan: Langganan Gemini Enterprise dengan model Bayar sesuai penggunaan hanya tersedia untuk akun yang menggunakan invoice. Untuk mengetahui informasi selengkapnya, lihat Jenis akun Penagihan Cloud.

• Pastikan Anda memiliki peran dan izin IAM yang diperlukan:

  • Peran Admin Gemini Enterprise.

  • Jika Anda mengelola penagihan untuk organisasi, Anda harus memiliki peran berikut untuk mengelola langganan Gemini Enterprise dan pesanan pembelian.

    • Billing Account Administrator (roles/billing.admin)
    • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

    Atau, untuk kontrol IAM terperinci, Anda dapat menggunakan peran kustom dengan izin berikut, bukan peran Billing Account Administrator:

    Layanan	Izin
    Discovery Engine	discoveryengine.billingAccountLicenseConfigs.distribute discoveryengine.billingAccountLicenseConfigs.get discoveryengine.billingAccountLicenseConfigs.list discoveryengine.billingAccountLicenseConfigs.retract 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.listUserLicenses
    Consumer Procurement	consumerprocurement.orders.get consumerprocurement.licensePools.assign consumerprocurement.licensePools.unassign consumerprocurement.licensePools.enumerateLicensedUsers
    Resource Manager	resourcemanager.projects.get resourcemanager.projects.list
    Service Usage	serviceusage.services.get serviceusage.services.list

Mendapatkan langganan

Untuk mendapatkan lisensi, beli langganan edisi Gemini Enterprise untuk akun penagihan Anda. Langganan ini menyediakan kumpulan lisensi yang dapat Anda gunakan dengan project apa pun yang terhubung ke akun penagihan tersebut, didistribusikan ke project, dan ditetapkan kepada pengguna.

Standard dan Plus

Untuk berlangganan Gemini Enterprise Standard atau Plus Edition, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola langganan > Buat langganan.

3. Untuk edisi Gemini Enterprise Standard atau Gemini Enterprise Plus, klik Berlangganan.

4. Konfigurasi Detail penagihan:

   1. Pilih Akun penagihan dari menu drop-down.
   2. Masukkan Nama langganan.
   3. Masukkan Jumlah lisensi yang Anda perlukan untuk edisi tersebut.

5. Pilih Periode langganan.

6. Jika Anda ingin langganan diperpanjang secara otomatis, pilih Perpanjang langganan otomatis.

7. Konfigurasi Detail distribusi:

   1. Di menu drop-down Select a project, pilih project Anda.
   2. Pilih Jenis lokasi 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.

8. Klik Buat > Konfirmasi.

Bayar sesuai penggunaan

Dengan langganan Bayar sesuai penggunaan, Anda membayar setiap bulan untuk apa yang Anda gunakan dengan tarif yang tercantum di Kelebihan biaya. Anda dapat menggunakan langganan dengan project apa pun yang terhubung ke akun penagihan Anda.

Catatan: Langganan Bayar sesuai penggunaan hanya tersedia untuk akun Penagihan Cloud dengan invoice. Untuk mengetahui informasi selengkapnya, lihat Jenis akun Penagihan Cloud.

Untuk berlangganan edisi Gemini Enterprise bayar sesuai penggunaan, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola langganan > Buat langganan.

3. Pada edisi Gemini Enterprise Pay-as-you-go, klik Subscribe.

4. Konfigurasi Detail penagihan:

   1. Masukkan Nama langganan.
   2. Masukkan Jumlah lisensi yang Anda perlukan untuk edisi tersebut.

5. Konfigurasi Detail distribusi:

   1. Di menu drop-down Select a project, pilih project Anda.
   2. Pilih Jenis lokasi 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.

6. Klik Buat > Konfirmasi.

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

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola langganan.

3. Pilih Akun penagihan dari menu drop-down.

4. Di tabel Langganan Gemini, klik nama langganan Anda.

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 project yang memiliki peran Service Usage Consumer
• 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 awalnya:

• Jika Anda membeli langganan melalui konsol Google Cloud , tambahkan lisensi lainnya langsung di 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.

Catatan: Saat memperbarui jumlah kursi langganan di konsol Google Cloud , batas kursi maksimum berlaku berdasarkan jenis akun penagihan Anda (hingga 25 kursi untuk akun penagihan layanan mandiri (atau online) dan yang dijual kembali, serta hingga 1.000 kursi untuk akun penagihan dengan invoice (atau offline)). Untuk mengetahui informasi selengkapnya, lihat Batas jumlah kursi langganan.

Jika langganan yang ada melebihi nilai minimum ini (misalnya, jika langganan tersebut awalnya disediakan melalui pesanan offline yang dipimpin penjualan), upaya untuk menambahkan lebih banyak lisensi langsung melalui konsol Google Cloud dapat menyebabkan error batas slot. Hubungi Google Cloud Sales Rep atau pengelola akun Anda untuk menyesuaikan jumlah lisensi atau meminta pengecualian daftar yang diizinkan.

Ikuti langkah-langkah berikut untuk memperbarui jumlah lisensi jika Anda membeli melalui konsol Google Cloud :

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola langganan.

3. Klik langganan yang ingin Anda perbarui dari tabel Langganan Gemini.

4. Klik Edit di samping Detail langganan.

5. Perbarui jumlah lisensi atau aktifkan atau nonaktifkan perpanjangan otomatis.

6. Klik Kirim.

Membatalkan langganan

Untuk membatalkan langganan Gemini Enterprise, Anda harus menonaktifkan perpanjangan otomatis. Langganan Anda akan tetap aktif hingga masa langganan berakhir, dan Anda mungkin dikenai biaya hingga tanggal tersebut. Untuk mempelajari langganan Anda lebih lanjut, lihat Melihat detail langganan.

Untuk membatalkan langganan, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola langganan.

3. Di tabel Langganan Gemini, klik nama langganan Anda untuk membuka halaman detail langganan.

4. Klik Edit.

5. Di panel Edit langganan, hapus centang pada kotak Perpanjang langganan secara otomatis.

6. Klik Kirim.

Mendistribusikan lisensi

Jika Anda belum mendistribusikan lisensi yang telah dibeli ke project, yang mungkin terjadi saat Anda membeli langganan secara offline atau saat distribusi lisensi gagal sebelumnya, lakukan hal berikut:

Catatan: Langganan Gemini Enterprise Standard atau Plus juga memberikan akses ke fitur Gemini Code Assist Standard di IDE yang didukung. Anda harus menetapkan lisensi ini secara terpisah di halaman administrator Gemini Code Assist. Untuk mengetahui informasi selengkapnya, lihat artikel Menyiapkan Gemini Code Assist.

Kemampuan ini tidak disertakan dalam paket Business atau Frontline. Untuk informasi selengkapnya tentang fitur yang disertakan dalam setiap tingkat, lihat Membandingkan edisi Gemini Enterprise.

Konsol

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola langganan.

3. Pilih Akun penagihan dari menu drop-down.

4. Di tabel Langganan Gemini, klik nama langganan Anda.

5. Klik Distribute License di bagian atas halaman. Daftar akan muncul, menampilkan distribusi lisensi yang ada dan statistik kursi yang tersisa dan total.

6. Untuk mendistribusikan lisensi ke project:

   1. Klik pemilih project untuk memilih project. Pemilih mendukung pelengkapan otomatis.
   2. Catatan: Jika Anda belum mengaktifkan Discovery Engine API untuk project yang dipilih, dialog akan muncul dan meminta Anda untuk mengaktifkannya.
   3. Pilih Lokasi.
   4. Masukkan jumlah lisensi yang akan dialokasikan.
   5. Ulangi langkah-langkah ini jika Anda ingin mendistribusikan lisensi ke beberapa project atau lokasi.

7. Klik Kirim.

8. Pada dialog konfirmasi, tinjau ringkasan perubahan, lalu klik Konfirmasi.

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 project yang memiliki peran Service Usage Consumer
• ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:
  • us untuk multi-region AS
  • eu untuk multi-region Uni Eropa
  • global untuk lokasi Global
  Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
• LOCATION: multi-region penyimpanan data Anda: global, us, atau eu.
• TARGET_PROJECT_NUMBER: nomor project yang ingin Anda beri lisensi.
• 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 kolom licenseConfigDistributions saat melihat detail langganan.

  Catatan: Jika Anda tidak menyertakan LICENSE_CONFIG_ID dari permintaan API ini, konfigurasi lisensi baru akan dibuat untuk nomor project dan lokasi yang ditentukan. Untuk memperbarui konfigurasi lisensi yang ada, Anda harus menyertakan LICENSE_CONFIG_ID.

Mengklaim ulang lisensi yang tidak ditetapkan dalam langganan

Bagian ini menjelaskan cara mengklaim kembali lisensi yang tidak ditetapkan dari project, sehingga lisensi tersebut tersedia di akun penagihan untuk didistribusikan ulang ke project lain.

Konsol

Catatan: Anda hanya dapat melakukan tindakan ini satu kali per hari kalender.

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola langganan.

3. Pilih Akun penagihan dari menu drop-down.

4. Di tabel Langganan Gemini, klik nama langganan Anda.

5. Klik Distribute License di bagian atas halaman (tombol ini akan membuka formulir pengelolaan untuk semua alokasi).

6. Dalam daftar alokasi, cari baris untuk project dan lokasi yang ingin Anda ambil kembali lisensinya.

7. Pilih salah satu tindakan berikut:

   • Untuk mengurangi jumlah lisensi: Kurangi jumlah di kolom input lisensi.
   • Untuk sepenuhnya mengklaim kembali lisensi: Arahkan kursor ke baris untuk menampilkan tombol hapus, lalu klik Hapus.

8. Klik Kirim.

9. Pada dialog konfirmasi, tinjau ringkasan perubahan (yang akan mencantumkan lisensi yang diklaim kembali) lalu klik Konfirmasi.

REST

Catatan: Anda hanya dapat melakukan tindakan ini satu kali per hari.

Untuk mentransfer kembali lisensi langganan ke akun penagihan untuk redistribusi, 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 project yang memiliki peran Service Usage Consumer
• ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:
  • us untuk multi-region AS
  • eu untuk multi-region Uni Eropa
  • global untuk lokasi Global
  Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
• LOCATION: multi-region penyimpanan data Anda: global, us, atau eu.
• TARGET_PROJECT_NUMBER: nomor project yang ingin Anda ambil kembali lisensinya.
• 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 tingkat project yang ada.

Menangani penghentian awal

Saat Anda melakukan migrasi antar-jenis langganan yang berbeda atau jika ada masalah dengan akun penagihan Anda, langganan mungkin berakhir lebih awal dari yang direncanakan.

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 benar-benar berakhir. Selama masa tenggang ini, Anda dapat terus menggunakan layanan saat Anda beralih ke langganan baru.

Untuk memastikan pengguna Anda mempertahankan akses, transfer lisensi mereka ke langganan baru yang aktif secara otomatis atau manual.

Gambar berikut menunjukkan contoh penonaktifan lisensi di konsol Google 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 ditetapkan ke lisensi tersebut, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola pengguna.

3. 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 kepada 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 kepada pengguna.
assignment_time	Stempel waktu (dalam UTC) saat administrator memberikan lisensi.
last_login_time	Stempel waktu (dalam UTC) saat pengguna terakhir kali login.
license_assignment_state	Status penetapan lisensi. Nilai berikut tersedia: ASSIGNED: Pengguna memiliki lisensi yang ditetapkan. NO_LICENSE: Pengguna tidak memiliki lisensi karena administrator belum menetapkannya atau telah menghapus lisensi yang ada. BLOCKED: Kebijakan atau administrator memblokir pengguna agar tidak menerima lisensi.

Untuk mengekspor data pengguna ke file CSV, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise > Kelola pengguna.

   Mengelola pengguna

2. Pilih Multi-region lisensi yang ada.

3. Di bagian Pengguna, klik Ekspor semua pengguna.

   Bergantung pada ukuran tabel pengguna, proses ekspor mungkin memerlukan waktu hingga 2,5 menit untuk selesai. Selama waktu ini, konsol akan menampilkan status pemuatan. Setelah ekspor selesai, browser Anda akan mendownload file CSV ke lokasi download default-nya.

Memecahkan masalah ekspor

Tabel berikut mencantumkan masalah umum saat mengekspor data pengguna dan solusinya.

Masalah	Resolusi
Tombol Ekspor semua pengguna tersembunyi	Pastikan ada pengguna yang diberi lisensi di multi-region yang dipilih. Jika tidak ada pengguna 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, konsol Google Cloud akan menolak permintaan ekspor dan menampilkan pesan error yang menunjukkan batas terlampaui.
Permintaan ekspor gagal dengan error izin ditolak	Pastikan akun Anda memiliki peran Admin Gemini Enterprise, 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 lisensi ditetapkan, 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:

Catatan: Pastikan langganan Anda memiliki lisensi yang cukup untuk jumlah maksimum pengguna yang diperkirakan akan menggunakan Gemini Enterprise.

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola pengguna.

3. Pilih Multi-region lisensi yang ada.

4. 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 pengguna tersebut. Jika tidak ada lisensi yang tersisa dalam langganan, Gemini Enterprise akan menampilkan pesan kepada pengguna yang memberi tahu mereka 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 kepada mereka dari langganan aktif.

Konsol

Untuk menetapkan lisensi kepada pengguna secara manual, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Klik Kelola pengguna.

3. Pilih Multi-region lisensi yang ada.

4. Klik Add users.

5. Di halaman Tambahkan pengguna:

   1. Masukkan alamat email pengguna. Pastikan untuk menggunakan alamat email yang sama dengan yang akan mereka gunakan untuk login ke aplikasi Gemini Enterprise.

   2. Pilih langganan yang akan ditetapkan kepada pengguna tersebut.

   3. Klik Kirim.

REST

Untuk menetapkan lisensi kepada pengguna secara manual, jalankan perintah berikut:

Istilah Penting: Di Gemini Enterprise, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API. Mesin Gemini Enterprise adalah mesin telusur umum dengan kolom app_type disetel ke APP_TYPE_INTRANET.

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:
  • us untuk multi-region AS
  • eu untuk multi-region Uni Eropa
  • global untuk lokasi Global
  Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
• LOCATION: multi-region penyimpanan data Anda: global, us, atau eu
• USER_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 berakhir

Pengguna tidak dapat login ke Gemini Enterprise jika langganan telah habis masa berlakunya. Ada beberapa pendekatan untuk mengembalikan akses login kepada mereka:

• Mentransfer pengguna lama dengan lisensi yang telah berakhir secara otomatis ke langganan default.

• Mentransfer pengguna lama secara manual ke langganan baru.

Catatan: Jika sebelumnya Anda memblokir pengguna agar tidak dapat mengakses lisensi, Gemini Enterprise akan memberi mereka akses dalam waktu 30 menit setelah Anda menetapkan lisensi baru.

Mentransfer pengguna secara otomatis ke langganan aktif

Untuk mentransfer pengguna secara otomatis ke langganan aktif, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise > Manage users.

   Lisensi Gemini Enterprise

2. Pilih Multi-region lisensi yang ada.

3. Pastikan Anda memiliki langganan aktif. Jika Anda belum memilikinya, dapatkan langganan.

4. Pilih Tetapkan lisensi secara otomatis dan pilih langganan yang aktif.

5. Pilih Update otomatis lisensi yang telah berakhir.

   Saat pengguna dengan lisensi yang telah habis masa berlakunya login berikutnya, Gemini Enterprise akan otomatis memberikan lisensi kepada mereka dalam langganan yang dipilih.

Mentransfer pengguna secara manual ke langganan aktif

Untuk mentransfer pengguna secara manual ke langganan aktif, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise > Manage users.

   Lisensi Gemini Enterprise

2. Pilih Multi-region lisensi yang ada.

3. Pastikan Anda memiliki langganan aktif. Jika Anda belum memilikinya, dapatkan langganan.

4. Pilih pengguna, lalu klik Tetapkan lisensi yang berbeda.

5. Di panel Edit Pengguna, pilih langganan, lalu klik Kirim.

Mencantumkan lisensi

Untuk mencantumkan lisensi dan pengguna yang ditetapkan untuk lisensi tersebut, jalankan perintah berikut:

Istilah Penting: Di Gemini Enterprise, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API. Mesin Gemini Enterprise adalah mesin telusur umum dengan kolom app_type disetel ke APP_TYPE_INTRANET.

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:
  • us untuk multi-region AS
  • eu untuk multi-region Uni Eropa
  • global untuk lokasi Global
  Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
• LOCATION: multi-region penyimpanan data Anda: global, us, atau eu

Menghapus pengguna dari lisensi

Anda dapat menghapus lisensi dari pengguna kapan saja. Jika lisensi dihapus, 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:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise > Manage users.

   Lisensi Gemini Enterprise

2. Pilih Multi-region lisensi yang ada.

3. Di tabel pengguna, pilih pengguna.

4. Untuk menghapus pengguna dari lisensi, pilih salah satu opsi berikut:

   • Untuk menghapus lisensi dari pengguna yang dipilih saja, klik Batalkan penetapan lisensi.
   • Untuk menghapus lisensi dan juga menghapus pengguna yang dipilih dari project, klik Batalkan penetapan dan hapus lisensi.

5. Klik Konfirmasi.

REST

Untuk menghapus pengguna dari lisensi, jalankan perintah berikut:

Istilah Penting: Di Gemini Enterprise, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API. Mesin Gemini Enterprise adalah mesin telusur umum dengan kolom app_type disetel ke APP_TYPE_INTRANET.

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:
  • us untuk multi-region AS
  • eu untuk multi-region Uni Eropa
  • global untuk lokasi Global
  Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
• LOCATION: multi-region penyimpanan data Anda: global, us, atau eu
• USER_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.