يتضمّن هذا المستند معلومات التفويض والمصادقة الخاصة بـ 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.freebusy |
عرض مدى التوفّر في تقاويمك |
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" |
https://www.googleapis.com/auth/calendar.addons.current.event.read |
الاطّلاع على الأحداث التي تفتحها في "تقويم Google" |
https://www.googleapis.com/auth/calendar.addons.current.event.write |
تعديل الأحداث التي تفتحها في "تقويم Google" |
https://www.googleapis.com/auth/calendar.events.owned |
الاطّلاع على الأحداث وإنشاؤها وتغييرها وحذفها على تقاويم Google التي تملكها |
https://www.googleapis.com/auth/calendar.events.owned.readonly |
الاطّلاع على الأحداث في تقاويم Google التي تملكها |
https://www.googleapis.com/auth/calendar.events.freebusy |
الاطّلاع على مدى التوفّر في تقاويم Google التي يمكنك الوصول إليها |
https://www.googleapis.com/auth/calendar.app.created |
إنشاء تقاويم Google ثانوية، والاطّلاع على الأحداث المتضمّنة فيها وإنشاؤها وتغييرها وحذفها |
https://www.googleapis.com/auth/calendar.calendarlist |
الاطّلاع على تقاويم Google التي اشتركت فيها وإضافتها وإزالتها |
https://www.googleapis.com/auth/calendar.calendarlist.readonly |
الاطّلاع على قائمة تقاويم Google التي اشتركت فيها |
https://www.googleapis.com/auth/calendar.calendars |
الاطّلاع على الخصائص وتغييرها في تقاويم Google التي يمكنك الوصول إليها، وإنشاء التقاويم الثانوية |
https://www.googleapis.com/auth/calendar.calendars.readonly |
الاطّلاع على العنوان والوصف والمنطقة الزمنية التلقائية والخصائص الأخرى لتقاويم Google التي يمكنك الوصول إليها |
https://www.googleapis.com/auth/calendar.acls |
الاطّلاع على أذونات المشاركة وتغييرها في تقاويم Google التي تملكها |
https://www.googleapis.com/auth/calendar.acls.readonly |
الاطّلاع على أذونات المشاركة لتقاويم Google التي تملكها |
https://www.googleapis.com/auth/calendar.events.public.readonly |
الاطّلاع على الأحداث في التقاويم المتاحة للجميع |