Permissions

الطريقة: tunedModels.permissions.create

إنشاء إذن بالوصول إلى مرجع معيّن

نقطة نهاية

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

مَعلمات المسار

parent string

مطلوب. تمثّل هذه السمة المرجع الرئيسي للسمة Permission. التنسيقات: tunedModels/{tunedModel} corpora/{corpus} تأخذ الشكل tunedModels/{tunedmodel}.

نص الطلب

يحتوي نص الطلب على مثال Permission.

الحقول
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.

الطريقة: 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.

الطريقة: 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)

مطلوب. قائمة الحقول التي سيتم تعديلها القيم المقبولة: - الدور (الحقل Permission.role)

هذه قائمة مفصولة بفواصل تتضمّن الأسماء المؤهَّلة بالكامل للحقول. مثال: "user.displayName,photo"

نص الطلب

يحتوي نص الطلب على مثال Permission.

الحقول
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}.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

الحقول
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
}