يسرد تعليقات ملف.
طلب HTTP
GET https://www.googleapis.com/drive/v2/files/{fileId}/comments
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
fileId |
رقم تعريف الملف. |
معلمات طلب البحث
المَعلمات | |
---|---|
includeDeleted |
وإذا تم ضبط السياسة، سيتم عرض كل التعليقات والردود، بما في ذلك التعليقات والردود المحذوفة (التي تمت إزالة المحتوى منها). |
maxResults |
الحد الأقصى لعدد المناقشات التي يمكن تضمينها في الرد، ويتم استخدامه من أجل الانتقال من صفحة إلى أخرى. |
pageToken |
هو الرمز المميّز للمتابعة والذي يُستخدم في الصفحات من خلال مجموعات النتائج الكبيرة. للحصول على الصفحة التالية من النتائج، اضبط هذه المَعلمة على قيمة "nextPageToken" من الاستجابة السابقة. |
updatedMin |
ولن يتم عرض سوى المناقشات التي تم تعديلها بعد هذا الطابع الزمني. يتم تنسيقه كطابع زمني RFC 3339. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة التعليقات على ملف في Google Drive
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
الحقول | |
---|---|
kind |
دائمًا ما تكون |
selfLink |
رابط للرجوع إلى هذه القائمة. |
nextLink |
رابط إلى الصفحة التالية من التعليقات. |
items[] |
قائمة التعليقات في حال تعبئة NextPageToken، قد تكون هذه القائمة غير مكتملة وسيتم جلب صفحة إضافية من النتائج. |
nextPageToken |
الرمز المميز للصفحة للصفحة التالية من التعليقات. لن يظهر هذا الخيار في حال الوصول إلى نهاية قائمة التعليقات. وإذا تم رفض الرمز المميز لأي سبب من الأسباب، يجب تجاهله وإعادة تشغيل التقسيم على صفحات من الصفحة الأولى من النتائج. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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.readonly
تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.