Acl: insert

يؤدي هذا الطلب إلى إنشاء قاعدة للتحكّم في الوصول. جرِّبها الآن.

طلب

طلب HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
calendarId string معرّف التقويم لاسترداد أرقام تعريف التقويمات، يُرجى طلب بيانات من طريقة calendarList.list. إذا أردت الوصول إلى التقويم الأساسي للمستخدم الذي سجّل الدخول حاليًا، استخدِم الكلمة الرئيسية "primary".
معامِلات طلب البحث الاختيارية
sendNotifications boolean ما إذا كان سيتم إرسال إشعارات حول تغيير إعدادات مشاركة التقويم اختياريّ. القيمة التلقائية هي True.

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية:

النطاق
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

في نص الطلب، قدِّم مورد Acl يتضمّن السمات التالية:

اسم السمة القيمة الوصف ملاحظات
السمات المطلوبة
role string الدور الذي تم تعيينه للنطاق القيم المحتمَلة هي:
  • "none" : لا يمنح أي إذن وصول.
  • "freeBusyReader" : يمنح إذن القراءة لمعلومات التوفّر/الانشغال.
  • "reader" : يمنح إذن القراءة للتقويم. ستظهر الأحداث الخاصة للمستخدمين الذين لديهم إذن القراءة، ولكن سيتم إخفاء تفاصيل الحدث.
  • "writerWithoutPrivateAccess" : يمنح إذن القراءة والكتابة في التقويم. ستظهر الأحداث الخاصة للمستخدمين الذين لديهم إذن writerWithoutPrivateAccess، ولكن سيتم إخفاء تفاصيل الحدث.
  • "writer" : يمنح إذن القراءة والكتابة في التقويم. ستظهر الأحداث الخاصة للمستخدمين الذين لديهم إذن الكتابة، وستكون تفاصيل الحدث مرئية. يمنح إذن القراءة لقوائم التحكّم بالوصول (ACL) في التقويم.
  • "owner" : يمنح إذن الوصول إلى التقويم كمدير. يتضمّن هذا الدور جميع أذونات دور الكاتب مع إمكانية إضافية لتعديل مستويات وصول المستخدمين الآخرين.

قابل للكتابة
scope object المدى الذي يتم فيه منح إذن الوصول إلى التقويم بموجب قاعدة قائمة التحكّم بالوصول (ACL) هذه
scope.type string نوع النطاق القيم المحتمَلة هي:
  • "default" : النطاق العلني هذه هي القيمة الافتراضية.
  • "user" : يقتصر النطاق على مستخدم واحد.
  • "group" : يقتصر النطاق على مجموعة.
  • "domain" : يقتصر النطاق على نطاق.
ملاحظة: تنطبق الأذونات الممنوحة للنطاق "default" أو النطاق العلني على أي مستخدم، سواء كان مصادقًا أم لا.
السمات الاختيارية
scope.value string عنوان البريد الإلكتروني لمستخدم أو مجموعة، أو اسم نطاق، حسب نوع النطاق يتم حذف هذا الحقل للنوع "default". قابل للكتابة

الردّ

إذا نجحت هذه الطريقة، ستعرض مورد Acl في نص الردّ.

جرِّبها الآن.

استخدِم أداة مستكشف واجهات برمجة التطبيقات أدناه لطلب بيانات من هذه الطريقة على بيانات مباشرة والاطّلاع على الردّ.