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

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

يُرجى العِلم أنّه يتم تطبيق نطاقات Sheets API على ملف جدول بيانات ولا يمكن أن تقتصر على ورقة معيّنة. لمنع تعديل ورقة بيانات، استخدِم ProtectedRange لتحديد خلية أو نطاق من الخلايا لا يمكن تعديلها. للاطّلاع على مثال، راجِع النطاقات المسماة والمحمية.

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

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

نطاقات Sheets API

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

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

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

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

رمز النطاق الوصف الاستخدام
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.