Permissions

Method: tunedModels.permissions.create

יצירת הרשאה למשאב ספציפי.

נקודת קצה

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

פרמטרים של נתיב

parent string

חובה. משאב ההורה של Permission. פורמטים: tunedModels/{tunedModel} corpora/{corpus} הפורמט הוא tunedModels/{tunedmodel}.

גוף הבקשה

גוף הבקשה מכיל מופע של Permission.

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

Method: tunedModels.permissions.list

מציג את ההרשאות של המשאב הספציפי.

נקודת קצה

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

פרמטרים של נתיב

parent string

חובה. משאב ההורה של ההרשאות. פורמטים: tunedModels/{tunedModel} corpora/{corpus} הפורמט הוא tunedModels/{tunedmodel}.

פרמטרים של שאילתה

pageSize integer

אופציונלי. המספר המקסימלי של Permissions שיוחזרו (לכל דף). יכול להיות שהשירות יחזיר פחות הרשאות.

אם לא מצוין, יוחזרו עד 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.

Method: 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.

Fields
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

מחיקת ההרשאה.

נקודת קצה

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
<x0A>
<x0A>

פרמטרים של נתיב

name string

חובה. שם המשאב של המודל שעבר התאמה, שאליו רוצים להעביר את הבעלות.

פורמט: tunedModels/my-model-id הוא מקבל את הצורה tunedModels/{tunedmodel}.

גוף הבקשה

גוף הבקשה מכיל נתונים עם המבנה הבא:

Fields
emailAddress string

חובה. כתובת האימייל של המשתמש שאליו מועבר המודל שעבר התאמה.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.

משאב REST: ‏ tunedModels.permissions

משאב: הרשאה

משאב ההרשאה מעניק למשתמש, לקבוצה או לכל שאר העולם גישה למשאב PaLM API (למשל, מודל מכוונן, קורפוס).

תפקיד הוא אוסף של פעולות מותרות שמאפשרות למשתמשים לבצע פעולות ספציפיות במשאבים של PaLM API. כדי להפוך אותן לזמינות למשתמשים, לקבוצות או לחשבונות שירות, צריך להקצות תפקידים. כשמקצים תפקיד, מעניקים את ההרשאות שהתפקיד מכיל.

יש שלושה תפקידים קונצנטריים. כל תפקיד הוא קבוצת-על של הפעולות המותרות בתפקיד הקודם:

  • המשתמש עם הרשאת קריאה יכול להשתמש במשאב (למשל, מודל שעבר כוונון, קורפוס) להסקת מסקנות
  • למשתמש עם הרשאת כתיבה יש הרשאות קריאה, והוא יכול גם לערוך ולשתף
  • לבעלים יש הרשאות כתיבה, והם יכולים גם למחוק
שדות
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
}