Method: notes.permissions.batchCreate

لإنشاء إذن واحد أو أكثر في الملاحظة لا يمكن إنشاء سوى الأذونات التي تحمل الدور WRITER. إذا تعذّرت إضافة أي إذن، يتعذّر إكمال الطلب بالكامل ولا يتم إجراء أي تغييرات.

طلب HTTP

POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchCreate

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

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

المعلمات
parent

string

المورد الرئيسي الذي تتم مشاركته من خلال جميع الأذونات التي يتم إنشاؤها. التنسيق: notes/{note} في حال ضبط هذا الخيار، يجب أن يكون حقل "الرئيسي" في رسائل CreatePermission فارغًا أو يتطابق مع هذا الحقل.

نص الطلب

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

تمثيل JSON
{
  "requests": [
    {
      object (CreatePermissionRequest)
    }
  ]
}
الحقول
requests[]

object (CreatePermissionRequest)

رسالة الطلب التي تحدّد الموارد المطلوب إنشاؤها

نص الاستجابة

استجابة لإنشاء أذونات في ملاحظة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "permissions": [
    {
      object (Permission)
    }
  ]
}
الحقول
permissions[]

object (Permission)

تم إنشاء الأذونات.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/keep

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

CreatePermissionRequest

طلب إضافة إذن واحد إلى الملاحظة

تمثيل JSON
{
  "parent": string,
  "permission": {
    object (Permission)
  }
}
الحقول
parent

string

مطلوب. ملاحظة أحد الوالدَين التي سيتم إنشاء هذا الإذن فيها التنسيق: notes/{note}

permission

object (Permission)

مطلوب. الإذن بالإنشاء يجب تقديم أحد العناصر التالية: Permission.email أو User.email أو Group.email.