Permissions

เมธอด: TunModels.permissions.create

สร้างสิทธิ์ให้ทรัพยากรที่ต้องการ

ปลายทาง

โพสต์ https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

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

parent string

ต้องระบุ ทรัพยากรหลักของ Permission รูปแบบ: tunedModels/{tunedModel} corpora/{corpus} อยู่ในรูปแบบ tunedModels/{tunedmodel}

เนื้อหาของคำขอ

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

ช่อง
granteeType enum (GranteeType)

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ประเภทผู้รับสิทธิ์

emailAddress string

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

role enum (Role)

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

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

Python

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

group_permission = model_info.permissions.create(
    role="READER",
    # Use "user" for an individual email address.
    grantee_type="group",
    email_address="genai-samples-test-group@googlegroups.com",
)
tuned_models.py

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

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

เมธอด: TunModels.permissions.get

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

ปลายทาง

ซื้อ https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

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

name string

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

รูปแบบ: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} อยู่ในรูปแบบ tunedModels/{tunedmodel}/permissions/{permission}

เนื้อหาของคำขอ

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

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

Python

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

public = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)
print(public)
name = public.name
print(name)  # tunedModels/{tunedModel}/permissions/{permission}

from_name = genai.types.Permissions.get(name)
print(from_name)
tuned_models.py

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

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

เมธอด: TunModels.permissions.list

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

ปลายทาง

ซื้อ 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 ที่ส่งคืนโดยคำขอ 1 รายการเป็นอาร์กิวเมนต์ของคำขอถัดไปเพื่อเรียกหน้าถัดไป

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

เนื้อหาของคำขอ

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

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

Python

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

for p in model_info.permissions.list():
    print(p)
tuned_models.py

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

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

เมธอด: TunModels.permissions.patch

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

ปลายทาง

แพตช์ https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

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

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

permission.name string

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

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

updateMask string (FieldMask format)

ต้องระบุ รายการช่องที่จะอัปเดต ที่ยอมรับ: - บทบาท (ช่อง Permission.role)

ซึ่งเป็นรายการชื่อที่ตรงตามเกณฑ์ทั้งหมดของช่องที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"

เนื้อหาของคำขอ

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

ช่อง
role enum (Role)

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

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

Python

        model_info = genai.get_model("tunedModels/my-increment-model")

        # ...

        test_group = model_info.permissions.create(
            role="writer",
            grantee_type="group",
            email_address="genai-samples-test-group@googlegroups.com",
        )

        test_group.update({"role": "READER"})

    def test_tuned_models_permission_delete(self):
        model_info = genai.get_model("tunedModels/my-increment-model")
        # ...

        public_permission = model_info.permissions.create(
            role="READER",
            grantee_type="EVERYONE",
        )

        public_permission.delete()


if __name__ == "__main__":
    absltest.main()

tuned_models.py

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

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

เมธอด: tuneModels.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

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

public_permission.delete()
tuned_models.py

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

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

เมธอด: TunModels.transferโปรไฟล์ของคุณ

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

ปลายทาง

โพสต์ https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership

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

name string

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

รูปแบบ: tunedModels/my-model-id อยู่ในรูปแบบ tunedModels/{tunedmodel}

เนื้อหาของคำขอ

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

ช่อง
emailAddress string

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

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

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

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

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

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

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

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

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

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

granteeType enum (GranteeType)

ไม่บังคับ เปลี่ยนแปลงไม่ได้ ประเภทผู้รับสิทธิ์

emailAddress string

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

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
}