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