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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.