Trang này được dịch bởi Cloud Translation API.

Quản lý giấy phép Gemini Code Assist

Trước khi sử dụng tính năng Trợ giúp mã của Gemini, mỗi người dùng trong tổ chức của bạn cần có một giấy phép.

Theo mặc định, các gói thuê bao mới yêu cầu bạn phải chỉ định giấy phép theo cách thủ công. Sau khi thiết lập một số sản phẩm Gemini cho Google Cloud, bạn có thể chọn chỉ định giấy phép theo cách thủ công hoặc tự động.

Trước khi bắt đầu

Đảm bảo rằng bạn có vai trò IAM là Quản trị viên tài khoản thanh toán (roles/billing.admin) hoặc Quản trị viên đơn đặt hàng của người tiêu dùng (roles/consumerprocurement.orderAdmin) để có thể cấp các quyền bổ sung cần thiết trên tài khoản thanh toán cho các nhiệm vụ quản lý giấy phép cụ thể được nêu chi tiết trong các phần sau.

Nếu bạn muốn quản lý giấy phép bằng API thay vì Google Cloud Console, hãy đảm bảo những điều sau:
- Thiết lập một dự án hạn mức cho tài khoản thanh toán của bạn.
- Bật Cloud Commerce Consumer Procurement API trong dự án hạn mức của bạn.
- Đảm bảo các cặp khoá-giá trị tiêu đề sau đây xuất hiện trên tất cả lệnh gọi API:
  - Authorization: Mã truy cập Google Cloud của bạn từ Google Cloud CLI
  - x-goog-user-project: mã dự án của dự án có hạn mức

Thay đổi số lượng giấy phép Gemini Code Assist trong một gói thuê bao

Bạn có thể thêm hoặc xoá số lượng giấy phép Gemini cho Google Cloud trực tiếp thông qua bảng điều khiển Google Cloud, hoặc thông qua người đại diện tài khoản Google hoặc đại lý được uỷ quyền.

Để thay đổi số lượng giấy phép trong một gói thuê bao, hãy làm theo các bước sau:

Đảm bảo rằng bạn có các quyền sau đây trong tính năng Quản lý danh tính và quyền truy cập trên tài khoản thanh toán sở hữu gói thuê bao:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.orders.modify
- resourcemanager.projects.get
Trong Google Cloud Console, hãy chuyển đến trang Quản trị viên cho Gemini.

Chuyển đến Gemini cho Google Cloud
Chọn gói thuê bao bạn muốn thay đổi, sau đó chọn Sửa đổi gói thuê bao.
Nhập số lượng giấy phép bạn muốn mua. Thông tin sau đây sẽ xuất hiện:
- Tổng số giấy phép sau khi mua.
- Số lượng giấy phép có thể chỉ định sau khi mua.
- Giá mới của gói thuê bao theo từng kỳ. Số tiền bổ sung cho các giấy phép được thêm sẽ được tính theo tỷ lệ dựa trên thời gian còn lại trong thời hạn hiện tại.
Chọn Lưu.

Xem thông tin chỉ định giấy phép Gemini Code Assist

Chọn một trong các tùy chọn sau:

Giao diện dòng lệnh API

Đảm bảo rằng bạn có các quyền IAM sau đây trên tài khoản thanh toán sở hữu gói thuê bao:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- resourcemanager.projects.get
Chuyển đến trang Quản trị viên của Gemini.

Chuyển đến Gemini cho Google Cloud
Chọn gói thuê bao bạn muốn thay đổi, sau đó chọn Sửa đổi gói thuê bao.

Bạn có thể xem những thông tin sau đây cho mỗi người dùng đã được cấp phép:
- Tên.
- Email.
- Ngày cấp giấy phép.
- Ngày và giờ sử dụng giấy phép gần đây nhất.
Để tìm một nhóm người dùng cụ thể, bạn có thể lọc và sắp xếp danh sách như sau:
- Để lọc danh sách, trong trường Filter (Bộ lọc), hãy nhập các thuộc tính và giá trị.
- Để sắp xếp danh sách, hãy chọn tiêu đề của cột mà bạn muốn sắp xếp. Ví dụ: để sắp xếp theo thứ tự bảng chữ cái theo tên người dùng, hãy chọn tiêu đề cột Tên.

Để xem các lượt chỉ định giấy phép Gemini Code Assist, hãy sử dụng phương thức billingAccounts.orders.licensePool.enumerateLicensedUsers.

Để thực hiện việc này, bạn phải có quyền consumerprocurement.licensePools.enumerateLicensedUsers trên tài khoản thanh toán sở hữu gói thuê bao.

GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/

Thay thế nội dung sau:

BILLING_ACCOUNT_ID: mã tài khoản thanh toán
ORDER_ID: chính sách IAM

Nếu thành công, lệnh này sẽ trả về kết quả licensedUsers ở định dạng sau:

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

Nếu không có chỉ định giấy phép hỗ trợ mã Gemini hoặc ORDER_ID không hợp lệ, thì hàm này sẽ trả về đầu ra licensedUsers ở định dạng sau:

{}

Chỉ định giấy phép Gemini Code Assist theo cách thủ công cho từng người dùng

Chọn một trong các tùy chọn sau:

Giao diện dòng lệnh API

Đảm bảo rằng bạn có các quyền IAM sau đây trên tài khoản thanh toán sở hữu gói thuê bao:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- consumerprocurement.licensePools.assign
- resourcemanager.projects.get
Chuyển đến trang Quản trị viên của Gemini.

Chuyển đến Gemini cho Google Cloud
Chọn Quản lý tính năng Hỗ trợ mã Gemini, sau đó chọn Sửa đổi gói thuê bao.
Đối với gói thuê bao Trợ giúp lập trình Gemini này, hãy đảm bảo bạn đặt Chỉ định giấy phép thành Chỉ định giấy phép theo cách thủ công. Nếu gói thuê bao Gemini Code Assist được đặt thành Tự động chỉ định giấy phép, thì bạn không thể quản lý từng giấy phép. Việc chuyển tài khoản thanh toán này sang chế độ Chỉ định giấy phép theo cách thủ công sẽ tắt tính năng chỉ định giấy phép tự động sau khi thay đổi, nhưng các lượt chỉ định giấy phép trước đó sẽ không bị ảnh hưởng.
Chọn Cấp giấy phép. Hộp thoại lựa chọn người dùng sẽ xuất hiện. Để tìm kiếm một số người dùng cụ thể, hãy nhập địa chỉ email của họ rồi chọn Tiếp theo.
Chọn Cấp giấy phép.
Đảm bảo rằng bạn cấp cho người dùng vai trò Người dùng Gemini cho Google Cloud và Người tiêu dùng sử dụng dịch vụ trong IAM cho người dùng được cấp phép.

Để chỉ định giấy phép Gemini Code Assist, hãy sử dụng phương thức billingAccounts.orders.licensePool.assign.

Để thực hiện việc này, hãy đảm bảo bạn có các quyền sau trên tài khoản thanh toán sở hữu gói thuê bao:

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

Thay thế nội dung sau:

BILLING_ACCOUNT_ID: mã tài khoản thanh toán
ORDER_ID: chính sách IAM

Nếu thành công, lệnh này sẽ trả về một nội dung phản hồi trống ở định dạng sau:

{}

Để xác minh bài tập, hãy xem danh sách bài tập.

Sau đó, hãy đảm bảo rằng bạn cấp cho người dùng vai trò Người dùng Gemini cho Google Cloud và Người tiêu dùng sử dụng dịch vụ trong IAM cho người dùng được cấp phép.

Tự động chỉ định giấy phép Gemini Code Assist

Bạn có thể tự động chỉ định giấy phép cho bất kỳ người dùng nào trong tổ chức của mình cần quyền truy cập vào tính năng Hỗ trợ mã của Gemini trên trang Chỉ định giấy phép. Việc chỉ định giấy phép tự động được thiết lập riêng cho từng gói thuê bao.

Nếu chọn tự động chỉ định giấy phép cho một dự án hỗ trợ lập trình Gemini, bạn sẽ không thể xoá hoặc thêm giấy phép của từng người dùng trong tài khoản đó. Những người dùng có quyền sử dụng giấy phép nhưng chưa sử dụng tính năng hỗ trợ mã Gemini sẽ tự động bị huỷ cấp phép vào cuối kỳ thanh toán sau một số ngày không hoạt động theo quy định do quản trị viên đặt ra.

Trong Google Cloud Console, hãy chuyển đến trang Quản trị viên cho Gemini.

Chuyển đến Gemini cho Google Cloud
Chọn Quản lý tính năng Hỗ trợ lập trình Gemini, rồi chọn Quản lý gói thuê bao.
Chọn Quản lý giấy phép, sau đó chọn Bật tính năng Chỉ định giấy phép tự động. Hộp thoại Bật giấy phép tự động sẽ xuất hiện.

Việc chuyển đổi gói thuê bao này để tự động chỉ định giấy phép sẽ tắt tính năng chỉ định giấy phép theo cách thủ công sau khi thay đổi, nhưng các lượt chỉ định giấy phép trước đó sẽ không bị ảnh hưởng.
Đặt khoảng thời gian để huỷ chỉ định giấy phép nếu người được chỉ định không hoạt động, sau đó chọn Xác nhận thay đổi. Hộp thoại Tự động chỉ định giấy phép đã được bật sẽ xuất hiện.
Chọn Đóng.
Đảm bảo rằng bạn cấp cho người dùng vai trò Người dùng Gemini cho Google Cloud và Người tiêu dùng sử dụng dịch vụ trong IAM cho người dùng được cấp phép.

Người dùng có quyền cloudaicompanion.licenses.selfAssign sẽ tự động nhận được giấy phép khi lần đầu tiên truy cập vào tính năng Hỗ trợ mã Gemini trong một dự án do tài khoản thanh toán trả phí, tài khoản này có gói thuê bao hợp lệ được định cấu hình để tự động chỉ định giấy phép và có các giấy phép có sẵn trong gói thuê bao của bạn trong tài khoản thanh toán.

Để tắt tính năng chỉ định giấy phép tự động, hãy làm theo các bước sau:

Trong Google Cloud Console, hãy chuyển đến trang Quản trị viên cho Gemini.

Chuyển đến Gemini cho Google Cloud
Chọn Quản lý tính năng Hỗ trợ lập trình Gemini, rồi chọn Quản lý gói thuê bao.
Chọn Quản lý giấy phép, sau đó chọn Quản lý việc chỉ định giấy phép tự động. Hộp thoại Quản lý việc chỉ định giấy phép tự động sẽ xuất hiện.
Chọn Tắt tính năng tự động quản lý giấy phép.
Chọn Xác nhận thay đổi.

Huỷ chỉ định giấy phép Gemini Code Assist theo cách thủ công

Chọn một trong các tùy chọn sau:

Giao diện dòng lệnh API

Đảm bảo rằng bạn có các quyền IAM sau đây trên tài khoản thanh toán sở hữu gói thuê bao:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- consumerprocurement.licensePools.unassign
- resourcemanager.projects.get
Chuyển đến trang Quản trị viên của Gemini.

Chuyển đến Gemini cho Google Cloud
Chọn Quản lý tính năng Hỗ trợ lập trình Gemini, rồi chọn Quản lý gói thuê bao.
Chọn Quản lý giấy phép, sau đó chọn Quản lý việc chỉ định giấy phép tự động. Hộp thoại Quản lý việc chỉ định giấy phép tự động sẽ xuất hiện.
Chọn những người dùng mà bạn muốn huỷ chỉ định giấy phép, sau đó chọn Huỷ chỉ định giấy phép.
Chọn Xác nhận.

Để huỷ chỉ định giấy phép Hỗ trợ mã Gemini, hãy sử dụng phương thức billingAccounts.orders.licensePool.unassign.

Để thực hiện việc này, bạn phải có quyền consumerprocurement.licensePools.unassign trên tài khoản thanh toán sở hữu gói thuê bao.

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Thay thế nội dung sau:

BILLING_ACCOUNT_ID: mã tài khoản thanh toán
ORDER_ID: chính sách IAM

Nếu thành công, lệnh này sẽ trả về một nội dung phản hồi trống ở định dạng sau:

{}

Để xác minh việc huỷ giao bài tập, hãy xem danh sách bài tập.

Chuyển giấy phép Gemini Code Assist

Bạn không thể chuyển trực tiếp giấy phép Gemini Code Assist giữa các người dùng. Thay vào đó, hãy huỷ chỉ định giấy phép cho một người dùng rồi chỉ định giấy phép cho người dùng mới.

Ngăn việc sử dụng giấy phép trên nhiều tổ chức

Giấy phép Gemini Code Assist được chỉ định cho từng người dùng, chứ không phải tổ chức hoặc dự án, cho phép từng người dùng sử dụng Gemini Code Assist trên nhiều tổ chức.

Mọi nhật ký được tạo từ việc sử dụng tính năng Trợ giúp mã Gemini đều nằm trong dự án mà tính năng này được sử dụng, chứ không phải trong dự án của bên được cấp phép. Ngoài ra, mọi hoạt động tuỳ chỉnh hoặc định cấu hình của tính năng Trợ giúp mã Gemini (chẳng hạn như tuỳ chỉnh mã) đều được thực hiện trên dự án, chứ không phải ở cấp giấy phép hoặc gói thuê bao.

Để ngăn chặn việc sử dụng tính năng Hỗ trợ mã Gemini giữa các tổ chức trong một dự án, bạn có thể làm theo một trong những cách sau:

Tắt API Gemini cho Google Cloud trong dự án.
Sử dụng quyền để từ chối quyền truy cập của người dùng vào dự án.

Các điểm hạn chế

Gemini dùng để quản lý giấy phép Google Cloud không hỗ trợ Workforce Identity Federation.