Method: forms.responses.list

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

בקשת HTTP

GET https://forms.googleapis.com/v1beta/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)

התשובות שהוחזרו.
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

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