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.