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
}