Method: comments.list

تعرض هذه الطريقة تعليقات ملف.

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
includeDeleted

boolean

في حال ضبط هذا الخيار، سيتم عرض جميع التعليقات والردود، بما في ذلك التعليقات والردود المحذوفة (مع إزالة المحتوى).
maxResults

integer

الحدّ الأقصى لعدد المناقشات التي سيتم تضمينها في الردّ، ويُستخدم هذا الحدّ للتصفّح.
pageToken

string

رمز المواصلة، يُستخدَم للتنقّل بين صفحات مجموعات النتائج الكبيرة. للحصول على الصفحة التالية من النتائج، اضبط هذه المَعلمة على قيمة "nextPageToken" من الاستجابة السابقة.
updatedMin

string

سيتم عرض المناقشات التي تم تعديلها بعد هذا الطابع الزمني فقط. يتم تنسيقه كطابع زمني RFC 3339.

نص الطلب

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

نص الاستجابة

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

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

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

object (Comment)

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

string

تكون القيمة دائمًا drive#commentList.
nextPageToken

string

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

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

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

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