Method: notes.permissions.batchCreate

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
parent

string

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

نص الطلب

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

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

object (CreatePermissionRequest)

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

نص الاستجابة

ردّ إنشاء أذونات في ملاحظة.

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

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

object (Permission)

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

نطاقات الأذونات

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

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

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

طلب إذن

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

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

string

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

object (Permission)

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