Mendapatkan lisensi untuk Gemini Enterprise

Halaman ini menjelaskan cara mendapatkan langganan Gemini Enterprise dan cara mengelola lisensi 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 emailnya.

• Lisensi yang ditetapkan secara otomatis: Anda dapat memilih agar lisensi yang merupakan bagian dari langganan ditetapkan secara otomatis kepada pengguna saat pertama kali mereka mengakses antarmuka Gemini Enterprise atau NotebookLM 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 berada 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 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 selama setahun. Langganan ini dapat diatur untuk diperpanjang secara otomatis.

Sebelum memulai

Sebelum memulai prosedur di halaman ini, pastikan:

• Anda telah menyelesaikan tugas di Menyiapkan Gemini Enterprise. Hal ini mencakup, menyiapkan akun penagihan untuk project Anda, dan memberi setidaknya peran Discovery Engine User kepada pengguna mana pun yang akan Anda beri lisensi untuk menggunakan Gemini Enterprise.

• Anda memiliki peran Admin Discovery Engine.

• Untuk mengelola langganan, Anda harus memiliki peran Billing Account Administrator. Untuk mengetahui informasi selengkapnya tentang cara menemukan administrator yang ada, lihat Menemukan Administrator Akun Penagihan.

Mendapatkan langganan

Untuk mendapatkan langganan Gemini Enterprise, lakukan langkah berikut:

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

   Gemini Enterprise

2. Klik Kelola langganan > Buat langganan.

3. Pada edisi yang ingin Anda langgan, 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 Pilih 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.

Mendistribusikan Lisensi

Jika lisensi yang telah dibeli tidak didistribusikan ke project, yang mungkin terjadi saat langganan dibeli secara offline, atau saat distribusi lisensi gagal sebelumnya, lakukan hal berikut:

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 Licenses di samping Subscription details.

6. Konfigurasi detail Distribusi Lisensi:

   1. Di menu drop-down Pilih project, pilih project Anda.

   2. Pilih 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.

7. Klik Kirim.

Memperbarui setelan langganan

Setelah membuat langganan, Anda dapat memperbarui setelan, seperti jumlah lisensi atau setelan perpanjangan otomatis.

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.

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.

   Lisensi dari langganan ini ditetapkan setiap kali pengguna yang tidak memiliki lisensi yang ditetapkan secara manual login. Jika tidak ada lisensi yang tersisa dalam langganan, pengguna akan melihat pesan 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 generik 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":{
       "paths":[
          "userPrincipal",
          "licenseConfig"
       ]
    }
 },
 "deleteUnassignedUserLicenses":false
}'

Ganti kode berikut:

• PROJECT_ID: ID project Anda.
• ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tetapkan 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 Google Cloud project 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:

• Secara otomatis mentransfer pengguna lama dengan lisensi yang telah berakhir ke langganan default.

• Mentransfer pengguna lama secara manual ke langganan baru.

Catatan: Jika pengguna sebelumnya diblokir untuk mengakses lisensi, akses ke Gemini Enterprise akan diberikan dalam waktu 30 menit setelah lisensi baru ditetapkan.

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 yang 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 berakhir login berikutnya, mereka akan otomatis diberi lisensi 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 yang 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 ke lisensi tersebut, jalankan perintah berikut:

REST

Istilah Penting: Di Gemini Enterprise, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API. Mesin Gemini Enterprise adalah mesin telusur generik 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. Tetapkan 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 generik 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":{
       "paths":[
          "userPrincipal",
          "licenseConfig"
       ]
    }
 },
 "deleteUnassignedUserLicenses":true
}'

Ganti kode berikut:

• PROJECT_ID: ID project Anda.
• ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tetapkan 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 peran dan izin IAM.