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

الحدّ الأقصى لعدد الردود المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد أو كان صفرًا، يتم عرض 5000 ردّ كحد أقصى.
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

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