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

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