Acl: update

تعديل قاعدة التحكّم بالوصول جرِّبها الآن.

طلب

طلب HTTP

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

المعلمات

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

التفويض

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

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

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

نص الطلب

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

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

قابل للكتابة
scope.value string عنوان البريد الإلكتروني لمستخدم أو مجموعة، أو اسم نطاق، حسب نوع النطاق تم حذفها للنوع "default". قابل للكتابة

الردّ

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

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

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