Gemini Code Assist Standard ve Enterprise lisanslarını yönetme

Gemini Code Assist Standard ve Enterprise'ı kullanmadan önce kuruluşunuzdaki her kullanıcının lisansı olmalıdır.

Varsayılan olarak, yeni aboneliklerde lisansları manuel olarak atamanız gerekir. Belirli Gemini for Google Cloud ürünlerini kurduktan sonra lisansları manuel veya otomatik olarak atamayı seçebilirsiniz.

İlgili faturalandırma hesabına bağlı bir projeye erişimi olan tüm kullanıcılara lisans atayabilirsiniz. Lisansı kullanıcıya atadıktan sonra kullanıcı, herhangi bir projede Gemini Code Assist'i kullanabilir.

Not: Google Developer Program Premium aboneliği olan bir kullanıcıya Gemini Code Assist Standard koltuğu lisansı atayamazsınız. Bu kullanıcılar, kendi aboneliklerinin bir parçası olarak Gemini Code Assist Standard lisansına zaten sahiptir.

Başlamadan önce

• Aşağıdaki bölümlerde ayrıntılı olarak açıklanan belirli lisans yönetimi görevleri için faturalandırma hesabında gerekli olan ek izinleri verebilmek amacıyla Faturalandırma Hesabı Yöneticisi (roles/billing.admin) veya Tüketici Satın Alma Siparişi Yöneticisi (roles/consumerprocurement.orderAdmin) IAM rollerine sahip olduğunuzdan emin olun.

• • Gemini Code Assist'i kurduğunuzu doğrulayın.

• Lisansları Google API Konsolu yerine bir API kullanarak yönetmek istiyorsanız aşağıdakileri doğrulayın:

  • Faturalandırma hesabınız için kota projesi oluşturun.
  • Kota projenizde Cloud Commerce Consumer Procurement API'yi etkinleştirin.
  • Aşağıdaki başlık anahtar-değer çiftlerinin tüm API çağrılarında bulunduğunu doğrulayın:
    • Authorization: Google Cloud KSA'dan alınan Google Cloud erişim jetonunuz
    • x-goog-user-project: kota projenizin proje kimliği

Abonelikteki Gemini Code Assist Standard ve Enterprise lisanslarının sayısını değiştirme

Google Cloud için Gemini lisanslarının sayısını doğrudan API Konsolu'ndan veya Google Hesabı temsilciniz ya da yetkili bir bayi aracılığıyla ekleyebilir veya kaldırabilirsiniz.

Abonelikteki lisans sayısını değiştirmek için aşağıdaki adımları uygulayın:

1. Aboneliğin sahibi olan faturalandırma hesabında aşağıdaki Kimlik ve Erişim Yönetimi izinlerine sahip olduğunuzu doğrulayın:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.orders.modify
   • resourcemanager.projects.get

2. API Console'da Gemini için Yönetici sayfasına gidin.

   Google Cloud için Gemini'a gitme

3. Değiştirmek istediğiniz aboneliği seçin ve ardından Aboneliği Değiştir'i seçin. Etkin bir deneme süresindeyseniz bu düğmenin Otomatik yenilemeyi devre dışı bırak olarak görüneceğini unutmayın.

4. Sahip olmak istediğiniz lisans sayısını girin. Aşağıdaki bilgiler gösterilir:

   • Satın alma işleminden sonraki toplam lisans sayısı.
   • Satın alma işleminden sonra atama için kullanılabilen lisans sayısı.
   • Dönem başına yeni abonelik fiyatı. Eklenen lisanslar için ek tutar, mevcut dönemde kalan süreye göre orantılı olarak hesaplanır.

5. Kaydet'i seçin.

Gemini Code Assist Standard ve Enterprise lisans atamalarını görüntüleme

Aşağıdaki seçeneklerden birini belirtin:

Console

1. Aboneliğin sahibi olan faturalandırma hesabında aşağıdaki IAM izinlerine sahip olduğunuzu doğrulayın:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • resourcemanager.projects.get

2. Gemini için Yönetici sayfasına gidin ve Gemini Code Assist Standard veya Enterprise aboneliğiyle faturalandırma hesabınıza bağlı projeyi seçin.

   Google Cloud için Gemini'a gitme

3. Değiştirmek istediğiniz aboneliği seçin ve ardından Aboneliği Değiştir'i seçin.

   Lisans atanmış her kullanıcı için aşağıdaki bilgiler kullanılabilir:

   • Ad.
   • E-posta'yı tıklayın.
   • Lisansın atandığı tarih.
   • Lisansın en son kullanıldığı tarih ve saat.

4. Belirli bir kullanıcı grubunu bulmak için listeyi aşağıdaki gibi filtreleyip sıralayabilirsiniz:

   • Listeyi filtrelemek için Filtre alanına özellikleri ve değerleri girin.
   • Listeyi sıralamak için sıralama ölçütü olarak kullanmak istediğiniz sütunun başlığını seçin. Örneğin, kullanıcı adlarına göre alfabetik olarak sıralamak için Ad sütun başlığını seçin.

API

Gemini Code Assist Standard veya Enterprise lisans atamalarını görüntülemek için billingAccounts.orders.licensePool.enumerateLicensedUsers yöntemini kullanın.

1. Lisans atamalarını görüntülemek istediğiniz lisans havuzunu içeren faturalandırma hesabında consumerprocurement.licensePools.enumerateLicensedUsers IAM izninizin olduğunu doğrulayın.

2. Yöntemi çağırmak için cURL kullanın:

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/"
   

   Aşağıdakini değiştirin:

   • PROJECT_ID: Projenin kimliği. API isteğiyle ilişkili kota kullanımı ve ücretler bu projeye uygulanır.
   • BILLING_ACCOUNT_ID: Lisans havuzuyla ilişkili faturalandırma hesabının kimliği.
   • ORDER_ID: Sipariş kimliği. Sipariş kimliğini bilmiyorsanız faturalandırma hesabınızla ilişkili siparişleri listeleyerek kimliği alabilirsiniz.

Komut başarılı olursa aşağıdaki biçimde licensedUsers çıkışı döndürür:

{
  "licensedUsers": [
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

Gemini Code Assist Standard veya Enterprise lisans ataması yoksa ya da ORDER_ID geçersizse aşağıdaki biçimde licensedUsers çıkışı döndürülür:

{}

Gemini Code Assist Standard ve Enterprise lisanslarını tek tek kullanıcılara manuel olarak atama

Aşağıdaki seçeneklerden birini belirtin:

Console

1. Aboneliğin sahibi olan faturalandırma hesabında aşağıdaki IAM izinlerine sahip olduğunuzu doğrulayın:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.assign
   • resourcemanager.projects.get

2. Gemini için Yönetici sayfasına gidin.

   Google Cloud için Gemini'a gitme

3. Gemini Code Assist'i yönet'i ve ardından Aboneliği değiştir'i seçin.

4. Bu Gemini Code Assist Standard veya Enterprise aboneliği için Lisans Atama'yı Lisansları Manuel Olarak Ata olarak ayarladığınızı doğrulayın. Gemini Code Assist Standard veya Enterprise aboneliği Lisansları Otomatik Olarak Ata olarak ayarlanmışsa tek tek lisansları yönetemezsiniz. Bu faturalandırma hesabını Lisansları Manuel Olarak Atama'ya geçirdiğinizde, değişiklikten sonra otomatik lisans atama özelliği devre dışı bırakılır ancak mevcut lisans atamaları etkilenmez.

5. Lisanslı kullanıcı ekle'yi seçin. Kullanıcı seçimi iletişim kutusu görünür. Yalnızca @gmail.com, @googlegroups.com ve Google Workspace alanları gibi bireysel Google Hesabı e-posta adresleri desteklenir. Workforce Identity Federation (BYOID) desteklenmez.

6. Lisanslı kullanıcı ekle'yi seçin.

7. Lisanslı kullanıcılara Google Cloud için Gemini Kullanıcısı ve Hizmet Kullanımı Tüketicisi IAM rollerini verdiğinizi doğrulayın.

API

Gemini Code Assist Standard ve Enterprise lisansları atamak için billingAccounts.orders.licensePool.assign yöntemini kullanın.

1. Lisansını atamak istediğiniz lisans havuzunu içeren faturalandırma hesabında aşağıdaki IAM izinlerine sahip olduğunuzu doğrulayın:

• billing.accounts.get
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.unassign
• consumerprocurement.orders.get

1. Aşağıdaki bilgileri içeren bir JSON dosyası oluşturun:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   USER_EMAILS yerine, lisansın atandığı kullanıcı hesaplarının virgülle ayrılmış listesini girin (ör. "[e-mail]", "[e-mail]"). Yalnızca @gmail.com, @googlegroups.com gibi bireysel Google Hesabı e-posta adresleri ve Google Workspace alanları desteklenir. İş gücü kimlik federasyonu (BYOID) desteklenmez.

2. Yöntemi çağırmak için cURL kullanın:

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

   Aşağıdakini değiştirin:

   • JSON_FILE_NAME: 2. adımda oluşturduğunuz JSON dosyasının yolu.
   • PROJECT_ID: Projenin kimliği. API isteğiyle ilişkili kota kullanımı ve ücretler bu projeye uygulanır.
   • BILLING_ACCOUNT_ID: Lisans havuzuyla ilişkili faturalandırma hesabının kimliği.
   • ORDER_ID: Sipariş kimliği. Sipariş kimliğini bilmiyorsanız faturalandırma hesabınızla ilişkili siparişleri listeleyerek kimliği alabilirsiniz.

Başarılı olursa yanıt aşağıdakine benzer:

{}

Ödevi doğrulamak için ödev listesini görüntüleyin.

Ardından, lisanslı kullanıcılara Gemini for Google Cloud Kullanıcısı ve Hizmet Kullanımı Tüketicisi IAM rollerini verdiğinizi doğrulayın.

Gemini Code Assist Standard ve Enterprise lisanslarını otomatik olarak atama

Lisans atama sayfasından, kuruluşunuzda Gemini Code Assist Standard veya Enterprise'a erişmesi gereken tüm kullanıcılara otomatik olarak lisans atayabilirsiniz. Otomatik lisans atama, her abonelik için ayrı ayrı ayarlanır.

Otomatik lisans atama yalnızca VS Code, IntelliJ ve diğer desteklenen JetBrains IDE'lerinde desteklenir.

Gemini Code Assist Standard veya Enterprise lisanslarını otomatik olarak atamayı seçerseniz bu hesap altındaki kullanıcı lisanslarını tek tek kaldıramaz veya ekleyemezsiniz. Lisans ataması olan ve Gemini Code Assist Standard veya Enterprise özelliklerini kullanmamış kullanıcıların lisansları, yönetici tarafından belirlenen etkinlik dışı kalma süresinin sonunda otomatik olarak kaldırılır.

1. API Console'da Gemini için Yönetici sayfasına gidin.

   Google Cloud için Gemini'a gitme

2. Gemini Code Assist'i yönetin'i ve ardından Aboneliği Yönet'i seçin.

3. Lisans Yönetimi'ni ve ardından Otomatik Lisans Atamayı Etkinleştir'i seçin. Otomatik lisansları etkinleştir iletişim kutusu gösterilir.

   Bu aboneliğin lisansları otomatik olarak atayacak şekilde değiştirilmesi, değişiklikten sonra manuel lisans atamayı devre dışı bırakır ancak önceden atanmış lisanslar etkilenmez.

4. Atanan kullanıcı etkin değilse lisansın atanmasını kaldırmak için süreyi ayarlayın, ardından Değişikliği Onayla'yı seçin. Otomatik lisans atama etkinleştirildi iletişim kutusu gösterilir.

   Atamayı kaldırmak için T gün boyunca etkinlik olmaması gerektiğini yapılandırdıysanız lisanslar otomatik olarak atanmaz ve T+1. günde lisans havuzunda kullanılabilir. Örneğin, atamayı kaldırmak için 7 gün işlem yapılmaması gerektiğini yapılandırırsanız lisansların ataması kaldırılır ve 8. günde lisans havuzunda kullanılabilir hale gelir.

5. Kapat'ı seçin.

6. Lisanslı kullanıcılara Gemini for Google Cloud Kullanıcısı ve Hizmet Kullanımı Tüketicisi IAM rollerini verdiğinizden emin olun.

   cloudaicompanion.licenses.selfAssign iznine sahip kullanıcılar, otomatik lisans atama için yapılandırılmış ve faturalandırma hesabındaki abonelikleriniz kapsamında kullanılabilir lisanslara sahip bir faturalandırma hesabı tarafından ödenen bir projede Gemini Code Assist Standard veya Enterprise'a ilk kez eriştiğinde otomatik olarak lisans alır.

Otomatik lisans atamayı devre dışı bırakmak için aşağıdaki adımları uygulayın:

1. API Console'da Gemini için Yönetici sayfasına gidin.

   Google Cloud için Gemini'a gitme

2. Gemini Code Assist'i yönetin'i ve ardından Aboneliği yönetin'i seçin.

3. Lisans Yönetimi'ni ve ardından Otomatik Lisans Atamayı Yönet'i seçin. Otomatik lisans atamayı yönetin iletişim kutusu gösterilir.

4. Otomatik lisans yönetimini devre dışı bırak'ı seçin.

5. Değişikliği onayla'yı seçin.

Gemini Code Assist Standard ve Enterprise lisanslarını manuel olarak kaldırma

Aşağıdaki seçeneklerden birini belirtin:

Console

1. Aboneliğin sahibi olan faturalandırma hesabında aşağıdaki IAM izinlerine sahip olduğunuzu doğrulayın:

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.unassign
   • resourcemanager.projects.get

2. Gemini için Yönetici sayfasına gidin.

   Google Cloud için Gemini'a gitme

3. Gemini Code Assist'i yönetin'i ve ardından Aboneliği yönetin'i seçin.

4. Lisans Yönetimi'ni ve ardından Otomatik Lisans Atamayı Yönet'i seçin. Otomatik lisans atamayı yönetin iletişim kutusu gösterilir.

5. Lisans atamasını kaldırmak istediğiniz kullanıcıları seçin ve Lisansın atamasını kaldır'ı seçin.

6. Onayla'yı seçin.

API

Gemini Code Assist Standard ve Enterprise lisanslarının atamasını kaldırmak için billingAccounts.orders.licensePool.unassign yöntemini kullanın.

1. Bu görevi gerçekleştirmek için, lisansını atamayı kaldırmak istediğiniz lisans havuzunu içeren faturalandırma hesabında consumerprocurement.licensePools.unassign Kimlik ve Erişim Yönetimi izniniz olmalıdır.

2. Aşağıdaki bilgileri içeren bir JSON dosyası oluşturun:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   USER_EMAILS yerine, lisansın atandığı kullanıcı hesaplarının virgülle ayrılmış listesini girin (ör. "[e-mail]", "[e-mail]").

3. Yöntemi çağırmak için cURL kullanın:

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/"

   Aşağıdakini değiştirin:

   • JSON_FILE_NAME: 2. adımda oluşturduğunuz JSON dosyasının yolu.
   • PROJECT_ID: Projenin kimliği. API isteğiyle ilişkili kota kullanımı ve ücretler bu projeye uygulanır.
   • BILLING_ACCOUNT_ID: Lisans havuzuyla ilişkili faturalandırma hesabının kimliği.
   • ORDER_ID: Sipariş kimliği. Sipariş kimliğini bilmiyorsanız faturalandırma hesabınızla ilişkili siparişleri listeleyerek kimliği alabilirsiniz.

Başarılı olursa yanıt aşağıdakine benzer:

{}

Atamayı kaldırma işlemini doğrulamak için ödev listesini görüntüleyin.

Gemini Code Assist Standard ve Enterprise lisanslarını aktarma

Gemini Code Assist Standard ve Enterprise lisansları kullanıcılar arasında doğrudan aktarılamaz. Bunun yerine, kullanıcıdan lisansın atamasını kaldırın ve yeni kullanıcıya lisans atayın.

Kuruluşlar arası lisans kullanımını engelleme

Gemini Code Assist Standard ve Enterprise lisansları, kuruluşlara veya projelere değil, tek tek kullanıcılara atanır. Bu sayede kullanıcılar, Gemini Code Assist Standard ve Enterprise'ı birden fazla kuruluşta kullanabilir.

Gemini Code Assist'ten oluşturulan tüm günlükler, kullanımın gerçekleştiği projede bulunur ve lisans sahibiyle ilişkilendirilmez. Ayrıca, Gemini Code Assist'in özelleştirilmesi veya yapılandırılması (ör. kod özelleştirme) lisans veya abonelik düzeyinde değil, proje düzeyinde yapılır.

Gemini Code Assist Standard ve Enterprise'ın bir projede kuruluşlar arası kullanımını daha da önlemek için aşağıdakilerden birini yapabilirsiniz:

• Projede Google Cloud için Gemini API'yi devre dışı bırakın.
• Kullanıcıların projeye erişimini reddetmek için izinleri kullanın.

Sınırlamalar

• Google Cloud için Gemini lisans yönetimi, Workforce Identity Federation'ı desteklemez.