Method: comments.list

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

طلب HTTP

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

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

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

المَعلمات
fileId

string

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

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

المَعلمات
includeDeleted

boolean

ما إذا كان سيتم تضمين التعليقات المحذوفة. لن تشمل التعليقات المحذوفة المحتوى الأصلي.
pageSize

integer

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

string

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

string

الحد الأدنى لقيمة "modifiedTime" للتعليقات على النتائج (RFC 3339 date-time).

نص الطلب

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

نص الاستجابة

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

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

تمثيل 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

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