Zarządzanie licencjami Gemini Code Assist Standard i Enterprise

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.

  • Jeśli chcesz zarządzać licencjami za pomocą interfejsu API, a nie konsoli interfejsów API Google, sprawdź, czy:

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:

  1. 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
  2. W Konsoli interfejsów API otwórz stronę Administrator Gemini.

    Otwórz Gemini w Google Cloud

  3. 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.

  4. 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.
  5. Kliknij Zapisz.

Wyświetlanie przypisań licencji na Gemini Code Assist Standard i Enterprise

Wybierz jedną z tych opcji:

Konsola

  1. 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
  2. Otwórz stronę Administrator Gemini i wybierz projekt powiązany z kontem rozliczeniowym z subskrypcją Gemini Code Assist Standard lub Enterprise.

    Otwórz Gemini w Google Cloud

  3. 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.
  4. 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.

  1. Sprawdź, czy masz uprawnienia IAM na koncie rozliczeniowym, które zawiera pulę licencji, której przypisania chcesz wyświetlić.consumerprocurement.licensePools.enumerateLicensedUsers

  2. 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

  1. 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
  2. Otwórz stronę Administracja Gemini.

    Otwórz Gemini w Google Cloud

  3. Kliknij Zarządzaj Gemini Code Assist, a następnie wybierz Zmień subskrypcję.

  4. 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.

  5. 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.

  6. Kliknij Dodaj licencjonowanego użytkownika.

  7. 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.assignmetody.

  1. 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
  1. 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.

  2. 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.

  1. W Konsoli interfejsów API otwórz stronę Administrator Gemini.

    Otwórz Gemini w Google Cloud

  2. Wybierz Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.

  3. 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.

  4. 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 dniu T+1. Jeśli na przykład skonfigurujesz 7 dni nieaktywności przed cofnięciem przypisania, licencje zostaną cofnięte i będą dostępne w puli licencji w dniu 8.

  5. Wybierz Zamknij.

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

  1. W Konsoli interfejsów API otwórz stronę Administrator Gemini.

    Otwórz Gemini w Google Cloud

  2. Kliknij Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.

  3. Wybierz Zarządzanie licencjami, a następnie Zarządzaj automatycznym przypisywaniem licencji. Pojawi się okno Zarządzaj automatycznym przypisywaniem licencji.

  4. Kliknij Wyłącz automatyczne zarządzanie licencjami.

  5. Kliknij Potwierdź zmianę.

Ręczne cofanie przypisania licencji na Gemini Code Assist Standard i Enterprise

Wybierz jedną z tych opcji:

Konsola

  1. 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
  2. Otwórz stronę Administracja Gemini.

    Otwórz Gemini w Google Cloud

  3. Kliknij Zarządzaj Gemini Code Assist, a następnie Zarządzaj subskrypcją.

  4. Wybierz Zarządzanie licencjami, a następnie Zarządzaj automatycznym przypisywaniem licencji. Pojawi się okno Zarządzaj automatycznym przypisywaniem licencji.

  5. Wybierz użytkowników, którym chcesz cofnąć przypisanie licencji, a następnie kliknij Cofnij przypisanie licencji.

  6. Kliknij Potwierdź.

Interfejs API

Aby cofnąć przypisanie licencji Gemini Code Assist Standard i Enterprise, użyj metody billingAccounts.orders.licensePool.unassign.

  1. 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.

  2. 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".

  3. 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