Method: labels.get

الحصول على تصنيف حسب اسم المورد لمزيد من المعلومات، اطّلِع على البحث عن التصنيفات.

يمكن أن يكون اسم المورد أيًّا ممّا يلي:

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

طلب HTTP

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

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

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

المعلمات
name

string

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

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

  • ‫labels/{id} (يساوي labels/{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

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