اختيار نطاقات واجهة برمجة التطبيقات لتصنيفات Google Drive

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

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

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

نطاقات Google Drive Labels API

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

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

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

يمكن استخدام نطاقات OAuth 2.0 التالية لقراءة بيانات وصفية خاصة بالتصنيفات والبحث عنها وتعديلها، والتي يتم تطبيقها على عناصر Drive:

النطاق المعنى
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
قراءة البيانات الوصفية للتصنيفات المطبَّقة على عناصر Drive والبحث فيها وتعديلها
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.metadata.readonly
قراءة البيانات الوصفية للتصنيفات المطبَّقة على عناصر Drive المصرَّح بها للتطبيق والبحث فيها

لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات OAuth 2.0 في Drive API وتفويض Drive API.

نطاقات التصنيفات

يمكن استخدام نطاقات OAuth التالية لعرض التصنيفات وإدارتها:

النطاق المعنى
https://www.googleapis.com/auth/drive.labels الاطّلاع على تصنيفات Drive واستخدامها وإدارتها
  • يسمح هذا النطاق للمستخدم بالوصول، وهو مطلوب لعمليات الكتابة عندما لا يتم ضبط use_admin_access.
  • تكون عمليات الكتابة بهذا النطاق صالحة للتصنيفات التي تحمل SHARED نوع التصنيف.
https://www.googleapis.com/auth/drive.labels.readonly الاطّلاع على تصنيفات Drive واستخدامها
  • يسمح هذا النطاق بوصول المستخدم، وهو مطلوب لعمليات القراءة عندما لا يتم ضبط use_admin_access.
https://www.googleapis.com/auth/drive.admin.labels الاطّلاع على جميع التصنيفات في Drive وتعديلها وإنشاؤها وحذفها، والاطّلاع على سياسات الإدارة المتعلّقة بالتصنيفات في مؤسستك
  • يسمح هذا النطاق بالوصول إلى المشرف، وهو مطلوب لعمليات الكتابة عند ضبط use_admin_access. يمنح هذا النطاق أيضًا إذن الوصول للقراءة.
  • تكون عمليات الكتابة بهذا النطاق صالحة للتصنيفات التي تحمل SHARED أو ADMIN نوع التصنيف.
https://www.googleapis.com/auth/drive.admin.labels.readonly الاطّلاع على جميع تصنيفات Drive وسياسات الإدارة المتعلّقة بها في مؤسستك
  • يسمح هذا النطاق بوصول المشرف، وهو مطلوب لعمليات القراءة عند ضبط use_admin_access.

إذن وصول المشرف

لإدارة تصنيفات ADMIN، يجب تحديد ما يلي:

  • useAdminAccess هو true لاستخدام بيانات اعتماد المشرف الخاصة بالمستخدم.
  • مشرفو الحسابات الذين لديهم امتياز إدارة التصنيفات

useAdminAccess

على المشرفين ضبط المَعلمة useAdminAccess لاستخدام امتيازات المشرف. يسمح الإعداد useAdminAccess بعرض أي تصنيف يملكه أحد العملاء وتعديله. ويشمل ذلك كلاً من تصنيفات ADMIN وSHARED.

عندما لا يتم ضبط useAdminAccess، لا يُسمح بطلبات الكتابة إلا للتصنيفات التي تتضمّن SHARED label type، وللمستخدمين الذين لديهم دور EDITOR المناسب لهذا التصنيف.

لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء بيانات اعتماد الوصول.