Method: forms.responses.list

سرد ردود نموذج

طلب HTTP

GET https://forms.googleapis.com/v1/forms/{formId}/responses

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

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

المَعلمات
formId

string

مطلوبة. رقم تعريف النموذج الذي يتم إدراج ردوده في القائمة.

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

المَعلمات
filter

string

ردود النموذج المطلوب عرضها. في ما يلي الفلاتر الوحيدة المتاحة حاليًا:

timestamp > N

ما يعني الحصول على جميع الردود على النموذج المرسلة بعد (وليس عند) الطابع الزمني N. *

timestamp >= N

ما يعني الحصول على جميع الردود على النموذج المُرسلة عند الطابع الزمني N وبعده.

بالنسبة إلى كلا الفلترَين المتوافقَين، يجب أن يكون الطابع الزمني بتنسيق RFC3339 UTC "Zulu". أمثلة: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z".
pageSize

integer

تمثّل هذه السمة الحد الأقصى لعدد الردود المطلوب عرضها. وقد تعرِض الخدمة قيمة أقل من هذه القيمة. وفي حال عدم تحديد قيمة هذه السمة أو عدم توفّرها، سيتم عرض 5, 000 ردّ كحدّ أقصى.
pageToken

string

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

نص الطلب

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

نص الاستجابة

الرد على ListFormResponsesRequest.

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

تمثيل JSON 
{
  "responses": [
    {
      object (FormResponse)
    }
  ],
  "nextPageToken": string
}
الحقول
responses[]

object (FormResponse)

ردود النموذج المعروضة. ملاحظة: لا يتم عرض الحقل formId في الكائن FormResponse لطلبات القوائم.
nextPageToken

string

إذا تم ضبط السياسة، سيتم عرض المزيد من الردود. للحصول على الصفحة التالية من الردود، يُرجى تقديم هذه السمة كـ pageToken في طلب مستقبلي.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/forms.responses.readonly

لمزيد من المعلومات، راجِع دليل التفويض.