Acl

للحصول على قائمة بالطُرق لهذا المرجع، يُرجى الاطّلاع على نهاية هذه الصفحة.

تمثيلات الموارد

{
  "kind": "calendar#aclRule",
  "etag": etag,
  "id": string,
  "scope": {
    "type": string,
    "value": string
  },
  "role": string
}
اسم السمة القيمة الوصف ملاحظات
etag etag علامة ETag للمورد
id string معرّف قاعدة قائمة التحكّم بالوصول (ACL) راجِع مقالة مشاركة التقاويم.
kind string نوع المورد ("calendar#aclRule").
role string الدور الذي تمّ تعيينه للنطاق القيم المحتمَلة هي:
  • "none": لا توفّر إمكانية الوصول.
  • "freeBusyReader": يمنح إذن الوصول للقراءة إلى معلومات مدى التوفّر.
  • "reader": يمنح إذن الوصول للقراءة إلى التقويم. ستظهر الأحداث الخاصة للمستخدمين الذين لديهم إذن وصول "قارئ"، ولكن سيتم إخفاء تفاصيل الحدث.
  • "writer": يمنح إذن الوصول للقراءة والكتابة في التقويم. ستظهر الأحداث الخاصة للمستخدمين الذين لديهم إذن وصول بصفتهم كاتبًا، وستظهر تفاصيل الحدث. يمنح إذن الوصول للقراءة إلى قوائم التحكّم في الوصول الخاصة بالتقويم.
  • "owner": تمنح ملكية التقويم. يمتلك هذا الدور جميع أذونات دور "الكاتب" مع إمكانية إضافية للتلاعب بجداول أذونات الوصول.
 قابلة للكتابة
scope object مدى الوصول إلى التقويم الذي تمنحه قاعدة قائمة أذونات الوصول هذه
scope.type string نوع النطاق القيم المحتمَلة هي:
  • "default": النطاق العام هذه هي القيمة الافتراضية.
  • "user" - تحدّ من النطاق لمستخدم واحد.
  • "group" - حصر النطاق في مجموعة
  • "domain" - تحدّ من النطاق إلى نطاق.
ملاحظة: تنطبق الأذونات الممنوحة لنطاق "default" أو النطاق العام على أي مستخدم، سواء كان مصادقًا عليه أم لا.
scope.value string عنوان البريد الإلكتروني لمستخدم أو مجموعة، أو اسم نطاق، استنادًا إلى نوع النطاق تم حذفها للنوع "default". قابلة للكتابة

الطُرق

حذف
لحذف قاعدة تحكّم في الوصول
الحصول
يعرض قاعدة تحكّم في الوصول.
إدراج
تُنشئ قاعدة التحكّم في الوصول.
list
تعرض القواعد في قائمة التحكّم بالوصول إلى التقويم.
patch
تعديل قاعدة التحكّم في الوصول تتيح هذه الطريقة بنية التصحيح. يُرجى العلم أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، لذا ننصحك باستخدام get متبوعًا بـ update. تحلّ قيم الحقول التي تحدّدها محل القيم الحالية. تظل الحقول التي لا تحدّدها في الطلب بدون تغيير. إذا تم تحديد حقول الصفيف، يتم استبدال الصفائف الحالية بها، ما يؤدي إلى تجاهل أي عناصر صفيف سابقة.
تعديل
تعديل قاعدة التحكّم في الوصول
watch
راقِب التغييرات في موارد قائمة التحكّم بالوصول.