Method: forms.responses.list

הצגת רשימה של התשובות לטופס.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
formId

string

חובה. המזהה של הטופס שרוצים להציג את התשובות שלו.

פרמטרים של שאילתה

פרמטרים
filter

string

אילו תגובות לטופס להחזיר. בשלב זה, המסננים הנתמכים הם:

timestamp > N

כלומר, המערכת תציג את כל התשובות שנשלחו מהטופס אחרי חותמת הזמן N (אבל לא באותו זמן). *

timestamp >= N

כלומר, המערכת תציג את כל התשובות שנשלחו בטופס בחותמת הזמן N ואילך.

בשני המסננים הנתמכים, חותמת הזמן צריכה להיות בפורמט 'Zulu' של UTC‏ RFC3339. דוגמאות: ‎"2014-10-02T15:01:23Z" ו-‎ "2014-10-02T15:01:23.045123456Z".
pageSize

integer

המספר המקסימלי של התשובות שיוחזר. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא צוין ערך או שהערך הוא אפס, יוחזרו עד 5,000 תשובות.
pageToken

string

טוקן דף שהוחזר בתגובה קודמת לרשימת פריטים. אם השדה הזה מוגדר, הטופס והערכים של המסנן חייבים להיות זהים לאלה של הבקשה המקורית.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

תגובה לבקשה מסוג ListFormResponses.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-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

מידע נוסף זמין במדריך ההרשאות.