Aby móc korzystać z Gemini Code Assist w wersji Standard i Enterprise, każdy użytkownik w organizacji musi mieć licencję.
Domyślnie nowe subskrypcje wymagają ręcznego przypisania licencji. Po skonfigurowaniu niektórych usług Gemini w Google Cloud możesz przypisywać licencje ręcznie lub automatycznie.
Licencje możesz przypisywać do wszystkich użytkowników, którzy mają dostęp do projektu połączonego z odpowiednim kontem rozliczeniowym. Po przypisaniu licencji użytkownik może korzystać z Gemini Code Assist w dowolnym projekcie.
Zanim zaczniesz
Sprawdź, czy masz role uprawnień administrator konta rozliczeniowego (
roles/billing.admin
) lub administrator zamówień konsumenckich (roles/consumerprocurement.orderAdmin
), aby móc przyznawać dodatkowe uprawnienia wymagane na koncie rozliczeniowym do wykonywania określonych zadań związanych z zarządzaniem licencjami, które zostały opisane w kolejnych sekcjach.- Sprawdź, czy masz skonfigurowane Gemini Code Assist.
Jeśli chcesz zarządzać licencjami za pomocą interfejsu API, a nie konsoli interfejsów API Google, sprawdź, czy:
- Skonfiguruj projekt limitu na potrzeby konta rozliczeniowego.
- Włącz Cloud Commerce Consumer Procurement API w projekcie dotyczącym limitu.
- Sprawdź, czy we wszystkich wywołaniach interfejsu API występują te pary klucz-wartość w nagłówku:
Authorization
: Twój token dostępu do Google Cloud z Google Cloud CLI.x-goog-user-project
: identyfikator projektu limitu
Zmienianie liczby licencji Gemini Code Assist Standard i Enterprise w subskrypcji
Liczbę licencji na Gemini w Google Cloud możesz dodawać lub usuwać bezpośrednio w konsoli interfejsu API albo za pomocą przedstawiciela konta Google lub autoryzowanego sprzedawcy.
Aby zmienić liczbę licencji w subskrypcji:
Sprawdź, czy masz na koncie rozliczeniowym, do którego należy subskrypcja, te uprawnienia Identity and Access Management:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.orders.modify
resourcemanager.projects.get
W Konsoli interfejsów API otwórz stronę Administrator Gemini.
Wybierz subskrypcję, którą chcesz zmienić, a następnie kliknij Zmień subskrypcję. Jeśli korzystasz z aktywnego okresu próbnego, ten przycisk będzie wyświetlany jako Wyłącz automatyczne odnawianie.
Wpisz liczbę licencji, które chcesz mieć. Wyświetlane są te informacje:
- Łączna liczba licencji po zakupie.
- Liczba licencji dostępnych do przypisania po zakupie.
- Nowa cena subskrypcji za okres. Dodatkowa kwota za dodane licencje jest obliczana proporcjonalnie na podstawie czasu pozostałego do końca bieżącego okresu.
Kliknij Zapisz.
Wyświetlanie przypisań licencji na Gemini Code Assist Standard i Enterprise
Wybierz jedną z tych opcji:
Konsola
Sprawdź, czy masz te uprawnienia IAM na koncie rozliczeniowym, które jest właścicielem subskrypcji:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
resourcemanager.projects.get
Otwórz stronę Administrator Gemini i wybierz projekt powiązany z kontem rozliczeniowym z subskrypcją Gemini Code Assist Standard lub Enterprise.
Wybierz subskrypcję, którą chcesz zmienić, a następnie kliknij Zmień subskrypcję.
O każdym użytkowniku, któremu przypisano licencję, dostępne są te informacje:
- Nazwa.
- E-mail.
- Data przypisania licencji.
- Data i godzina ostatniego użycia licencji.
Aby znaleźć konkretny zestaw użytkowników, możesz przefiltrować i posortować listę w ten sposób:
- Aby przefiltrować listę, w polu Filtr wpisz właściwości i wartości.
- Aby posortować listę, kliknij nagłówek kolumny, według której chcesz to zrobić. Aby na przykład posortować listę alfabetycznie według nazw użytkowników, kliknij nagłówek kolumny Nazwa.
Interfejs API
Aby wyświetlić przypisania licencji Gemini Code Assist Standard lub Enterprise, użyj metody billingAccounts.orders.licensePool.enumerateLicensedUsers
.
Sprawdź, czy masz uprawnienia IAM na koncie rozliczeniowym, które zawiera pulę licencji, której przypisania chcesz wyświetlić.
consumerprocurement.licensePools.enumerateLicensedUsers
Aby wywołać metodę, użyj
cURL
: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/"
Zastąp następujące elementy:
- PROJECT_ID: identyfikator projektu. Wykorzystanie limitu i opłaty związane z żądaniem interfejsu API są naliczane w tym projekcie.
BILLING_ACCOUNT_ID
: identyfikator konta rozliczeniowego powiązanego z pulą licencji.ORDER_ID
: identyfikator zamówienia. Jeśli nie znasz identyfikatora zamówienia, możesz go odzyskać, wyświetlając listę zamówień powiązanych z Twoim kontem rozliczeniowym.
Jeśli polecenie się powiedzie, zwróci dane wyjściowe licensedUsers
w tym formacie:
{
"licensedUsers": [
{
"username": "dana@example.com",
"assignTime": "2024-09-26T16:24:40.559222Z"
},
{
"username": "lee@example.com",
"assignTime": "2024-09-26T16:24:40.559222Z"
},
{
"username": "taylor@example.com",
"assignTime": "2024-09-26T16:24:40.559222Z"
},
{
"username": "bola@example.com",
"assignTime": "2024-09-26T16:24:14.610828Z"
}
]
}
Jeśli nie ma przypisań licencji Gemini Code Assist Standard lub Enterprise albo ORDER_ID
jest nieprawidłowy, zwraca licensedUsers
w tym formacie:
{}
Ręczne przypisywanie licencji Gemini Code Assist Standard i Enterprise poszczególnym użytkownikom
Wybierz jedną z tych opcji:
Konsola
Sprawdź, czy masz te uprawnienia IAM na koncie rozliczeniowym, które jest właścicielem subskrypcji:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign
resourcemanager.projects.get
Otwórz stronę Administracja Gemini.
Kliknij Zarządzaj Gemini Code Assist, a następnie wybierz Zmień subskrypcję.
W przypadku tej subskrypcji Gemini Code Assist Standard lub Enterprise sprawdź, czy w sekcji Przypisywanie licencji ustawiono opcję Ręczne przypisywanie licencji. Jeśli subskrypcja Gemini Code Assist Standard lub Enterprise jest ustawiona na Automatyczne przypisywanie licencji, nie możesz zarządzać poszczególnymi licencjami. Przełączenie tego konta rozliczeniowego na Ręczne przypisywanie licencji wyłącza automatyczne przypisywanie licencji po wprowadzeniu zmiany, ale nie wpływa na wcześniej przypisane licencje.
Kliknij Dodaj licencjonowanego użytkownika. Pojawi się okno wyboru użytkownika. Obsługiwane są tylko adresy e-mail powiązane z indywidualnymi kontami Google, takie jak
@gmail.com
,@googlegroups.com
i domeny Google Workspace. Federacja tożsamości pracowników (BYOID) nie jest obsługiwana.Kliknij Dodaj licencjonowanego użytkownika.
Sprawdź, czy użytkownikom przypisane są role użytkownika Gemini for Google Cloud i konsumenta wykorzystania usług.
Interfejs API
Aby przypisać licencje Gemini Code Assist Standard i Enterprise, użyj billingAccounts.orders.licensePool.assign
metody.
- Sprawdź, czy masz te uprawnienia IAM na koncie rozliczeniowym, które zawiera pulę licencji, z której chcesz przypisać licencję:
billing.accounts.get
consumerprocurement.licensePools.assign
consumerprocurement.licensePools.get
consumerprocurement.licensePools.unassign
consumerprocurement.orders.get
Utwórz plik JSON zawierający te informacje:
{ "usernames": [ USER_EMAILS ] }
Zastąp
USER_EMAILS
listą kont użytkowników oddzielonych przecinkami, którym przypisujesz licencję, np."dana@example.com", "lee@example.com"
. Obsługiwane są tylko adresy e-mail indywidualnych kont Google, takie jak@gmail.com
,@googlegroups.com
i domeny Google Workspace. Federacja tożsamości pracowników (BYOID) nie jest obsługiwana.Aby wywołać metodę, użyj
cURL
: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/"
Zastąp następujące elementy:
JSON_FILE_NAME
: ścieżka do pliku JSON utworzonego w kroku 2.- PROJECT_ID: identyfikator projektu. Wykorzystanie limitu i opłaty związane z żądaniem interfejsu API są naliczane w tym projekcie.
BILLING_ACCOUNT_ID
: identyfikator konta rozliczeniowego powiązanego z pulą licencji.ORDER_ID
: identyfikator zamówienia. Jeśli nie znasz identyfikatora zamówienia, możesz go odzyskać, wyświetlając listę zamówień powiązanych z Twoim kontem rozliczeniowym.
Jeśli operacja się uda, odpowiedź będzie podobna do tej:
{}
Aby sprawdzić, czy projekt został przypisany, wyświetl listę projektów.
Następnie sprawdź, czy użytkownikom z licencją przypisano role użytkownika Gemini for Google Cloud i konsumenta wykorzystania usług.
Automatyczne przypisywanie licencji Gemini Code Assist Standard i Enterprise
Licencję możesz automatycznie przypisać każdemu użytkownikowi w organizacji, który potrzebuje dostępu do Gemini Code Assist w wersji Standard lub Enterprise, na stronie Przypisywanie licencji. Automatyczne przypisywanie licencji jest konfigurowane oddzielnie dla każdej subskrypcji.
Automatyczne przypisywanie licencji jest obsługiwane tylko w VS Code, IntelliJ i innych obsługiwanych środowiskach IDE JetBrains.
Jeśli włączysz automatyczne przypisywanie licencji na Gemini Code Assist w wersji Standard lub Enterprise, nie możesz usuwać ani dodawać pojedynczych licencji użytkowników na tym koncie. Użytkownicy z przypisanymi licencjami, którzy nie korzystali z żadnych funkcji Gemini Code Assist Standard lub Enterprise, są automatycznie pozbawiani dostępu do tych funkcji po upływie okresu nieaktywności określonego przez administratora.
W Konsoli interfejsów API otwórz stronę Administrator Gemini.
Wybierz Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.
Wybierz Zarządzanie licencjami, a następnie Włącz automatyczne przypisywanie licencji. Pojawi się okno Włącz automatyczne licencje.
Przełączenie tej subskrypcji na automatyczne przypisywanie licencji spowoduje wyłączenie ręcznego przypisywania licencji po dokonaniu zmiany, ale nie wpłynie na istniejące przypisania licencji.
Ustaw czas, po którym licencja zostanie cofnięta, jeśli przypisana osoba jest nieaktywna, a następnie kliknij Potwierdź zmianę. Pojawi się okno dialogowe Automatyczne przypisywanie licencji zostało włączone.
Jeśli skonfigurowano
T
dni nieaktywności, po których następuje anulowanie przypisania, licencje są automatycznie anulowane i dostępne w puli licencji w dniuT+1
. Jeśli na przykład skonfigurujesz7
dni nieaktywności przed cofnięciem przypisania, licencje zostaną cofnięte i będą dostępne w puli licencji w dniu8
.Wybierz Zamknij.
Upewnij się, że użytkownikom, którzy mają licencję, przypiszesz role użytkownika Gemini for Google Cloud i konsumenta wykorzystania usług.
Użytkownicy z uprawnieniem
cloudaicompanion.licenses.selfAssign
automatycznie otrzymują licencję, gdy po raz pierwszy uzyskują dostęp do Gemini Code Assist w wersji Standard lub Enterprise w projekcie opłacanym z konta rozliczeniowego, które ma ważną subskrypcję skonfigurowaną pod kątem automatycznego przypisywania licencji i ma dostępne licencje objęte subskrypcjami na koncie rozliczeniowym.
Aby wyłączyć automatyczne przypisywanie licencji:
W Konsoli interfejsów API otwórz stronę Administrator Gemini.
Kliknij Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.
Wybierz Zarządzanie licencjami, a następnie Zarządzaj automatycznym przypisywaniem licencji. Pojawi się okno Zarządzaj automatycznym przypisywaniem licencji.
Kliknij Wyłącz automatyczne zarządzanie licencjami.
Kliknij Potwierdź zmianę.
Ręczne cofanie przypisania licencji na Gemini Code Assist Standard i Enterprise
Wybierz jedną z tych opcji:
Konsola
Sprawdź, czy masz te uprawnienia IAM na koncie rozliczeniowym, które jest właścicielem subskrypcji:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.unassign
resourcemanager.projects.get
Otwórz stronę Administracja Gemini.
Kliknij Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.
Wybierz Zarządzanie licencjami, a następnie Zarządzaj automatycznym przypisywaniem licencji. Pojawi się okno Zarządzaj automatycznym przypisywaniem licencji.
Wybierz użytkowników, którym chcesz cofnąć przypisanie licencji, a następnie kliknij Cofnij przypisanie licencji.
Kliknij Potwierdź.
Interfejs API
Aby cofnąć przypisanie licencji Gemini Code Assist Standard i Enterprise, użyj metody billingAccounts.orders.licensePool.unassign
.
Aby wykonać to zadanie, musisz mieć uprawnienie
consumerprocurement.licensePools.unassign
Identity and Access Management na koncie rozliczeniowym, które zawiera pulę licencji, z której chcesz cofnąć przypisanie licencji.Utwórz plik JSON zawierający te informacje:
{ "usernames": [ USER_EMAILS ] }
Zastąp
USER_EMAILS
listą kont użytkowników oddzielonych przecinkami, do których przypisana jest licencja, np."dana@example.com", "lee@example.com"
.Aby wywołać metodę, użyj
cURL
: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/"
Zastąp następujące elementy:
JSON_FILE_NAME
: ścieżka do pliku JSON utworzonego w kroku 2.- PROJECT_ID: identyfikator projektu. Wykorzystanie limitu i opłaty związane z żądaniem interfejsu API są naliczane w tym projekcie.
BILLING_ACCOUNT_ID
: identyfikator konta rozliczeniowego powiązanego z pulą licencji.ORDER_ID
: identyfikator zamówienia. Jeśli nie znasz identyfikatora zamówienia, możesz go odzyskać, wyświetlając listę zamówień powiązanych z Twoim kontem rozliczeniowym.
Jeśli operacja się uda, odpowiedź będzie podobna do tej:
{}
Aby sprawdzić, czy przypisanie zostało usunięte, wyświetl listę przypisań.
Przenoszenie licencji na Gemini Code Assist Standard i Enterprise
Licencji Gemini Code Assist Standard i Enterprise nie można przenosić bezpośrednio między użytkownikami. Zamiast tego cofnij przypisanie licencji użytkownikowi, a następnie przypisz licencję nowemu użytkownikowi.
Zapobieganie korzystaniu z licencji w różnych organizacjach
Licencje Gemini Code Assist Standard i Enterprise są przypisywane poszczególnym użytkownikom, a nie organizacjom ani projektom, co umożliwia korzystanie z Gemini Code Assist Standard i Enterprise w wielu organizacjach.
Wszelkie logi wygenerowane na podstawie korzystania z Gemini Code Assist są powiązane z projektem, w którym nastąpiło użycie, a nie z licencjobiorcą. Dodatkowo wszelkie dostosowywanie lub konfigurowanie Gemini Code Assist (np. dostosowywanie kodu) odbywa się na poziomie projektu, a nie licencji lub subskrypcji.
Aby dodatkowo zapobiec korzystaniu z Gemini Code Assist w wersji Standard i Enterprise w projekcie przez osoby z różnych organizacji, możesz wykonać jedną z tych czynności:
- Wyłącz interfejs Gemini for Google Cloud API w projekcie.
- Użyj uprawnień, aby odmówić użytkownikowi dostępu do projektu.
Ograniczenia
- Zarządzanie licencjami Gemini w Google Cloud nie obsługuje federacji tożsamości pracowników.