הצגת רשימה של תגובות לטופס.
בקשת HTTP
GET https://forms.googleapis.com/v1/forms/{formId}/responses
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
formId |
חובה. מזהה הטופס שיש למלא את התשובות שלו. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
filter |
אילו תגובות מהטופס להחזיר בשלב זה, המסננים היחידים שנתמכים הם:
כלומר, כל התגובות לטופס שנשלחו אחרי חותמת הזמן N (אך לא בשעה). *
כלומר, כל התגובות לטופס שנשלחו בחותמת הזמן N ואחריה. בשני המסננים הנתמכים, צריך להזין את חותמת הזמן בפורמט 'Zulu' RFC3339 UTC. דוגמאות: 2014-10-02T15:01:23Z ו-2014-10-02T15:01:23.045123456Z. |
pageSize |
המספר המקסימלי של תגובות שניתן להחזיר. השירות עשוי להחזיר ערך נמוך יותר מהערך הזה. אם לא צוינו או אפס, מוחזרות 5,000 תשובות לכל היותר. |
pageToken |
אסימון דף שהוחזר על-ידי תגובה קודמת של הרשימה. אם מגדירים את השדה הזה, הטופס והערכים של המסנן חייבים להיות זהים לאלה שבבקשה המקורית. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
תגובה ל-ListFormResponsesRequest.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"responses": [
{
object ( |
שדות | |
---|---|
responses[] |
התגובות לטופס שהוחזרו. הערה: השדה |
nextPageToken |
אם היא מוגדרת, יש תשובות נוספות. כדי לקבל את דף התשובות הבא, צריך להזין אותו בתור |
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/forms.responses.readonly
למידע נוסף, ניתן לעיין במדריך ההרשאות.