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
مراقبة التغييرات التي تطرأ على موارد قائمة التحكّم بالوصول