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

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