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ć dowolnym użytkownikom, 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 skonfigurowaną usługę Gemini Code Assist.
Jeśli chcesz zarządzać licencjami za pomocą interfejsu API, a nie konsoli Google Cloud, sprawdź, czy:
- Skonfiguruj projekt limitów na potrzeby konta rozliczeniowego.
- Włącz Cloud Commerce Consumer Procurement API w projekcie dotyczącym limitu.
- Sprawdź, czy w przypadku wszystkich wywołań 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ć i usuwać bezpośrednio w konsoli Google Cloud lub za pośrednictwem przedstawiciela konta Google albo 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.getconsumerprocurement.orders.getconsumerprocurement.orders.modifyresourcemanager.projects.get
W konsoli Google Cloud otwórz stronę Administrator Gemini.
Wybierz subskrypcję, którą chcesz zmienić, a następnie kliknij Zmień subskrypcję. Jeśli korzystasz z okresu próbnego, ten przycisk będzie miał nazwę 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.getconsumerprocurement.orders.getconsumerprocurement.licensePools.getconsumerprocurement.licensePools.enumerateLicensedUsersresourcemanager.projects.get
Otwórz stronę Administracja Gemini i wybierz projekt dołączony do konta rozliczeniowego 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.enumerateLicensedUsersAby 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 zadziała, 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 wynik 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.getconsumerprocurement.orders.getconsumerprocurement.licensePools.getconsumerprocurement.licensePools.enumerateLicensedUsersconsumerprocurement.licensePools.assignresourcemanager.projects.get
Otwórz stronę Administracja Gemini.
Kliknij Zarządzaj Gemini Code Assist, a następnie 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.comi 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 tej metody.
- Sprawdź, czy masz te uprawnienia IAM na koncie rozliczeniowym, które zawiera pulę licencji, z której chcesz przypisać licencję:
billing.accounts.getconsumerprocurement.licensePools.assignconsumerprocurement.licensePools.getconsumerprocurement.licensePools.unassignconsumerprocurement.orders.get
Utwórz plik JSON zawierający te informacje:
{ "usernames": [ USER_EMAILS ] }Zastąp
USER_EMAILSlistą kont użytkowników oddzielonych przecinkami, którym przypisywana jest licencja, np."dana@example.com", "lee@example.com". Obsługiwane są tylko adresy e-mail indywidualnych kont Google, takie jak@gmail.com,@googlegroups.comi 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 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ć licencji poszczególnych 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 Google Cloud otwórz stronę Administrator Gemini.
Kliknij 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 Automatyczne przypisywanie licencji zostało włączone.
Jeśli skonfigurowano
Tdni 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 skonfigurujesz7dni 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.selfAssignautomatycznie 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, wykonaj te czynności:
W konsoli Google Cloud otwórz stronę Administrator Gemini.
Kliknij Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.
Kliknij 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.getconsumerprocurement.orders.getconsumerprocurement.licensePools.getconsumerprocurement.licensePools.enumerateLicensedUsersconsumerprocurement.licensePools.unassignresourcemanager.projects.get
Otwórz stronę Administracja Gemini.
Kliknij Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.
Kliknij 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.unassignIdentity 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_EMAILSlistą 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 używaniu 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 użytkownikom 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.