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" - توفير ملكية التقويم. ويشمل هذا الدور جميع الأذونات الممنوحة لدور الكاتب بالإضافة إلى إمكانية الاطّلاع على قوائم التحكم بالوصول (ACLs) ومعالجتها.
 قابل للكتابة
scope object مدى منح الوصول إلى التقويم من خلال قاعدة قائمة التحكم بالوصول (ACL) هذه.
scope.type string نوع النطاق. القيم المتاحة:
  • "default" - النطاق العام: هذه هي القيمة الافتراضية.
  • "user" - يقصر النطاق على مستخدم واحد.
  • "group" - يقصر النطاق على مجموعة.
  • "domain" - يقصر النطاق على نطاق.
ملاحظة: تسري الأذونات الممنوحة للنطاق "default" أو النطاق العلني على أي مستخدم تمت مصادقته أو لا.
scope.value string عنوان البريد الإلكتروني لمستخدم أو مجموعة أو اسم نطاق حسب نوع النطاق تم الحذف للنوع "default". قابل للكتابة

الطُرق

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