Method: comments.list

تعرض هذه الطريقة تعليقات ملف. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة التعليقات والردود.

مطلوب: يجب ضبط المَعلمة fields. لعرض الحقول التي تحتاج إليها بالضبط، راجِع عرض حقول معيّنة.

طلب 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 
{
  "comments": [
    {
      object (Comment)
    }
  ],
  "kind": string,
  "nextPageToken": string
}
الحقول
comments[]

object (Comment)

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

string

تحدّد نوع المورد. القيمة: السلسلة الثابتة "drive#commentList".
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

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