Method: comments.list

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

طلب HTTP

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

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

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

المَعلمات
fileId

string

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

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

المَعلمات
includeDeleted

boolean

لتحديد ما إذا كان سيتم تضمين تعليقات محذوفة. ولن تتضمّن التعليقات المحذوفة المحتوى الأصلي الخاص بها.
pageSize

integer

الحد الأقصى لعدد التعليقات المطلوب عرضها لكل صفحة.
pageToken

string

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

string

الحد الأدنى لقيمة "modifiedTime" لتعليقات النتيجة (التاريخ-الوقت RFC 3339)

نص الطلب

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

نص الاستجابة

قائمة التعليقات على ملف

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

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

string

تحدد نوع هذا المورد. القيمة: السلسلة الثابتة "drive#commentList".
comments[]

object (Comment)

قائمة التعليقات في حال تعبئة NextPageToken، قد تكون هذه القائمة غير مكتملة وسيتم جلب صفحة إضافية من النتائج.
nextPageToken

string

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

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

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

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

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