Method: forms.create

יוצרים טופס חדש עם השם שצוין בהודעת הטופס שסופקה בבקשה.

חשוב: רק השדות form.info.title ו-form.info.document_title מועתקים לטופס החדש. אסור להשתמש בכל שדה אחר, כולל תיאור הטופס, הפריטים וההגדרות. כדי ליצור טופס חדש ולהוסיף פריטים, קודם צריך לקרוא ל-forms.create כדי ליצור טופס ריק עם כותרת וכותרת מסמך (אופציונלי), ואז לקרוא ל-forms.update כדי להוסיף את הפריטים.

בקשת HTTP

POST https://forms.googleapis.com/v1/forms

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

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

פרמטרים
unpublished

boolean

אופציונלי. האם הפרסום של הטופס בוטל. אם הערך מוגדר כ-true, לא ניתן לשלוח תשובות לטופס. אם הערך של הפרמטר הוא false או שהוא לא מוגדר, הטופס יפורסם ויקבל תשובות.

גוף הבקשה

גוף הבקשה מכיל מופע של Form.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Form.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/forms.body

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