Acl

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

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

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

الطُرق

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