Method: labels.get

يمكنك الحصول على تصنيف حسب اسم مورده. يمكن أن يكون اسم المورد أيًا مما يلي:

  • labels/{id} - الاطّلاع على labels/{id}@latest
  • labels/{id}@latest - للحصول على أحدث نسخة من التصنيف.
  • labels/{id}@published - للحصول على النسخة المنشورة حاليًا من التصنيف.
  • labels/{id}@{revisionId} - يحصل على التصنيف بمعرّف النسخة السابقة المحدّد.

طلب HTTP

GET https://drivelabels.googleapis.com/v2beta/{name=labels/*}

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
name

string

مطلوبة. اسم مورد التصنيف.

يمكن أن يكون أيًا مما يلي:

  • labels/{id} (تعادل التصنيفات/{id}@latest)
  • labels/{id}@latest
  • labels/{id}@published
  • labels/{id}@{revisionId}

معلمات طلب البحث

المَعلمات
useAdminAccess

boolean

يمكنك ضبط القيمة على true لاستخدام بيانات اعتماد المشرف الخاصة بالمستخدم. يتحقّق الخادم من أنّ المستخدم مشرف على التصنيف قبل السماح بالوصول إليه.

languageCode

string

يشير ذلك إلى رمز اللغة BCP-47 المطلوب استخدامه لتقييم تصنيفات الحقول المترجَمة. وعند عدم تحديدها، يتم استخدام القيم باللغة التلقائية التي تم ضبطها.

view

enum (LabelView)

عند تحديدها، لا يتم عرض سوى حقول معينة تنتمي إلى العرض المُشار إليه.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Label.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

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