Permissions

Phương thức: tunedModels.permissions.create

Tạo quyền cho một tài nguyên cụ thể.

Điểm cuối

post https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Tham số đường dẫn

parent string

Bắt buộc. Tài nguyên mẹ của Permission. Định dạng: tunedModels/{tunedModel} corpora/{corpus} Tên này có dạng tunedModels/{tunedmodel}.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Permission.

Trường
granteeType enum (GranteeType)

Không bắt buộc. Không thể thay đổi. Loại người được cấp quyền.

emailAddress string

Không bắt buộc. Không thể thay đổi. Địa chỉ email của người dùng thuộc nhóm mà quyền này đề cập đến. Trường này không được đặt khi loại người được cấp quyền là MỌI NGƯỜI.

role enum (Role)

Bắt buộc. Vai trò được cấp theo quyền này.

Ví dụ về yêu cầu

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới tạo của Permission.

Phương thức: tunedModels.permissions.get

Nhận thông tin về một Quyền cụ thể.

Điểm cuối

get https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Tham số đường dẫn

name string

Bắt buộc. Tên tài nguyên của quyền.

Định dạng: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Tên này có dạng tunedModels/{tunedmodel}/permissions/{permission}.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Ví dụ về yêu cầu

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Permission.

Phương thức: tunedModels.permissions.list

Liệt kê các quyền đối với tài nguyên cụ thể.

Điểm cuối

get https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Tham số đường dẫn

parent string

Bắt buộc. Tài nguyên mẹ của các quyền. Định dạng: tunedModels/{tunedModel} corpora/{corpus} Tên này có dạng tunedModels/{tunedmodel}.

Tham số truy vấn

pageSize integer

Không bắt buộc. Số lượng Permission tối đa cần trả về (trên mỗi trang). Dịch vụ này có thể trả về ít quyền hơn.

Nếu không chỉ định, tối đa 10 quyền sẽ được trả về. Phương thức này trả về tối đa 1.000 quyền cho mỗi trang, ngay cả khi bạn truyền pageSize lớn hơn.

pageToken string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi permissions.list trước đó.

Cung cấp pageToken do một yêu cầu trả về làm đối số cho yêu cầu tiếp theo để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho permissions.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Ví dụ về yêu cầu

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của ListPermissionsResponse.

Phương thức: tunedModels.permissions.patch

Cập nhật quyền.

Điểm cuối

patch https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

Tham số đường dẫn

permission.name string

Chỉ có đầu ra. Giá trị nhận dạng. Tên quyền. Một tên riêng biệt sẽ được tạo khi bạn tạo. Ví dụ: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Chỉ có đầu ra. Tên này có dạng tunedModels/{tunedmodel}/permissions/{permission}.

Tham số truy vấn

updateMask string (FieldMask format)

Bắt buộc. Danh sách các trường cần cập nhật. Các giá trị được chấp nhận: – vai trò (trường Permission.role)

Đây là danh sách tên đủ điều kiện của các trường được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Permission.

Trường
role enum (Role)

Bắt buộc. Vai trò được cấp theo quyền này.

Ví dụ về yêu cầu

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Permission.

Phương thức: tunedModels.permissions.delete

Xoá quyền.

Điểm cuối

xoá https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Tham số đường dẫn

name string

Bắt buộc. Tên tài nguyên của quyền. Định dạng: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Tên này có dạng tunedModels/{tunedmodel}/permissions/{permission}.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Ví dụ về yêu cầu

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ là một đối tượng JSON trống.

Phương thức: tunedModels.transferOwnership

Chuyển quyền sở hữu mô hình được điều chỉnh. Đây là cách duy nhất để thay đổi quyền sở hữu mô hình đã điều chỉnh. Chủ sở hữu hiện tại sẽ bị hạ cấp xuống vai trò người viết.

Điểm cuối

post https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership

Tham số đường dẫn

name string

Bắt buộc. Tên tài nguyên của mô hình được điều chỉnh để chuyển quyền sở hữu.

Định dạng: tunedModels/my-model-id. Tên này có dạng tunedModels/{tunedmodel}.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Trường
emailAddress string

Bắt buộc. Địa chỉ email của người dùng mà bạn đang chuyển mô hình đã điều chỉnh cho họ.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ trống.

Tài nguyên REST: tunedModels.permissions

Tài nguyên: Quyền

Tài nguyên quyền cấp cho người dùng, nhóm hoặc những người dùng khác trên thế giới quyền truy cập vào tài nguyên API PaLM (ví dụ: mô hình được điều chỉnh, ngữ liệu).

Vai trò là một tập hợp các thao tác được phép, cho phép người dùng thực hiện các hành động cụ thể trên các tài nguyên của PaLM API. Để cung cấp các vai trò này cho người dùng, nhóm hoặc tài khoản dịch vụ, bạn cần chỉ định vai trò. Khi chỉ định một vai trò, bạn sẽ cấp các quyền mà vai trò đó có.

Có 3 vai trò đồng tâm. Mỗi vai trò là một tập hợp con của các thao tác được phép của vai trò trước đó:

  • trình đọc có thể sử dụng tài nguyên (ví dụ: mô hình đã điều chỉnh, ngữ liệu) để suy luận
  • người viết có các quyền của người đọc, đồng thời có thể chỉnh sửa và chia sẻ
  • chủ sở hữu có quyền của người viết và có thể xoá
Trường
name string

Chỉ có đầu ra. Giá trị nhận dạng. Tên quyền. Một tên riêng biệt sẽ được tạo khi bạn tạo. Ví dụ: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Chỉ có đầu ra.

granteeType enum (GranteeType)

Không bắt buộc. Không thể thay đổi. Loại người được cấp quyền.

emailAddress string

Không bắt buộc. Không thể thay đổi. Địa chỉ email của người dùng thuộc nhóm mà quyền này đề cập đến. Trường này không được đặt khi loại người được cấp quyền là MỌI NGƯỜI.

role enum (Role)

Bắt buộc. Vai trò được cấp theo quyền này.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

ListPermissionsResponse

Phản hồi từ ListPermissions chứa danh sách quyền được phân trang.

Trường
permissions[] object (Permission)

Các quyền được trả về.

nextPageToken string

Một mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo.

Nếu bạn bỏ qua trường này, thì sẽ không còn trang nào nữa.

Biểu diễn dưới dạng JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}