Mendapatkan lisensi untuk Gemini Enterprise

Halaman ini menjelaskan cara mendapatkan langganan Gemini Enterprise dan menetapkan lisensi kepada pengguna Anda.

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.

Lisensi khusus untuk multi-region. Misalnya, jika pengguna ingin mengakses aplikasi di multi-region us dan global, tetapkan lisensi untuk mereka di setiap region.

Tentang langganan

Untuk mendapatkan lisensi, Anda harus memiliki langganan edisi Gemini Enterprise terlebih dahulu. Untuk informasi tentang edisi yang tersedia, lihat Membandingkan edisi Gemini Enterprise.

Langganan bersifat spesifik per region. Pengguna yang membuat aplikasi di region global memerlukan lisensi dari langganan global. Demikian pula, pengguna yang perlu menyimpan aplikasi dan data mereka di Uni Eropa memerlukan lisensi dari langganan eu.

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.

Mendapatkan langganan

Untuk mendapatkan langganan Gemini Enterprise, lakukan hal 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.

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.

Menambahkan pengguna dan menetapkan lisensi kepada mereka secara manual

Untuk memberi pengguna tertentu akses ke Gemini Enterprise, Anda dapat menetapkan lisensi kepada mereka secara manual 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:

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/global/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/global/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 Amerika Serikat
    • 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.

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:

  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.

Mentransfer lisensi dari langganan yang sudah berakhir

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

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 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 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:

REST

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 Amerika Serikat
    • 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

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:

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 Amerika Serikat
    • 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