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

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