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 ואחריה.

בשני המסננים הנתמכים, צריך לציין את חותמת הזמן בפורמט Zulu RFC3339 UTC הפורמט. דוגמאות: 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

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