Method: files.listLabels

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

طلب HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/listLabels

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

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

المَعلمات
fileId

string

رقم التعريف للملف.

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

المَعلمات
maxResults

integer

تمثّل هذه السمة الحد الأقصى لعدد التصنيفات المطلوب عرضها لكل صفحة. وفي حال ترك هذه السياسة بدون ضبط، يتم ضبط القيمة التلقائية على 100.

pageToken

string

الرمز المميّز لمتابعة طلب قائمة سابق في الصفحة التالية ويجب ضبط هذه السياسة على قيمة nextPageToken من الردّ السابق.

نص الطلب

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

نص الاستجابة

قائمة التصنيفات التي تم تطبيقها على ملف

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "items": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
الحقول
items[]

object (Label)

قائمة التصنيفات.

nextPageToken

string

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

kind

string

دائمًا ما تكون drive#labelList

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.