معلومات المصادقة والمصادقة الخاصة بواجهة برمجة التطبيقات

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

ما النطاق أو النطاقات التي يحتاجها تطبيقي؟

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

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

نطاقات Google Drive

تدعم واجهة برمجة تطبيقات Drive النطاقات التالية:

رمز النطاق الوصف الاستخدام
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.appfolder
عرض وإدارة بيانات تهيئة التطبيق في Google Drive. موصى به
غير حساس
https://www.googleapis.com/auth/drive.install السماح للتطبيقات بالظهور كخيار في القائمة "فتح باستخدام" أو "جديد". موصى به
غير حساس
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.resource
عرض وإدارة ملفات ومجلدات Drive التي تفتحها أو تنشئها باستخدام تطبيق. موصى به
غير حساس
https://www.googleapis.com/auth/auth/drive.apps.readonly عرض التطبيقات المصرح لها بالوصول إلى Drive. الفئات الحساسة
https://www.googleapis.com/auth/drive عرض جميع ملفات Drive وإدارتها. محصورة الاستخدام
https://www.googleapis.com/auth/drive.metadata عرض البيانات الوصفية للملفات وإدارتها في Drive. محصورة الاستخدام
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.readonly.metadata
عرض البيانات الوصفية للملفات في Drive. محصورة الاستخدام
https://www.googleapis.com/auth/drive.readonly عرض جميع ملفات Drive وتنزيلها. محصورة الاستخدام
https://www.googleapis.com/auth/drive.scripts تعديل سلوك النصوص البرمجية لبرمجة تطبيقات Google. محصورة الاستخدام

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

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

لمزيد من المعلومات حول نطاقات OAuth 2.0 محددة، انظر نطاقات OAuth 2.0 لواجهات برمجة تطبيقات Google.

التحقق من OAuth

قد يتطلب استخدام نطاقات OAuth معينة متابعة تطبيقك خلال عملية التحقق عبر OAuth من Google. يمكنك الاطّلاع على الأسئلة الشائعة حول التحقّق من واجهة برمجة تطبيقات OAuth لتحديد متى يجب التحقق من تطبيقك ونوع التحقّق المطلوب. انظر أيضًا بنود خدمة Google Drive الإضافية.

حالات استخدام نطاق مقيَّد

بالنسبة إلى Drive، يمكن لأنواع التطبيقات التالية فقط الوصول إلى النطاقات المحظورة:

  1. تطبيقات الويب والتطبيقات الأساسية الخاصة بالنظام الأساسي التي توفر مزامنة محلية أو النسخ الاحتياطي التلقائي لملفات Drive للمستخدمين.
  2. تطبيقات الإنتاجية والتطبيقات التعليمية التي قد تشتمل واجهة المستخدم التابعة لها على تفاعل مع ملفات Drive (أو البيانات الوصفية أو الأذونات). تتضمن تطبيقات الإنتاجية إدارة المهام، وتدوين الملاحظات، واتصالات مجموعة العمل، وتطبيقات التعاون في الفصل الدراسي.
  3. تطبيقات إعداد التقارير والأمان التي تقدم إحصاءات المستخدم أو العميل حول كيفية مشاركة الملفات أو الوصول إليها.

لمواصلة استخدام النطاقات المشروطة، عليك إعداد تطبيقك لإثبات ملكية النطاق المشروط.

نقل بيانات تطبيق حالي من النطاقات المحظورة

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

حفظ الرموز المميزة للتحديث

احفظ الرموز المميزة للتحديث في سعة تخزين آمنة وطويلة الأجل واستمر في استخدامها طالما أنها لا تزال صالحة.