يحتوي هذا المستند على معلومات المصادقة والمصادقة الخاصة بـ Google Calendar API. قبل قراءة هذا المستند، احرِص على قراءة المعلومات العامة حول المصادقة والتفويض في Google Workspace على الرابط التعرّف على المصادقة والتفويض.
تهيئة OAuth 2.0 للتفويض
اضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth واختَر النطاقات لتحديد المعلومات التي يتم عرضها للمستخدمين ومراجعي التطبيقات، وتسجيل تطبيقك لتتمكّن من نشره لاحقًا.
نطاقات Calendar API
لتحديد مستوى الوصول الممنوح لتطبيقك، عليك تحديد نطاقات التفويض وتعريفها. إنّ نطاق التفويض هو سلسلة معرّف موارد منتظم (URI) لـ OAuth 2.0 تحتوي على اسم تطبيق Google Workspace ونوع البيانات التي يصل إليها ومستوى الوصول. النطاقات هي طلبات تطبيقك للعمل مع بيانات Google Workspace، بما في ذلك بيانات حسابات المستخدمين على Google.
عند تثبيت تطبيقك، يُطلب من المستخدم التحقّق من صحة النطاقات التي يستخدمها التطبيق. بشكل عام، عليك اختيار النطاق الأكثر تركيزًا وتجنُّب طلب النطاقات التي لا يتطلبها تطبيقك. يمنح المستخدمون الوصول بسهولة إلى نطاقات محدودة وواضحة.
توفّر واجهة برمجة التطبيقات Calendar API النطاقات التالية:
| النطاق | المعنى |
|---|---|
https://www.googleapis.com/auth/calendar |
الاطّلاع على جميع التقاويم التي يمكنك الوصول إليها باستخدام "تقويم Google" وتعديلها ومشاركتها وحذفها نهائيًا |
https://www.googleapis.com/auth/calendar.readonly |
يمكنك الاطّلاع على أي تقويم يمكنك الوصول إليه وتنزيله باستخدام "تقويم Google". |
https://www.googleapis.com/auth/calendar.events |
عرض الأحداث وتعديلها في جميع تقاويمك |
https://www.googleapis.com/auth/calendar.events.readonly |
عرض الأحداث في جميع تقاويمك |
https://www.googleapis.com/auth/calendar.settings.readonly |
عرض إعدادات "تقويم Google" |
https://www.googleapis.com/auth/calendar.addons.execute |
التشغيل كإضافة في "تقويم Google". |