Acl: insert

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

طلب

طلب HTTP

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

المعلمات

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

التفويض

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

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

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

نص الطلب

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

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

قابل للكتابة
scope object مدى منح إذن الوصول إلى التقويم بموجب قاعدة قائمة التحكّم بالوصول هذه
scope.type string نوع النطاق. القيم المحتمَلة هي:
  • ‫"default": النطاق العام هذه هي القيمة الافتراضية.
  • ‫"user": يقتصر النطاق على مستخدم واحد.
  • ‫"group": يحصر النطاق في مجموعة.
  • "domain": يقتصر النطاق على نطاق معيّن.
ملاحظة: تنطبق الأذونات الممنوحة للنطاق "default" أو النطاق العام على أي مستخدم، سواء كان مصادقًا عليه أم لا.
السمات الاختيارية
scope.value string عنوان البريد الإلكتروني لمستخدم أو مجموعة، أو اسم نطاق، حسب نوع النطاق تم حذفها للنوع "default". قابل للكتابة

الردّ

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

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

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