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 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 cấp giấy phép theo cách thủ công hoặc tự động.

Bạn có thể chỉ định giấy phép cho bất kỳ người dùng nào có dự án được liên kết với tài khoản thanh toán. Sau khi bạn chỉ định giấy phép cho người dùng, họ có thể sử dụng Gemini Code Assist trong bất kỳ dự án nào.

Gói Chương trình Nhà phát triển của Google ở cấp cao cấp cung cấp giấy phép Gemini Code Assist Tiêu chuẩn cho người dùng. Bạn không thể chỉ định giấy phép sử dụng Gemini Code Assist Standard cho người dùng có gói thuê bao Premium trong Chương trình Nhà phát triển của Google, vì họ đã có giấy phép thông qua gói thuê bao Premium trong Chương trình Nhà phát triển của Google.

Trước khi bắt đầu

• Đảm bảo rằng bạn có vai trò 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) trong IAM để có thể cấp thêm các quyền bắt buộc đối với tài khoản thanh toán cho các tác vụ quản lý giấy phép cụ thể được trình bày 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 API 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 rằng các cặp khoá-giá trị tiêu đề sau đây có trong tất cả cá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 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 cho Google Cloud ngay trong API Console, hoặc thông qua người đại diện của 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 sau đây đối với 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 API Console, hãy chuyển đến trang Admin for Gemini.

   Chuyển đến Gemini cho Google Cloud

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

4. Nhập số lượng giấy phép bạn muốn có. 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 kỳ hạn. Khoản 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 kỳ hạn hiện tại.

5. Chọn Lưu.

Xem thông tin chỉ định giấy phép Gemini Code Assist Tiêu chuẩn và Doanh nghiệp

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

Giao diện dòng lệnh

1. Đảm bảo rằng bạn có các quyền IAM sau đây đối với 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ị Gemini rồi chọn dự án được đính kèm vào tài khoản thanh toán của bạn bằng gói thuê bao Gemini Code Assist Tiêu chuẩn hoặc Enterprise.

   Chuyển đến Gemini cho Google Cloud

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

   Bạn có thể xem những thông tin sau đây về mỗi người dùng đã được cấp giấy phép:

   • Tên.
   • Email.
   • Ngày cấp giấy phép.
   • Ngày và giờ sử dụng giấy phép lần 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 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.

API

Để xem chế độ 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 consumerprocurement.licensePools.enumerateLicensedUsers IAM đối với tài khoản thanh toán có chứa nhóm giấy phép mà bạn muốn xem thông tin 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 của 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 của 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ã này 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 lệnh thành công, lệnh này sẽ trả về đầu ra licensedUsers theo đị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ó chỉ định giấy phép Gemini Code Assist Standard hoặc Enterprise hoặc ORDER_ID không hợp lệ, thì licensedUsers sẽ trả về đầu ra 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:

Giao diện dòng lệnh

1. Đảm bảo rằng bạn có các quyền IAM sau đây đối với 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 cho Gemini.

   Chuyển đến Gemini cho Google Cloud

3. Chọn Quản lý Gemini Code Assist, rồi chọn Sửa đổi gói thuê bao.

4. Đối với gói thuê bao Gemini Code Assist Standard hoặc Enterprise này, hãy đảm bảo rằng 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 Standard hoặc Enterprise được đặt thành Tự động cấp giấy phép, thì bạn không thể quản lý từng giấy phép. Khi bạn 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, chế độ tự động chỉ định giấy phép sẽ tắt sau khi bạn thay đổi, nhưng các chế độ chỉ định giấy phép hiện 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 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 vai trò Người dùng Gemini cho Google Cloud và Người tiêu dùng sử dụng dịch vụ IAM cho người dùng đối với người dùng được cấp phép.

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 đối với 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 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 phân tách bằng dấu phẩy đang được chỉ định giấy phép – 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 của 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 của 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ã này 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 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 đối với người dùng được cấp phép.

Tự động cấp 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 có quyền truy cập vào Gemini Code Assist Standard hoặc Enterprise trên trang Cấp giấy phép. Bạn có thể thiết lập tính năng tự động chỉ định giấy phép riêng cho từng gói thuê bao.

Tính năng tự động chỉ định giấy phép 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 sử dụng Gemini Code Assist Standard hoặc Enterprise, thì 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 chỉ định giấy phép nhưng chưa sử dụng bất kỳ tính năng nào của Gemini Code Assist Standard hoặc Enterprise sẽ tự động bị huỷ cấp phép vào cuối khoảng thời gian không hoạt động do quản trị viên thiết lập.

1. Trong API Console, hãy chuyển đến trang Admin for Gemini.

   Chuyển đến Gemini cho Google Cloud

2. Chọn Quản lý Gemini Code Assist, rồi chọn Quản lý gói thuê bao.

3. Chọn Quản lý giấy phép, rồi chọn Bật tính năng chỉ định giấy phép tự động. Hộp thoại Enable automatic licenses (Bật giấy phép tự động) sẽ xuất hiện.

   Việc chuyển gói thuê bao này sang chế độ tự động chỉ định giấy phép sẽ tắt chế độ chỉ định giấy phép theo cách thủ công sau khi thay đổi, nhưng các chế độ chỉ định giấy phép hiện 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ính năng 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 được 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ẽ được huỷ chỉ định và có sẵn trong nhóm giấy phép vào ngày 8.

5. Chọn Đóng.

6. Đảm bảo rằng bạn cấp vai trò Người dùng Gemini cho Google Cloud và Người tiêu dùng sử dụng dịch vụ IAM cho người dùng đối với 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 Gemini Code Assist Standard hoặc Enterprise trong một dự án được thanh toán bằng tài khoản thanh toán có gói thuê bao hợp lệ được định cấu hình để tự động cấp giấy phép và có giấy phép còn trống trong gói thuê bao của bạn trong tài khoản thanh toán.

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

1. Trong API Console, hãy chuyển đến trang Admin for Gemini.

   Chuyển đến Gemini cho Google Cloud

2. Chọn Quản lý Gemini Code Assist, rồi chọn Quản lý gói thuê bao.

3. Chọn Quản lý giấy phép, rồi chọn Quản lý tính năng 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 quản lý giấy phép tự động.

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:

Giao diện dòng lệnh

1. Đảm bảo rằng bạn có các quyền IAM sau đây đối với 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 cho Gemini.

   Chuyển đến Gemini cho Google Cloud

3. Chọn Quản lý Gemini Code Assist, rồi chọn Quản lý gói thuê bao.

4. Chọn Quản lý giấy phép, rồi chọn Quản lý tính năng 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.

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 consumerprocurement.licensePools.unassign Quản lý danh tính và quyền truy cập đối với tài khoản thanh toán có 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 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 phân tách bằng dấu phẩy và được chỉ định giấy phép – 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 của 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 của 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ã này 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ỷ chỉ định, hãy xem danh sách chỉ định.

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 Standard và Enterprise 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 chặn việc sử dụng giấy phép giữa các tổ chức

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

Mọi nhật ký được tạo từ việc sử dụng Gemini Code Assist đều nằm trong dự án mà hoạt động sử dụng diễn ra, chứ không phải với 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 Gemini Code Assist (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 trong một dự án giữa các tổ chức, bạn có thể làm một trong những việc sau:

• Tắt Gemini cho API 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ế

• Tính năng quản lý giấy phép Gemini cho Google Cloud không hỗ trợ Liên kết danh tính của nhân viên.