Permissions

متد: tunedModels.permissions.create

ایجاد مجوز برای یک منبع خاص

نقطه پایانی

پست https: / /generativelanguage.googleapis.com /v1beta /{parent=tunedModels /*} /permissions

پارامترهای مسیر

string parent

الزامی. منبع والدِ Permission . قالب‌ها: tunedModels/{tunedModel} corpora/{corpus} به شکل tunedModels/{tunedmodel} است.

درخواست بدنه

بدنه درخواست شامل نمونه‌ای از Permission است.

فیلدها
نوع داده شمارشی granteeType enum ( GranteeType )

اختیاری. تغییرناپذیر. نوع دریافت‌کننده کمک.

string emailAddress

اختیاری. تغییرناپذیر. آدرس ایمیل کاربر گروهی که این مجوز به آن اشاره دارد. وقتی نوع اعطاکننده مجوز «همه» (EVERYONE) باشد، این فیلد تنظیم نمی‌شود.

شمارش role enum ( Role )

الزامی. نقشی که با این مجوز اعطا می‌شود.

درخواست نمونه

پایتون 

# 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

اطلاعات مربوط به یک مجوز خاص را دریافت می‌کند.

نقطه پایانی

دریافت https: / /generativelanguage.googleapis.com /v1beta /{name=tunedModels /* /permissions /*}

پارامترهای مسیر

string name

الزامی. نام منبعِ مجوز.

قالب‌ها: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} این فایل به شکل tunedModels/{tunedmodel}/permissions/{permission} است.

درخواست بدنه

بدنه درخواست باید خالی باشد.

درخواست نمونه

پایتون 

# 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

مجوزهای مربوط به منبع خاص را فهرست می‌کند.

نقطه پایانی

دریافت https: / /generativelanguage.googleapis.com /v1beta /{parent=tunedModels /*} /permissions

پارامترهای مسیر

string parent

الزامی. منبع والد مجوزها. قالب‌ها: tunedModels/{tunedModel} corpora/{corpus} به شکل tunedModels/{tunedmodel} است.

پارامترهای پرس و جو

integer pageSize

اختیاری. حداکثر تعداد Permission که باید برگردانده شود (به ازای هر صفحه). سرویس ممکن است مجوزهای کمتری برگرداند.

اگر مشخص نشود، حداکثر ۱۰ مجوز برگردانده می‌شود. این متد حداکثر ۱۰۰۰ مجوز برای هر صفحه برمی‌گرداند، حتی اگر pageSize بزرگتری را ارسال کنید.

string pageToken

اختیاری. یک توکن صفحه، که از فراخوانی قبلی permissions.list دریافت شده است.

pageToken برگردانده شده توسط یک درخواست را به عنوان آرگومان برای درخواست بعدی جهت بازیابی صفحه بعدی ارائه دهید.

هنگام صفحه‌بندی، تمام پارامترهای دیگر ارائه شده به permissions.list باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.

درخواست بدنه

بدنه درخواست باید خالی باشد.

درخواست نمونه

پایتون 

# 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

مجوز را به‌روزرسانی می‌کند.

نقطه پایانی

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

پارامترهای مسیر

string permission.name

فقط خروجی. شناسه. نام مجوز. یک نام منحصر به فرد در هنگام ایجاد ایجاد می‌شود. مثال‌ها: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} فقط خروجی. به شکل tunedModels/{tunedmodel}/permissions/{permission} است.

پارامترهای پرس و جو

رشته updateMask string ( FieldMask format)

الزامی. فهرست فیلدهایی که باید به‌روزرسانی شوند. موارد پذیرفته‌شده: - نقش (فیلد Permission.role )

این لیستی از نام‌های کامل فیلدها است که با کاما از هم جدا شده‌اند. مثال: "user.displayName,photo" .

درخواست بدنه

بدنه درخواست شامل نمونه‌ای از Permission است.

فیلدها
شمارش role enum ( Role )

الزامی. نقشی که با این مجوز اعطا می‌شود.

درخواست نمونه

پایتون 

# 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 /*}

پارامترهای مسیر

string name

الزامی. نام منبع مجوز. قالب‌ها: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} این پارامتر به شکل tunedModels/{tunedmodel}/permissions/{permission} است.

درخواست بدنه

بدنه درخواست باید خالی باشد.

درخواست نمونه

پایتون 

# 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.transferOwnship

مالکیت مدل تنظیم‌شده را منتقل می‌کند. این تنها راه تغییر مالکیت مدل تنظیم‌شده است. مالک فعلی به نقش نویسنده تنزل رتبه خواهد یافت.

نقطه پایانی

پست https: / /generativelanguage.googleapis.com /v1beta /{name=tunedModels /*}:transferOwnership

پارامترهای مسیر

string name

الزامی. نام منبع مدل تنظیم‌شده برای انتقال مالکیت.

قالب: tunedModels/my-model-id به شکل tunedModels/{tunedmodel} است.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

فیلدها
string emailAddress

الزامی. آدرس ایمیل کاربری که مدل تنظیم‌شده به او منتقل می‌شود.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ خالی است.

منبع REST: tunedModels.permissions

منبع: اجازه

منبع مجوز، به کاربر، گروه یا سایر افراد جهان دسترسی به منبع API مربوط به PaLM (مثلاً یک مدل تنظیم‌شده، مجموعه داده) را اعطا می‌کند.

یک نقش مجموعه‌ای از عملیات مجاز است که به کاربران اجازه می‌دهد اقدامات خاصی را روی منابع API پال‌ام انجام دهند. برای اینکه آنها را در دسترس کاربران، گروه‌ها یا حساب‌های سرویس قرار دهید، نقش‌ها را تعیین می‌کنید. وقتی نقشی را تعیین می‌کنید، مجوزهایی را که آن نقش شامل می‌شود، اعطا می‌کنید.

سه نقش متحدالمرکز وجود دارد. هر نقش، مجموعه‌ای از عملیات مجاز نقش قبلی است:

  • خواننده می‌تواند از منبع (مثلاً مدل تنظیم‌شده، پیکره) برای استنتاج استفاده کند.
  • نویسنده مجوزهای خواننده را دارد و علاوه بر این می‌تواند ویرایش و اشتراک‌گذاری کند
  • مالک مجوزهای نویسنده را دارد و علاوه بر این می‌تواند حذف کند
فیلدها
string name

فقط خروجی. شناسه. نام مجوز. یک نام منحصر به فرد در هنگام ایجاد ایجاد می‌شود. مثال‌ها: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} فقط خروجی.

نوع داده شمارشی granteeType enum ( GranteeType )

اختیاری. تغییرناپذیر. نوع دریافت‌کننده کمک.

string emailAddress

اختیاری. تغییرناپذیر. آدرس ایمیل کاربر گروهی که این مجوز به آن اشاره دارد. وقتی نوع اعطاکننده مجوز «همه» (EVERYONE) باشد، این فیلد تنظیم نمی‌شود.

شمارش role enum ( Role )

الزامی. نقشی که با این مجوز اعطا می‌شود.

نمایش JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

لیست مجوزهاپاسخ

پاسخ از ListPermissions حاوی فهرستی صفحه‌بندی‌شده از مجوزها.

فیلدها
شیء permissions[] object ( Permission )

مجوزهای برگشت داده شده

string nextPageToken

یک توکن، که می‌تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود.

اگر این فیلد حذف شود، صفحات بیشتری وجود نخواهد داشت.

نمایش JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}