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

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