اختيار نطاقات Google Slides API

يتضمّن هذا المستند معلومات عن المصادقة والتفويض الخاصة بواجهة Google Slides API. قبل قراءة هذا المستند، احرص على قراءة معلومات المصادقة والتفويض العامة في Google Workspace على مزيد من المعلومات عن المصادقة والتفويض.

ضبط OAuth 2.0 للحصول على إذن

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth واختيار النطاقات لتحديد المعلومات التي يتم عرضها للمستخدمين ومراجعي التطبيقات، وتسجيل تطبيقك كي تتمكّن من نشره لاحقًا

نطاقات Slides API

لتحديد مستوى الوصول الممنوح لتطبيقك، عليك تحديد نطاقات الأذونات والإفصاح عنها. نطاق التفويض هو سلسلة URI لبروتوكول OAuth 2.0 تحتوي على اسم تطبيق Google Workspace ونوع البيانات التي يمكنه الوصول إليها ومستوى الوصول. النطاقات هي طلبات تطبيقك للعمل مع بيانات Google Workspace، بما في ذلك البيانات في حساب Google للمستخدمين.

عند تثبيت تطبيقك، يُطلب من المستخدم التحقّق من صحة النطاقات المستخدَمة في التطبيق. وبشكل عام، عليك اختيار النطاق الأكثر تركيزًا وتجنُّب طلب النطاقات التي لا يحتاجها تطبيقك. يمنح المستخدمون إذن الوصول إلى النطاقات المحدودة والموضّحة بوضوح بشكل أسهل.

ننصحك، متى أمكن ذلك، باستخدام النطاقات غير الحسّاسة لأنّها تمنح نطاق الوصول إلى كل ملف على حدة وتضيّق نطاق الوصول إلى الميزات المحدّدة التي يحتاجها التطبيق.

تتيح واجهة برمجة التطبيقات Slides API استخدام النطاقات التالية:

رمز النطاق الوصف الاستخدام
https://www.googleapis.com/auth/presentations الاطّلاع على كل عروضك التقديمية على "العروض التقديمية من Google" وتعديلها وإنشاؤها وحذفها حسّاس
https://www.googleapis.com/auth/presentations.readonly الاطّلاع على كل عروضك التقديمية على "العروض التقديمية من Google" حسّاس
https://www.googleapis.com/auth/spreadsheets عرض كل جداول بياناتك على "جداول بيانات Google" وتعديلها وإنشاؤها وحذفها حسّاس
https://www.googleapis.com/auth/spreadsheets.readonly عرض كل جداول بياناتك على "جداول بيانات Google" حسّاس
https://www.googleapis.com/auth/drive.file الاطّلاع على ملفات Google Drive المحدّدة التي تستخدمها مع هذا التطبيق وتعديلها وإنشاؤها وحذفها مقترَحة
غير حساسة
https://www.googleapis.com/auth/drive الاطّلاع على جميع ملفاتك في Google Drive وتعديلها وإنشاؤها وحذفها محدود
https://www.googleapis.com/auth/drive.readonly الاطّلاع على جميع ملفات Google Drive وتنزيلها محدود

يشير عمود "الاستخدام" في الجدول إلى حساسية كل نطاق، وذلك وفقًا للتعريفات التالية:

إذا كان تطبيقك يتطلّب الوصول إلى أي واجهات برمجة تطبيقات أخرى من Google، يمكنك إضافة هذه النطاقات أيضًا. لمزيد من المعلومات عن نطاقات Google API، يُرجى الاطّلاع على استخدام بروتوكول OAuth 2.0 للدخول إلى واجهات Google APIs.

لمزيد من المعلومات حول نطاقات OAuth 2.0 المحدّدة، يُرجى الاطّلاع على نطاقات OAuth 2.0 لـ Google APIs.