يتضمّن هذا المستند معلومات حول المصادقة والتفويض الخاصة بواجهة 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، وتتطلّب منك إكمال عملية إثبات ملكية النطاق المقيّد. للحصول على معلومات حول هذا الشرط، يُرجى الاطّلاع على سياسة بيانات المستخدمين الخاصة بخدمات Google API والمتطلبات الإضافية لنطاقات واجهة برمجة التطبيقات المحدّدة. في حال تخزين بيانات النطاق المحدود على خوادم (أو نقلها)، يجب اجتياز تقييم أمان.
إذا كان تطبيقك يتطلّب الوصول إلى أي واجهات Google APIs أخرى، يمكنك إضافة هذه النطاقات أيضًا. لمزيد من المعلومات عن نطاقات Google API، يُرجى الاطّلاع على استخدام بروتوكول OAuth 2.0 للدخول إلى واجهات Google APIs.
لمزيد من المعلومات حول نطاقات OAuth 2.0 المحدّدة، يُرجى الاطّلاع على نطاقات OAuth 2.0 في Google APIs.
مواضيع ذات صلة
- اختيار نطاقات Google Drive API
- مركز مساعدة التحقّق من تطبيقات OAuth
- الأسئلة الشائعة حول التحقّق من تطبيقات OAuth