اختيار نطاقات واجهة برمجة التطبيقات لمستندات Google

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

إعداد OAuth 2.0 للتفويض

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

نطاقات Docs API

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

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

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

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

رمز النطاق الوصف الاستخدام
https://www.googleapis.com/auth/documents الاطّلاع على كل مستنداتك على "مستندات Google" وتعديلها وإنشاؤها وحذفها الفئات الحساسة
https://www.googleapis.com/auth/documents.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.