Method: files.listLabels

تعرض التصنيفات على ملف.

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
maxResults

integer

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

pageToken

string

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

نص الطلب

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

نص الاستجابة

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

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

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

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.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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