لإنشاء إذن واحد أو أكثر في الملاحظة لا يمكن إنشاء سوى الأذونات التي تحمل الدور WRITER. إذا تعذّرت إضافة أي إذن، يتعذّر إكمال الطلب بالكامل ولا يتم إجراء أي تغييرات.
طلب HTTP
POST https://keep.googleapis.com/v1/{parent=notes/*}/permissions:batchCreate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
parent |
المورد الرئيسي الذي تتم مشاركته من خلال جميع الأذونات التي يتم إنشاؤها. التنسيق: |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
|---|
{
"requests": [
{
object ( |
| الحقول | |
|---|---|
requests[] |
رسالة الطلب التي تحدّد الموارد المطلوب إنشاؤها |
نص الاستجابة
استجابة لإنشاء أذونات في ملاحظة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
|---|
{
"permissions": [
{
object ( |
| الحقول | |
|---|---|
permissions[] |
تم إنشاء الأذونات. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/keep
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
CreatePermissionRequest
طلب إضافة إذن واحد إلى الملاحظة
| تمثيل JSON |
|---|
{
"parent": string,
"permission": {
object ( |
| الحقول | |
|---|---|
parent |
مطلوب. ملاحظة أحد الوالدَين التي سيتم إنشاء هذا الإذن فيها التنسيق: |
permission |
مطلوب. الإذن بالإنشاء يجب تقديم أحد العناصر التالية: Permission.email أو User.email أو Group.email. |