Quản lý giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp

Trước khi sử dụng Gemini Code Assist Standard và Enterprise, mỗi người dùng trong tổ chức của bạn cần có giấy phép.

Theo mặc định, các gói thuê bao mới yêu cầu bạn phải cấp 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ạn 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ì bảng điều khiển Google Cloud , 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ã thông báo truy cậpGoogle Cloud của bạn từ Google Cloud CLI
    • x-goog-user-project: mã dự án của dự án hạn mức

Thay đổi số lượng giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp trong một gói thuê bao

Bạn có thể thêm hoặc xoá số lượng giấy phép Gemini for 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:

1. Đảm bảo rằng bạn có các quyền Quản lý danh tính và quyền truy cập (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.orders.modify
   • resourcemanager.projects.get

2. Trong bảng điều khiển Google Cloud , hãy chuyển đến trang Quản trị viên cho Gemini.

   Chuyển đến Gemini để Google Cloud

3. Chọn gói thuê bao bạn muốn thay đổi, sau đó chọn Sửa đổi gói thuê bao.

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

5. Chọn Lưu.

Xem các giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp được chỉ định

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

Bảng điều khiển

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

2. Chuyển đến trang Quản trị viên cho Gemini rồi chọn dự án được đính kèm với tài khoản thanh toán của bạn có gói thuê bao Gemini Code Assist Tiêu chuẩn hoặc Gemini Enterprise.

   Chuyển đến Gemini để Google Cloud

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

4. Để 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 (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.

Giao diện lập trình ứng dụng (API)

Để xem các lượt chỉ định giấy phép Gemini Code Assist Tiêu chuẩn hoặc Doanh nghiệp, hãy sử dụng phương thức billingAccounts.orders.licensePool.enumerateLicensedUsers.

1. Đảm bảo rằng bạn có quyền IAM consumerprocurement.licensePools.enumerateLicensedUsers trên tài khoản thanh toán chứa nhóm giấy phép mà bạn muốn xem các lượt chỉ định giấy phép.

2. Sử dụng cURL để gọi phương thức:

   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/"
   

   Thay thế nội dung sau:

   • PROJECT_ID: mã nhận dạng cho một dự án. Mức sử dụng hạn mức và các khoản phí liên quan đến yêu cầu API sẽ được áp dụng cho dự án này.
   • BILLING_ACCOUNT_ID: mã nhận dạng cho tài khoản thanh toán được liên kết với nhóm giấy phép.
   • ORDER_ID: mã đơn đặt hàng. Nếu không biết mã đơn đặt hàng, bạn có thể truy xuất mã đó bằng cách liệt kê các đơn đặt hàng được liên kết với tài khoản thanh toán của bạn.

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

{
  "licensedUsers": [
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

Nếu không có lượt chỉ định giấy phép Gemini Code Assist Tiêu chuẩn hoặc Doanh nghiệp hoặc ORDER_ID không hợp lệ, thì hàm này sẽ trả về đầu ra licensedUsers theo định dạng sau:

{}

Cấp giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp 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:

Bảng điều khiển

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

2. Chuyển đến trang Quản trị viên của Gemini.

   Chuyển đến Gemini để Google Cloud

3. Chọn Quản lý tính năng Hỗ trợ mã Gemini, sau đó chọn Sửa đổi gói thuê bao.

4. Đối với gói thuê bao Gemini Code Assist Standard hoặc Enterprise, hãy đảm bảo bạn đặt License Assignment (Cấp phép) thành Manually Assign Licenses (Cấp phép theo cách thủ công). Nếu gói thuê bao Gemini Code Assist Standard hoặc Gemini Code Assist Enterprise đượ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.

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

6. Chọn Cấp giấy phép.

7. Đả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.

Giao diện lập trình ứng dụng (API)

Để chỉ định giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp, hãy sử dụng phương thức billingAccounts.orders.licensePool.assign.

1. Đảm bảo rằng bạn có các quyền IAM sau đây trên tài khoản thanh toán chứa nhóm giấy phép mà bạn dự định chỉ định giấy phép:

   • billing.accounts.get
   • consumerprocurement.licensePools.assign
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.unassign
   • consumerprocurement.orders.get

2. Tạo một tệp JSON chứa những thông tin sau:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Thay thế USER_EMAILS bằng danh sách các tài khoản người dùng được chỉ định giấy phép, được phân tách bằng dấu phẩy, ví dụ: "[e-mail]", "[e-mail]".

3. Sử dụng cURL để gọi phương thức:

   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/"

   Thay thế nội dung sau:

   • JSON_FILE_NAME: đường dẫn đến tệp JSON mà bạn đã tạo ở Bước 2.
   • PROJECT_ID: mã nhận dạng cho một dự án. Mức sử dụng hạn mức và các khoản phí liên quan đến yêu cầu API sẽ được áp dụng cho dự án này.
   • BILLING_ACCOUNT_ID: mã nhận dạng cho tài khoản thanh toán được liên kết với nhóm giấy phép.
   • ORDER_ID: mã đơn đặt hàng. Nếu không biết mã đơn đặt hàng, bạn có thể truy xuất mã đó bằng cách liệt kê các đơn đặt hàng được liên kết với tài khoản thanh toán của bạn.

Nếu thành công, phản hồi sẽ tương tự như 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 những người dùng được cấp phép.

Tự động chỉ định giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp

Bạn có thể tự động cấp 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 Gemini Code Assist Standard hoặc Enterprise trên trang Cấp 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.

Tính năng chỉ định giấy phép tự động chỉ được hỗ trợ trong VS Code, IntelliJ và các IDE JetBrains được hỗ trợ khác.

Nếu chọn tự động cấp giấy phép cho Gemini Code Assist Standard hoặc Enterprise, bạn 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 nào của Gemini Code Assist Standard hoặc Enterprise sẽ tự động bị huỷ cấp quyền khi hết khoảng thời gian không hoạt động do quản trị viên đặt ra.

1. Trong bảng điều khiển Google Cloud , hãy chuyển đến trang Quản trị viên cho Gemini.

   Chuyển đến Gemini để Google Cloud

2. Chọn Quản lý tính năng Hỗ trợ mã Gemini, rồi chọn Quản lý gói thuê bao.

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

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

   Nếu bạn đã thiết lập T ngày không hoạt động để huỷ chỉ định, thì(các) giấy phép sẽ tự động huỷ chỉ định và có sẵn trong nhóm giấy phép vào ngày T+1. Ví dụ: nếu bạn định cấu hình 7 ngày không hoạt động để huỷ chỉ định, thì(các) giấy phép sẽ bị huỷ chỉ định và có sẵn trong nhóm giấy phép vào ngày 8.

5. Chọn Đóng.

6. Hãy nhớ 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 những 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 truy cập vào Gemini Code Assist Standard hoặc Enterprise trong một dự án do tài khoản thanh toán có gói thuê bao hợp lệ được định cấu hình để tự động chỉ định giấy phép và có giấy phép hiện có 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:

1. Trong bảng điều khiển Google Cloud , hãy chuyển đến trang Quản trị viên cho Gemini.

   Chuyển đến Gemini để Google Cloud

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

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

4. Chọn Tắt tính năng tự động quản lý giấy phép.

5. Chọn Xác nhận thay đổi.

Huỷ chỉ định giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp theo cách thủ công

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

Bảng điều khiển

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

2. Chuyển đến trang Quản trị viên của Gemini.

   Chuyển đến Gemini để Google Cloud

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

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

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

6. Chọn Xác nhận.

Giao diện lập trình ứng dụng (API)

Để huỷ chỉ định giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp, hãy sử dụng phương thức billingAccounts.orders.licensePool.unassign.

1. Để thực hiện việc này, bạn phải có quyền Quản lý danh tính và quyền truy cập (IAM) consumerprocurement.licensePools.unassign trên tài khoản thanh toán chứa nhóm giấy phép mà bạn dự định huỷ chỉ định giấy phép.

2. Tạo một tệp JSON chứa những thông tin sau:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Thay thế USER_EMAILS bằng danh sách các tài khoản người dùng được chỉ định giấy phép, được phân tách bằng dấu phẩy, ví dụ: "[e-mail]", "[e-mail]".

3. Sử dụng cURL để gọi phương thức:

   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/"

   Thay thế nội dung sau:

   • JSON_FILE_NAME: đường dẫn đến tệp JSON mà bạn đã tạo ở Bước 2.
   • PROJECT_ID: mã nhận dạng cho một dự án. Mức sử dụng hạn mức và các khoản phí liên quan đến yêu cầu API sẽ được áp dụng cho dự án này.
   • BILLING_ACCOUNT_ID: mã nhận dạng cho tài khoản thanh toán được liên kết với nhóm giấy phép.
   • ORDER_ID: mã đơn đặt hàng. Nếu không biết mã đơn đặt hàng, bạn có thể truy xuất mã đó bằng cách liệt kê các đơn đặt hàng được liên kết với tài khoản thanh toán của bạn.

Nếu thành công, phản hồi sẽ tương tự như 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 Tiêu chuẩn và Doanh nghiệp

Bạn không thể chuyển trực tiếp giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp 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 Tiêu chuẩn và Doanh nghiệp đượ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 Tiêu chuẩn và Doanh nghiệp 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 Hỗ trợ mã Gemini đều nằm trong dự án xảy ra việ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 Gemini Code Assist Standard và Enterprise 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.

Hạn chế

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

Bước tiếp theo

• Tìm hiểu cách ngăn chặn việc sử dụng giấy phép trên nhiều tổ chức.