Управление лицензиями Gemini Code Assist Standard и Enterprise

Перед использованием Gemini Code Assist Standard и Enterprise каждому пользователю в вашей организации необходима лицензия.

По умолчанию для новых подписок требуется вручную назначать лицензии. После настройки некоторых продуктов Gemini for Google Cloud вы можете выбрать ручной или автоматический режим назначения лицензий.

Вы можете назначить лицензии любому пользователю, имеющему доступ к проекту, привязанному к соответствующему платёжному аккаунту . После назначения лицензии пользователю он сможет использовать Gemini Code Assist в любом проекте.

Прежде чем начать

  • Убедитесь, что у вас есть IAM-роли администратора учетной записи выставления счетов ( roles/billing.admin ) или администратора заказов на закупки для потребителей ( roles/consumerprocurement.orderAdmin ), чтобы вы могли предоставлять дополнительные разрешения, необходимые для учетной записи выставления счетов для выполнения определенных задач по управлению лицензиями, подробно описанных в следующих разделах.

  • Если вы хотите управлять лицензиями с помощью API, а не консоли Google API, проверьте следующее:

    • Настройте проект квоты для вашего платежного аккаунта.
    • Включите API Cloud Commerce Consumer Procurement в вашем проекте квот.
    • Убедитесь, что следующие пары «ключ-значение» заголовков присутствуют во всех вызовах API:

Изменение количества лицензий Gemini Code Assist Standard и Enterprise в подписке

Вы можете добавить или удалить количество лицензий Gemini для Google Cloud непосредственно через API Console или через представителя вашей учетной записи Google или авторизованного реселлера.

Чтобы изменить количество лицензий в подписке, выполните следующие действия:

  1. Убедитесь, что у вас есть следующие разрешения на управление идентификацией и доступом в учетной записи, которой принадлежит подписка:

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

  2. В консоли API перейдите на страницу «Администрирование Gemini» .

    Перейти на Gemini для Google Cloud

  3. Выберите подписку, которую хотите изменить, и нажмите «Изменить подписку» . Обратите внимание: если у вас активный пробный период, эта кнопка отображается как «Отключить автообновление» .

  4. Введите желаемое количество лицензий. Отобразится следующая информация:

    • Общее количество лицензий после покупки.
    • Количество лицензий, доступных для назначения после покупки.
    • Новая стоимость подписки за период. Дополнительная сумма за добавленные лицензии рассчитывается пропорционально оставшемуся времени текущего периода.

  5. Выберите Сохранить .

Просмотр назначений лицензий Gemini Code Assist Standard и Enterprise

Выберите один из следующих вариантов:

Консоль

  1. Убедитесь, что у вас есть следующие разрешения IAM для учетной записи, которой принадлежит подписка:

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

  2. Перейдите на страницу «Администрирование Gemini» и выберите проект, прикрепленный к вашей учетной записи с подпиской Gemini Code Assist Standard или Enterprise.

    Перейти на Gemini для Google Cloud

  3. Выберите подписку, которую вы хотите изменить, а затем выберите Изменить подписку .

    Для каждого пользователя, которому назначена лицензия, доступна следующая информация:

    • Имя.
    • Электронная почта.
    • Дата выдачи лицензии.
    • Дата и время последнего использования лицензии.

  4. Чтобы найти определенную группу пользователей, вы можете отфильтровать и отсортировать список следующим образом:

    • Чтобы отфильтровать список, в поле Фильтр введите свойства и значения.
    • Чтобы отсортировать список, выберите заголовок столбца, по которому нужно выполнить сортировку. Например, чтобы отсортировать список по именам пользователей в алфавитном порядке, выберите заголовок столбца «Имя» .

API

Для просмотра назначений лицензий Gemini Code Assist Standard или Enterprise используйте метод billingAccounts.orders.licensePool.enumerateLicensedUsers .

  1. Убедитесь, что у вас есть разрешение IAM consumerprocurement.licensePools.enumerateLicensedUsers для учетной записи выставления счетов, содержащей пул лицензий, назначения лицензий которого вы хотите просмотреть.

  2. Используйте 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/"

    Заменить следующее:

    • PROJECT_ID : идентификатор проекта. К этому проекту применяются квота и плата, связанная с запросом API.
    • BILLING_ACCOUNT_ID : идентификатор учетной записи для выставления счетов, связанной с пулом лицензий.
    • ORDER_ID : идентификатор заказа. Если вы не знаете идентификатор заказа, вы можете узнать его, перечислив заказы, связанные с вашим платежным аккаунтом .

Если команда выполнена успешно, она возвращает вывод licensedUsers в следующем формате:

{
  "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"
      }
  ]
}

Если нет назначений лицензий Gemini Code Assist Standard или Enterprise или ORDER_ID недействителен, возвращается вывод licensedUsers в следующем формате:

{}

Назначьте лицензии Gemini Code Assist Standard и Enterprise отдельным пользователям вручную.

Выберите один из следующих вариантов:

Консоль

  1. Убедитесь, что у вас есть следующие разрешения IAM для учетной записи, которой принадлежит подписка:

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

  2. Перейдите на страницу администратора Gemini .

    Перейти на Gemini для Google Cloud

  3. Выберите «Управление Gemini Code Assist» , а затем выберите «Изменить подписку» .

  4. Для этой подписки Gemini Code Assist Standard или Enterprise убедитесь, что для параметра «Назначение лицензий» выбрано значение « Назначать лицензии вручную ». Если для подписки Gemini Code Assist Standard или Enterprise выбрано значение «Назначать лицензии автоматически» , вы не сможете управлять отдельными лицензиями. Переключение этого платёжного аккаунта на «Назначать лицензии вручную» отключает автоматическое назначение лицензий после изменения, но уже назначенные лицензии остаются неизменными.

  5. Выберите «Добавить лицензированного пользователя» . Откроется диалоговое окно выбора пользователя. Поддерживаются только отдельные адреса электронной почты учётных записей Google, такие как @gmail.com , @googlegroups.com и домены Google Workspace. Интеграция удостоверений сотрудников (BYOID) не поддерживается.

  6. Выберите Добавить лицензированного пользователя .

  7. Убедитесь, что вы предоставили IAM-роли пользователя Gemini for Google Cloud и потребителя использования услуг лицензированным пользователям.

API

Для назначения лицензий Gemini Code Assist Standard и Enterprise используйте метод billingAccounts.orders.licensePool.assign .

  1. Убедитесь, что у вас есть следующие разрешения IAM для учетной записи выставления счетов, содержащей пул лицензий, лицензию которого вы собираетесь назначить:
  • billing.accounts.get
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.unassign
  • consumerprocurement.orders.get

  1. Создайте JSON-файл, содержащий следующую информацию:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Замените USER_EMAILS списком учётных записей пользователей, которым назначена лицензия, через запятую, например, "dana@example.com", "lee@example.com" . Поддерживаются только адреса электронной почты отдельных учётных записей Google, например @gmail.com , @googlegroups.com и домены Google Workspace. Интеграция удостоверений сотрудников (BYOID) не поддерживается.

  2. Используйте 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/"

    Заменить следующее:

    • JSON_FILE_NAME : путь к JSON-файлу, созданному на шаге 2.
    • PROJECT_ID : идентификатор проекта. К этому проекту применяются квота и плата, связанная с запросом API.
    • BILLING_ACCOUNT_ID : идентификатор учетной записи для выставления счетов, связанной с пулом лицензий.
    • ORDER_ID : идентификатор заказа. Если вы не знаете идентификатор заказа, вы можете узнать его, перечислив заказы, связанные с вашим платежным аккаунтом .

В случае успеха ответ будет примерно следующим:

{}

Для проверки задания просмотрите список заданий .

Затем убедитесь, что вы предоставили IAM-роли пользователя Gemini for Google Cloud и потребителя использования услуг лицензированным пользователям.

Автоматически назначать лицензии Gemini Code Assist Standard и Enterprise

Вы можете автоматически назначить лицензию любому пользователю в вашей организации, которому требуется доступ к Gemini Code Assist Standard или Enterprise, на странице назначения лицензий . Автоматическое назначение лицензий настраивается индивидуально для каждой подписки.

Автоматическое назначение лицензий поддерживается только в VS Code, IntelliJ и других поддерживаемых IDE JetBrains .

Если вы выбрали автоматическое назначение лицензий для Gemini Code Assist Standard или Enterprise, вы не сможете удалять или добавлять отдельные пользовательские лицензии в этой учётной записи. Пользователи с назначенными лицензиями, которые не использовали функции Gemini Code Assist Standard или Enterprise, автоматически отключаются по истечении периода бездействия, установленного администратором.

  1. В консоли API перейдите на страницу «Администрирование Gemini» .

    Перейти на Gemini для Google Cloud

  2. Выберите «Управление Gemini Code Assist» , а затем выберите «Управление подпиской» .

  3. Выберите «Управление лицензиями» , а затем « Включить автоматическое назначение лицензий» . Откроется диалоговое окно «Включить автоматическое назначение лицензий» .

    Переключение этой подписки на автоматическое назначение лицензий отключает ручное назначение лицензий после изменения, но ранее существовавшие назначения лицензий остаются неизменными.

  4. Укажите период времени, в течение которого лицензия будет отменена, если получатель неактивен, затем нажмите «Подтвердить изменение» . Откроется диалоговое окно «Автоматическое назначение лицензий включено» .

    Если вы указали T дней бездействия для отмены назначения, то лицензия(и) будет автоматически отменена и станет доступна в пуле лицензий на T+1 . Например, если вы указали 7 дней бездействия для отмены назначения, то лицензия(и) будет автоматически отменена и станет доступна в пуле лицензий на 8 день.

  5. Выберите Закрыть .

  6. Обязательно предоставьте лицензированным пользователям роли IAM «Пользователь Gemini for Google Cloud» и «Потребитель использования услуг» .

    Пользователи с разрешением cloudaicompanion.licenses.selfAssign автоматически получают лицензию при первом доступе к Gemini Code Assist Standard или Enterprise в проекте, оплаченном с помощью учетной записи выставления счетов, имеющей действующую подписку, настроенную на автоматическое назначение лицензий, и имеющую доступные лицензии, покрываемые подписками в учетной записи выставления счетов.

Чтобы отключить автоматическое назначение лицензий, выполните следующие действия:

  1. В консоли API перейдите на страницу «Администрирование Gemini» .

    Перейти на Gemini для Google Cloud

  2. Выберите «Управление Gemini Code Assist» , а затем выберите «Управление подпиской» .

  3. Выберите «Управление лицензиями» , а затем «Управление автоматическим назначением лицензий» . Откроется диалоговое окно «Управление автоматическим назначением лицензий» .

  4. Выберите Отключить автоматическое управление лицензиями .

  5. Выберите Подтвердить изменение .

Отмена лицензий Gemini Code Assist Standard и Enterprise вручную

Выберите один из следующих вариантов:

Консоль

  1. Убедитесь, что у вас есть следующие разрешения IAM для учетной записи, которой принадлежит подписка:

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

  2. Перейдите на страницу администратора Gemini .

    Перейти на Gemini для Google Cloud

  3. Выберите «Управление Gemini Code Assist» , а затем выберите «Управление подпиской» .

  4. Выберите «Управление лицензиями» , а затем «Управление автоматическим назначением лицензий» . Откроется диалоговое окно «Управление автоматическим назначением лицензий» .

  5. Выберите пользователей, для которых вы хотите отменить назначение лицензий, затем выберите Отменить назначение лицензии .

  6. Выберите Подтвердить .

API

Чтобы отменить назначение лицензий Gemini Code Assist Standard и Enterprise, используйте метод billingAccounts.orders.licensePool.unassign .

  1. Для выполнения этой задачи у вас должно быть разрешение consumerprocurement.licensePools.unassign на управление идентификацией и доступом в учетной записи выставления счетов, содержащей пул лицензий, лицензию которого вы собираетесь отменить.

  2. Создайте JSON-файл, содержащий следующую информацию:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Замените USER_EMAILS списком учетных записей пользователей, разделенных запятыми, которым назначена лицензия, например, "dana@example.com", "lee@example.com" .

  3. Используйте 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/"

    Заменить следующее:

    • JSON_FILE_NAME : путь к JSON-файлу, созданному на шаге 2.
    • PROJECT_ID : идентификатор проекта. К этому проекту применяются квота и плата, связанная с запросом API.
    • BILLING_ACCOUNT_ID : идентификатор учетной записи для выставления счетов, связанной с пулом лицензий.
    • ORDER_ID : идентификатор заказа. Если вы не знаете идентификатор заказа, вы можете узнать его, перечислив заказы, связанные с вашим платежным аккаунтом .

В случае успеха ответ будет примерно следующим:

{}

Чтобы проверить отмену назначения, просмотрите список назначений .

Перенос лицензий Gemini Code Assist Standard и Enterprise

Лицензии Gemini Code Assist Standard и Enterprise нельзя передавать напрямую между пользователями. Вместо этого отмените назначение лицензии пользователю, а затем назначьте лицензию новому пользователю.

Предотвратить использование лицензий между организациями

Лицензии Gemini Code Assist Standard и Enterprise назначаются отдельным пользователям, а не организациям или проектам, что позволяет отдельным пользователям использовать Gemini Code Assist Standard и Enterprise в нескольких организациях.

Все журналы, создаваемые при использовании Gemini Code Assist, хранятся в проекте, в котором произошло использование, а не у лицензиата. Кроме того, любая настройка или конфигурирование Gemini Code Assist (например, настройка кода ) выполняется на уровне проекта, а не на уровне лицензии или подписки.

Чтобы еще больше предотвратить межорганизационное использование Gemini Code Assist Standard и Enterprise в проекте, вы можете выполнить одно из следующих действий:

  • Отключите API Gemini для Google Cloud в проекте.
  • Используйте разрешения, чтобы запретить пользователю доступ к проекту.

Ограничения