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 
{
  "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

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