لإنشاء قاعدة التحكّم في الوصول جرِّب ذلك الآن.
الطلب
طلب 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 |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، قدِّم مورد Acl يتضمّن السمات التالية:
اسم السمة | القيمة | الوصف | ملاحظات |
---|---|---|---|
السمات المطلوبة | |||
role |
string |
الدور الذي تمّ تعيينه للنطاق القيم المحتمَلة هي:
|
قابلة للكتابة |
scope |
object |
مدى الوصول إلى التقويم الذي تمنحه قاعدة قائمة أذونات الوصول هذه | |
scope.type |
string |
نوع النطاق القيم المحتمَلة هي:
default " أو النطاق العام على أي مستخدم، سواء كان مصادقًا عليه أم لا. |
|
السمات الاختيارية | |||
scope.value |
string |
عنوان البريد الإلكتروني لمستخدم أو مجموعة، أو اسم نطاق، استنادًا إلى نوع النطاق تم حذفها للنوع "default ". |
قابلة للكتابة |
الردّ
في حال نجاح هذه الطريقة، تُرجع مورد Acl في نص الاستجابة.
جرّب الآن
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.