Permissions

שיטה: AdjustModels.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.

שיטה: AdjustModels.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.

שיטה: AdjustModels.permissions.list

בתיבת הדו-שיח הזו מפורטים ההרשאות למשאב הספציפי.

נקודת קצה

הורדה https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

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

parent string

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

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

pageSize integer

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

אם לא צוין, יוחזרו 10 הרשאות לכל היותר. השיטה הזו מחזירה 1,000 הרשאות לכל היותר לדף, גם אם מעבירים גודל דף גדול יותר.

pageToken string

זה שינוי אופציונלי. אסימון דף, שהתקבל מקריאה קודמת ב-permissions.list.

צריך לספק את ה-pageToken שהוחזר על ידי בקשה אחת כארגומנט לבקשה הבאה כדי לאחזר את הדף הבא.

במהלך החלוקה לדפים, כל שאר הפרמטרים שסופקו ל-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.

שיטה: AdjustModels.permissions.patch

עדכון ההרשאה.

נקודת קצה

תיקון https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

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

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

permission.name string

פלט בלבד. מזהה. שם ההרשאה. שם ייחודי ייווצר במהלך היצירה. דוגמאות: AdjustModels/{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.

שיטה: AdjustModels.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

גוף התשובה

אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.

שיטה: AdjustModels.transferOwnership

העברת הבעלות על המודל המכוונן. זו הדרך היחידה לשנות את הבעלות על המודל המכוונן. הבעלים הנוכחי ישודרג לאחור לתפקיד 'כתיבה'.

נקודת קצה

לשלוח https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership

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

name string

חובה. שם המשאב של המודל המכוונן לצורך העברת הבעלות.

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

גוף הבקשה

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

שדות
emailAddress string

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

גוף התשובה

אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.

משאב REST: AdjustModels.permissions

משאב: הרשאה

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

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

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

  • יכול להשתמש במשאב (למשל, מודל מכוונן, קורפוס) לצורך הסקת מסקנות
  • לכותב יש הרשאות קריאה וגם לכותב יש אפשרות לערוך ולשתף
  • לבעלים יש הרשאות כתיבה וגם למחוק
שדות
name string

פלט בלבד. מזהה. שם ההרשאה. שם ייחודי ייווצר במהלך היצירה. דוגמאות: AdjustModels/{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
}