يتضمّن هذا المستند معلومات حول المصادقة والتفويض خاصة بواجهة 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 |
الاطّلاع على الأحداث على التقاويم العامة |