اختيار نطاقات واجهة برمجة التطبيقات لتصنيفات 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 المناسب لهذا التصنيف.

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