Permissions

เมธอด: tunedModels.permissions.create

สร้างสิทธิ์เข้าถึงทรัพยากรที่เฉพาะเจาะจง

ปลายทาง

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

พารามิเตอร์เส้นทาง

parent string

ต้องระบุ ทรัพยากรระดับบนสุดของ Permission รูปแบบ: tunedModels/{tunedModel} corpora/{corpus} โดยมีรูปแบบเป็น tunedModels/{tunedmodel}

เนื้อความของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ Permission

ฟิลด์
granteeType enum (GranteeType)

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ประเภทของผู้รับเงินช่วยเหลือ

emailAddress string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ อีเมลของผู้ใช้หรือกลุ่มที่สิทธิ์นี้อ้างอิง ระบบจะไม่ตั้งค่าฟิลด์เมื่อประเภทผู้รับสิทธิ์ของสิทธิ์เป็น EVERYONE

role enum (Role)

ต้องระบุ บทบาทที่ได้รับจากสิทธิ์นี้

ตัวอย่างคำขอ

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

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Permission ที่สร้างขึ้นใหม่

เมธอด: tunedModels.permissions.get

รับข้อมูลเกี่ยวกับสิทธิ์ที่เฉพาะเจาะจง

ปลายทาง

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

พารามิเตอร์เส้นทาง

name string

ต้องระบุ ชื่อทรัพยากรของสิทธิ์

รูปแบบ: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} โดยมีรูปแบบเป็น tunedModels/{tunedmodel}/permissions/{permission}

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

ตัวอย่างคำขอ

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

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Permission

เมธอด: tunedModels.permissions.list

แสดงรายการสิทธิ์สำหรับทรัพยากรที่เฉพาะเจาะจง

ปลายทาง

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

พารามิเตอร์เส้นทาง

parent string

ต้องระบุ ทรัพยากรหลักของสิทธิ์ รูปแบบ: tunedModels/{tunedModel} corpora/{corpus} โดยมีรูปแบบเป็น tunedModels/{tunedmodel}

พารามิเตอร์การค้นหา

pageSize integer

ไม่บังคับ จำนวนสูงสุดของ Permission ที่จะแสดง (ต่อหน้า) บริการอาจแสดงสิทธิ์น้อยลง

หากไม่ระบุ ระบบจะแสดงสิทธิ์สูงสุด 10 รายการ วิธีนี้จะแสดงสิทธิ์สูงสุด 1, 000 รายการต่อหน้า แม้ว่าคุณจะส่ง pageSize ที่ใหญ่กว่าก็ตาม

pageToken string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ permissions.list ก่อนหน้า

ระบุ pageToken ที่ส่งคืนโดยคำขอหนึ่งเป็นอาร์กิวเมนต์ของคำขอถัดไปเพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ permissions.list ต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

ตัวอย่างคำขอ

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

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ListPermissionsResponse

เมธอด: tunedModels.permissions.patch

อัปเดตสิทธิ์

ปลายทาง

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

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

พารามิเตอร์เส้นทาง

permission.name string

เอาต์พุตเท่านั้น ตัวระบุ ชื่อสิทธิ์ ระบบจะสร้างชื่อที่ไม่ซ้ำกันเมื่อสร้าง ตัวอย่าง: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} เอาต์พุตเท่านั้น ซึ่งจะอยู่ในรูปแบบ tunedModels/{tunedmodel}/permissions/{permission}

พารามิเตอร์การค้นหา

updateMask string (FieldMask format)

ต้องระบุ รายการช่องที่จะอัปเดต ค่าที่ยอมรับได้ ได้แก่ - role (ฟิลด์ Permission.role)

ซึ่งเป็นรายการชื่อฟิลด์แบบสมบูรณ์ในตัวเองที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"

เนื้อความของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ Permission

ฟิลด์
role enum (Role)

ต้องระบุ บทบาทที่ได้รับจากสิทธิ์นี้

ตัวอย่างคำขอ

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

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Permission

วิธีการ: tunedModels.permissions.delete

ลบสิทธิ์

ปลายทาง

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

พารามิเตอร์เส้นทาง

name string

ต้องระบุ ชื่อทรัพยากรของสิทธิ์ รูปแบบ: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} โดยมีรูปแบบเป็น tunedModels/{tunedmodel}/permissions/{permission}

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

ตัวอย่างคำขอ

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

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะเป็นออบเจ็กต์ JSON ที่ว่างเปล่า

เมธอด: tunedModels.transferOwnership

โอนการเป็นเจ้าของโมเดลที่ปรับแต่งแล้ว นี่เป็นวิธีเดียวในการเปลี่ยนความเป็นเจ้าของโมเดลที่ปรับแต่งแล้ว ระบบจะลดสิทธิ์เจ้าของปัจจุบันเป็นบทบาทผู้เขียน

ปลายทาง

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

พารามิเตอร์เส้นทาง

name string

ต้องระบุ ชื่อทรัพยากรของโมเดลที่ปรับแต่งแล้วเพื่อโอนการเป็นเจ้าของ

รูปแบบ: tunedModels/my-model-id มีรูปแบบเป็น tunedModels/{tunedmodel}

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

ฟิลด์
emailAddress string

ต้องระบุ อีเมลของผู้ใช้ที่จะโอนโมเดลที่ปรับแต่งแล้วไปให้

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะว่างเปล่า

ทรัพยากร REST: tunedModels.permissions

แหล่งข้อมูล: สิทธิ์

แหล่งข้อมูลสิทธิ์จะให้สิทธิ์เข้าถึงแหล่งข้อมูล PaLM API (เช่น โมเดลที่ปรับแต่งแล้ว คลังข้อความ) แก่ผู้ใช้ กลุ่ม หรือบุคคลอื่นๆ

บทบาทคือชุดของการดำเนินการที่ได้รับอนุญาต ซึ่งช่วยให้ผู้ใช้ดำเนินการที่เฉพาะเจาะจงกับทรัพยากร PaLM API ได้ หากต้องการทำให้พร้อมใช้งานสำหรับผู้ใช้ กลุ่ม หรือบัญชีบริการ คุณต้องมอบหมายบทบาท เมื่อมอบหมายบทบาท คุณจะให้สิทธิ์ที่บทบาทนั้นมี

โดยมีบทบาท 3 ระดับ แต่ละบทบาทเป็นซูเปอร์เซ็ตของการดำเนินการที่ได้รับอนุญาตของบทบาทก่อนหน้า

  • ผู้อ่านสามารถใช้ทรัพยากร (เช่น โมเดลที่ปรับแต่งแล้ว คลังข้อมูล) สำหรับการอนุมานได้
  • ผู้เขียนมีสิทธิ์ของผู้อ่าน และยังแก้ไขและแชร์ได้ด้วย
  • เจ้าของมีสิทธิ์ของผู้เขียนและลบได้ด้วย
ฟิลด์
name string

เอาต์พุตเท่านั้น ตัวระบุ ชื่อสิทธิ์ ระบบจะสร้างชื่อที่ไม่ซ้ำกันเมื่อสร้าง ตัวอย่าง: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} เอาต์พุตเท่านั้น

granteeType enum (GranteeType)

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ประเภทของผู้รับเงินช่วยเหลือ

emailAddress string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ อีเมลของผู้ใช้หรือกลุ่มที่สิทธิ์นี้อ้างอิง ระบบจะไม่ตั้งค่าฟิลด์เมื่อประเภทผู้รับสิทธิ์ของสิทธิ์เป็น EVERYONE

role enum (Role)

ต้องระบุ บทบาทที่ได้รับจากสิทธิ์นี้

การแสดง JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

ListPermissionsResponse

การตอบกลับจาก ListPermissions ที่มีรายการสิทธิ์แบบแบ่งหน้า

ฟิลด์
permissions[] object (Permission)

สิทธิ์ที่ส่งคืน

nextPageToken string

โทเค็นซึ่งส่งเป็น pageToken เพื่อเรียกข้อมูลหน้าถัดไปได้

หากไม่ระบุฟิลด์นี้ แสดงว่าไม่มีหน้าอื่นอีก

การแสดง JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}