Aby móc korzystać z Gemini Code Assist, 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 for Google Cloud możesz przypisywać licencje ręcznie lub automatycznie.
Zanim zaczniesz
- Upewnij się, że masz rolę administratora konta rozliczeniowego (
roles/billing.admin
) lub administratora zamówienia na potrzeby konsumenta (roles/consumerprocurement.orderAdmin
), aby móc przyznać dodatkowe uprawnienia na koncie rozliczeniowym wymagane do wykonywania określonych zadań związanych z zarządzaniem licencjami, o których mowa w kolejnych sekcjach.
- Jeśli chcesz zarządzać licencjami za pomocą interfejsu API zamiast konsoli Google Cloud, musisz:
- Skonfiguruj projekt limitu na swoim koncie rozliczeniowym.
- Włącz interfejs Cloud Commerce Consumer Procurement API w projekcie z limitem.
- Upewnij się, że we wszystkich wywołaniach interfejsu API występują te pary klucz-wartość nagłówka:
Authorization
: token dostępu do Google Cloud z Google Cloud CLIx-goog-user-project
: identyfikator projektu z limitem
Zmiana liczby licencji na Gemini Code Assist w subskrypcji
Licencje Gemini for Google Cloud możesz dodawać i usuwać bezpośrednio w konsoli Google Cloud lub za pomocą przedstawiciela konta Google lub autoryzowanego sprzedawcy.
Aby zmienić liczbę licencji w subskrypcji:
Sprawdź, czy na koncie rozliczeniowym, które jest właścicielem subskrypcji, masz te uprawnienia zarządzania tożsamości i dostępem:
billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.orders.modify
resourcemanager.projects.get
W konsoli Google Cloud otwórz stronę Administracja Gemini.
Wybierz subskrypcję, którą chcesz zmienić, a potem kliknij Modyfikuj subskrypcję.
Wpisz liczbę licencji, które chcesz mieć. Wyświetlają się te informacje:
- Łączna liczba licencji po zakupie.
- Liczba licencji do przypisania po zakupie.
- Nowa cena subskrypcji na okres. Dodatkowa kwota za dodane licencje jest proporcjonalnie dzielona na podstawie czasu pozostałego w bieżącym okresie.
Kliknij Zapisz.
Wyświetlanie przypisań licencji na Gemini Code Assist
Wybierz jedną z tych opcji:
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ę Administracja Gemini.
Wybierz subskrypcję, którą chcesz zmienić, a potem kliknij Modyfikuj 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.
Aby wyświetlić przypisania licencji Gemini Code Assist, użyj metody billingAccounts.orders.licensePool.enumerateLicensedUsers
.
Aby wykonać to zadanie, musisz mieć uprawnieniaconsumerprocurement.licensePools.enumerateLicensedUsers
do konta rozliczeniowego, które jest właścicielem subskrypcji.
GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID /orders/ORDER_ID /licensePool:enumerateLicensedUsers/
Zastąp następujące elementy:
BILLING_ACCOUNT_ID
: identyfikator konta rozliczeniowegoORDER_ID
: zasady uprawnień
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 przypisanych licencji na Gemini Code Assist lub ORDER_ID
jest nieprawidłowy, zwraca wyjście licensedUsers
w tym formacie:
{}
Ręczne przypisywanie licencji Gemini Code Assist poszczególnym użytkownikom
Wybierz jedną z tych opcji:
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 Modyfikuj subskrypcję.
W przypadku tej subskrypcji Gemini Code Assist ustaw opcję Przypisywanie licencji na Ręczne przypisywanie licencji. Jeśli subskrypcja Gemini Code Assist jest skonfigurowana tak, aby automatycznie przypisywać licencje, nie możesz zarządzać poszczególnymi licencjami. Przełączenie tego konta rozliczeniowego na opcję Ręczne przypisywanie licencji spowoduje wyłączenie automatycznego przypisywania licencji po wprowadzeniu tej zmiany, ale nie wpłynie to na wcześniej przypisane licencje.
Kliknij Przypisz licencje. Pojawi się okno wyboru użytkownika. Aby wyszukać konkretnych użytkowników, wpisz ich adresy e-mail, a następnie kliknij Dalej.
Kliknij Przypisz licencje.
Upewnij się, że przypisz użytkownikom role uprawnień użytkownika Gemini for Google Cloud i konsumenta wykorzystania usługi.
Aby przypisać licencje na Gemini Code Assist, użyj billingAccounts.orders.licensePool.assign
metody.
Aby wykonać to zadanie, musisz mieć te uprawnienia do konta rozliczeniowego, które jest właścicielem subskrypcji:
billing.accounts.get
consumerprocurement.licensePools.assign
consumerprocurement.licensePools.get
consumerprocurement.licensePools.unassign
consumerprocurement.orders.get
POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID /orders/ORDER_ID /licensePool:assign/
{
"usernames": [
"dana@example.com",
"lee@example.com"
]
}
Zastąp następujące elementy:
BILLING_ACCOUNT_ID
: identyfikator konta rozliczeniowegoORDER_ID
: zasady uprawnień
Jeśli polecenie się powiedzie, zwróci pustą treść odpowiedzi w tym formacie:
{}
Aby sprawdzić projekt, wyświetl listę projektów.
Następnie upewnij się, że przypisz użytkownikom rolę użytkownika Gemini for Google Cloud oraz rolę konsumenta wykorzystania usługi.
Automatyczne przypisywanie licencji na Gemini Code Assist
Licencję możesz automatycznie przypisać każdemu użytkownikowi w organizacji, który potrzebuje dostępu do Gemini Code Assist na stronie Przypisywanie licencji. Automatyczne przypisywanie licencji jest ustawiane osobno dla każdej subskrypcji.
Jeśli zdecydujesz się na automatyczne przypisywanie licencji na Gemini Code Assist, nie będzie można usuwać ani dodawać licencji dla poszczególnych użytkowników na tym koncie. Użytkownicy z przypisanymi licencjami, którzy nie korzystali z żadnych funkcji Gemini Code Assist, zostaną automatycznie wyrezerwowani pod koniec okresu rozliczeniowego po upływie określonej przez administratora liczby dni bezczynności.
W konsoli Google Cloud otwórz stronę Administracja Gemini.
Kliknij Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.
Kliknij kolejno Zarządzanie licencjami i Włącz automatyczne przypisywanie licencji. Pojawi się okno Włącz automatyczne licencje.
Po przejściu na automatyczne przypisywanie licencji subskrypcja przestaje przypisywać licencje ręcznie, ale nie ma to wpływu na wcześniej przypisane licencje.
Określ czas, przez jaki licencja ma być nieprzypisana, jeśli osoba przypisana jest nieaktywna, a następnie kliknij Potwierdź zmianę. Wyświetli się okno Automatyczne przypisywanie licencji zostało włączone.
Kliknij Zamknij.
Upewnij się, że przypisz użytkownikom role uprawnień użytkownika Gemini for Google Cloud i konsumenta wykorzystania usługi.
Użytkownicy z uprawnieniami
cloudaicompanion.licenses.selfAssign
automatycznie otrzymują licencję, gdy po raz pierwszy otwierają Gemini Code Assist w projekcie opłacanym z konta rozliczeniowego, na którym jest prawidłowa subskrypcja skonfigurowana pod kątem automatycznego przypisywania licencji i która zawiera dostępne licencje objęte subskrypcjami na koncie rozliczeniowym.
Aby wyłączyć automatyczne przypisywanie licencji:
W konsoli Google Cloud otwórz stronę Administracja Gemini.
Kliknij Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.
Kliknij kolejno Zarządzanie licencjami i Zarządzaj automatycznym przypisywaniem licencji. Pojawi się okno Zarządzaj automatycznym przypisywaniem licencji.
Wybierz Wyłącz automatyczne zarządzanie licencjami.
Kliknij Potwierdź zmianę.
Ręczne odpisywanie licencji Gemini Code Assist
Wybierz jedną z tych opcji:
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ą.
Kliknij kolejno Zarządzanie licencjami i Zarządzaj automatycznym przypisywaniem licencji. Pojawi się okno Zarządzaj automatycznym przypisywaniem licencji.
Wybierz użytkowników, których licencje chcesz odłączyć, a następnie wybierz Odłącz licencję.
Wybierz Potwierdź.
Aby odzyskać licencję na Gemini Code Assist, użyj metody billingAccounts.orders.licensePool.unassign
.
Aby wykonać to zadanie, musisz mieć uprawnieniaconsumerprocurement.licensePools.unassign
do konta rozliczeniowego, które jest właścicielem subskrypcji.
POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID /orders/ORDER_ID /licensePool:unassign/
{
"usernames": [
"dana@example.com",
"lee@example.com"
]
}
Zastąp następujące elementy:
BILLING_ACCOUNT_ID
: identyfikator konta rozliczeniowegoORDER_ID
: zasady uprawnień
Jeśli polecenie się powiedzie, zwróci pustą treść odpowiedzi w tym formacie:
{}
Aby sprawdzić, czy projekt nie jest już przypisany, wyświetl listę projektów.
Przenoszenie licencji na Gemini Code Assist
Licencji na Gemini Code Assist nie można przenosić bezpośrednio między użytkownikami. Zamiast tego zwolnij licencję z użytkownika, a następnie przypisz ją nowemu użytkownikowi.
Zapobieganie używaniu licencji w wielu organizacjach
Licencje Gemini Code Assist są przypisywane poszczególnym użytkownikom, a nie organizacjom ani projektom, co pozwala użytkownikom korzystać z Gemini Code Assist w wielu organizacjach.
Wszystkie logi wygenerowane przez Gemini Code Assist są powiązane z projektem, w którym nastąpiło wykorzystanie, a nie z licencją. Dodatkowo wszelkie dostosowywanie lub konfigurowanie Gemini Code Assist (np. dostosowywanie kodu) odbywa się na poziomie projektu, a nie na poziomie licencji ani subskrypcji.
Aby dodatkowo uniemożliwić korzystanie z Gemini Code Assist w projekcie przez inne organizacje, wykonaj 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
- Gemini do zarządzania licencjami Google Cloud nie obsługuje federacji tożsamości pracowników.