Method: files.listLabels

يتم إدراج التصنيفات في ملف.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

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

المَعلمات
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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

بعض النطاقات مقيَّدة وتتطلَّب تقييم أمان لكي يستخدمها تطبيقك. لمزيد من المعلومات، اطّلِع على دليل التفويض.