Permissions

שיטה: tunedModels.permissions.create

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

נקודת קצה

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

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

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

אופציונלי. המספר המקסימלי של 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.

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 field)

זוהי רשימה של שמות שדות שמוגדרים במלואם, שמופרדים באמצעות פסיקים. דוגמה: "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

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

name string

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

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

גוף הבקשה

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

Fields
emailAddress string

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

גוף התשובה

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

משאב REST: ‏ tunedModels.permissions

משאב: הרשאה

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

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

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

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

Fields
permissions[] object (Permission)

ההרשאות שהוחזרו.

nextPageToken string

טוקן שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא.

אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

ייצוג ב-JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}