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

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