REST Resource: forms

משאב: טופס

מסמך ב-Google Forms. הטופס נוצר ב-Drive, ומחיקה של טופס או שינוי של אמצעי הגנה על הגישה שלו מתבצעים דרך Drive API.

ייצוג ב-JSON
{
  "formId": string,
  "info": {
    object (Info)
  },
  "settings": {
    object (FormSettings)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "revisionId": string,
  "responderUri": string,
  "linkedSheetId": string,
  "publishSettings": {
    object (PublishSettings)
  }
}
שדות
formId

string

פלט בלבד. מזהה הטופס.

info

object (Info)

חובה. הכותרת והתיאור של הטופס.

settings

object (FormSettings)

הגדרות הטופס. צריך לעדכן את השדה הזה באמצעות UpdateSettingsRequest. הוא מתעלם במהלך forms.create ו-UpdateFormInfoRequest.

items[]

object (Item)

חובה. רשימה של הפריטים בטופס, שיכולים לכלול כותרות של קטעים, שאלות, מדיה מוטמעת וכו'.

revisionId

string

פלט בלבד. מזהה הגרסה הקודמת של הטופס. השדה הזה מופיע ב-WriteControl בבקשות עדכון כדי לזהות את הגרסה שעל בסיסה מתבצעים השינויים.

הפורמט של מזהה הגרסה עשוי להשתנות עם הזמן, לכן צריך להתייחס אליו כאל ערך אטום. מזהה הגרסה המוחזרת תקף רק למשך 24 שעות לאחר ההחזרה, ואי אפשר לשתף אותו בין משתמשים. אם מזהה הגרסה לא השתנה בין הקריאות, סימן שהתוכן של הטופס לא השתנה. לעומת זאת, אם המזהה השתנה (באותו טופס ובאותו משתמש), בדרך כלל המשמעות היא שהתוכן של הטופס עודכן. עם זאת, שינוי במזהה יכול לנבוע גם מגורמים פנימיים, כמו שינויים בפורמט המזהה.

תוכן הטופס לא כולל את המטא-נתונים של הטופס, כולל:

  • הגדרות השיתוף (למי יש גישה לטופס)
  • publishSettings (אם הטופס תומך בפרסום ואם הוא פורסם)
responderUri

string

פלט בלבד. ה-URI של הטופס שרוצים לשתף עם המשיבים. ייפתח דף שבו המשתמש יוכל לשלוח תשובות, אבל לא לערוך את השאלות. בטופס שבו מוגדר הערך publishSettings, זהו ה-URI של הטופס שפורסם.

linkedSheetId

string

פלט בלבד. המזהה של הגיליון האלקטרוני המקושר ב-Google Sheets שמצטברות בו תשובות מהטופס הזה (אם קיים גיליון כזה).

publishSettings

object (PublishSettings)

פלט בלבד. הגדרות הפרסום של טופס. השדה הזה לא מוגדר בטפסים מדור קודם כי אין בהם את השדה publishSettings. כל הטפסים החדשים שנוצרים תומכים בהגדרות פרסום.

טפסים שהוגדר להם הערך publishSettings יכולים להפעיל את forms.setPublishSettings API כדי לפרסם או לבטל את הפרסום של הטופס.

מידע

המידע הכללי של טופס.

ייצוג ב-JSON
{
  "title": string,
  "documentTitle": string,
  "description": string
}
שדות
title

string

חובה. כותרת הטופס שגלויה למשיבים.

documentTitle

string

פלט בלבד. כותרת המסמך שמוצגת ב-Drive. אם השדה Info.title ריק, יכול להיות שהשדה documentTitle יופיע במקומו בממשק המשתמש של Google Forms ויהיה גלוי למשיבים. אפשר להגדיר את documentTitle בזמן היצירה, אבל אי אפשר לשנות אותו באמצעות בקשת batchUpdate. אם אתם צריכים לעדכן את documentTitle באופן פרוגרמטי, צריך להשתמש ב-Google Drive API.

description

string

התיאור של הטופס.

FormSettings

ההגדרות של טופס.

ייצוג ב-JSON
{
  "quizSettings": {
    object (QuizSettings)
  },
  "emailCollectionType": enum (EmailCollectionType)
}
שדות
quizSettings

object (QuizSettings)

הגדרות שקשורות לבחינות ולציונים.

emailCollectionType

enum (EmailCollectionType)

אופציונלי. ההגדרה שקובעת אם הטופס יאסוף כתובות אימייל מהמשיבים.

QuizSettings

הגדרות שקשורות לבחינות ולציונים. צריך לעדכן אותם באמצעות UpdateSettingsRequest.

ייצוג ב-JSON
{
  "isQuiz": boolean
}
שדות
isQuiz

boolean

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

EmailCollectionType

אופציונלי. ההגדרה קובעת אם הטופס אוסף כתובות אימייל מהמשיבים ואיך כתובות האימייל נאספות. אם הטופס אוסף כתובות אימייל, הערכים מאוכלסים בשדה formResponse.respondentEmail.

טיפוסים בני מנייה (enum)
EMAIL_COLLECTION_TYPE_UNSPECIFIED לא צוין. הערך הזה לא בשימוש.
DO_NOT_COLLECT הטופס לא אוסף כתובות אימייל. ערך ברירת המחדל אם בעל הטופס משתמש בחשבון Google.
VERIFIED הטופס אוסף כתובות אימייל באופן אוטומטי על סמך החשבון של המשתמש שמחובר. ערך ברירת המחדל אם הבעלים של הטופס משתמש בחשבון Google Workspace.
RESPONDER_INPUT הטופס אוסף כתובות אימייל באמצעות שדה שהמשיב ממלא בטופס.

פריט

פריט אחד בטופס. השדה kind מגדיר את סוג הפריט.

ייצוג ב-JSON
{
  "itemId": string,
  "title": string,
  "description": string,

  // Union field kind can be only one of the following:
  "questionItem": {
    object (QuestionItem)
  },
  "questionGroupItem": {
    object (QuestionGroupItem)
  },
  "pageBreakItem": {
    object (PageBreakItem)
  },
  "textItem": {
    object (TextItem)
  },
  "imageItem": {
    object (ImageItem)
  },
  "videoItem": {
    object (VideoItem)
  }
  // End of list of possible types for union field kind.
}
שדות
itemId

string

מזהה הפריט.

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

title

string

שם הפריט.

description

string

התיאור של הפריט.

שדה האיחוד kind. חובה. סוג הפריט. הערך של kind יכול להיות רק אחד מהערכים הבאים:
questionItem

object (QuestionItem)

הצגת שאלה למשתמש.

questionGroupItem

object (QuestionGroupItem)

הצגת שאלה אחת או יותר למשתמש באמצעות הנחיה ראשית אחת.

pageBreakItem

object (PageBreakItem)

התחלת דף חדש עם כותרת.

textItem

object (TextItem)

הצגת כותרת ותיאור בדף.

imageItem

object (ImageItem)

הצגת תמונה בדף.

videoItem

object (VideoItem)

הצגת סרטון בדף.

QuestionItem

פריט בטופס שמכיל שאלה אחת.

ייצוג ב-JSON
{
  "question": {
    object (Question)
  },
  "image": {
    object (Image)
  }
}
שדות
question

object (Question)

חובה. השאלה המוצגת.

image

object (Image)

התמונה שמוצגת בשאלה.

שאלה

יש לך שאלות? סוג השאלה הספציפי נקרא לפי kind שלו.

ייצוג ב-JSON
{
  "questionId": string,
  "required": boolean,
  "grading": {
    object (Grading)
  },

  // Union field kind can be only one of the following:
  "choiceQuestion": {
    object (ChoiceQuestion)
  },
  "textQuestion": {
    object (TextQuestion)
  },
  "scaleQuestion": {
    object (ScaleQuestion)
  },
  "dateQuestion": {
    object (DateQuestion)
  },
  "timeQuestion": {
    object (TimeQuestion)
  },
  "fileUploadQuestion": {
    object (FileUploadQuestion)
  },
  "rowQuestion": {
    object (RowQuestion)
  },
  "ratingQuestion": {
    object (RatingQuestion)
  }
  // End of list of possible types for union field kind.
}
שדות
questionId

string

קריאה בלבד. מזהה השאלה.

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

required

boolean

האם יש צורך לענות על השאלה כדי שהנשאל יוכל לשלוח את התשובה שלו.

grading

object (Grading)

הגדרת מתן ציונים לשאלה.

שדה האיחוד kind. חובה. סוג השאלה שמוצגת למשתמש. הערך של kind יכול להיות רק אחת מהאפשרויות הבאות:
choiceQuestion

object (ChoiceQuestion)

המשיבים יכולים לבחור מתוך קבוצה מוגדרת מראש של אפשרויות.

textQuestion

object (TextQuestion)

המשיבים יכולים להזין תשובה בטקסט חופשי.

scaleQuestion

object (ScaleQuestion)

המשיבים יכולים לבחור מספר מתוך טווח.

dateQuestion

object (DateQuestion)

המשיבים יכולים להזין תאריך.

timeQuestion

object (TimeQuestion)

המשיבים יכולים להזין שעה.

fileUploadQuestion

object (FileUploadQuestion)

המשיבים יכולים להעלות קובץ אחד או יותר.

rowQuestion

object (RowQuestion)

שורה ב-QuestionGroupItem.

ratingQuestion

object (RatingQuestion)

המשיבים יכולים לבחור דירוג מתוך קבוצה מוגדרת מראש של סמלים.

ChoiceQuestion

שאלה עם לחצן בחירה/תיבת סימון/תפריט נפתח.

ייצוג ב-JSON
{
  "type": enum (ChoiceType),
  "options": [
    {
      object (Option)
    }
  ],
  "shuffle": boolean
}
שדות
type

enum (ChoiceType)

חובה. סוג שאלה הבחירה.

options[]

object (Option)

חובה. רשימת אפשרויות שהנשאלים צריכים לבחור מתוכה.

shuffle

boolean

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

ChoiceType

סוג הבחירה.

טיפוסים בני מנייה (enum)
CHOICE_TYPE_UNSPECIFIED ערך ברירת המחדל. לא בשימוש.
RADIO לחצני בחירה: כל האפשרויות מוצגות למשתמש, והוא יכול לבחור רק אחת מהן.
CHECKBOX תיבות סימון: כל האפשרויות מוצגות למשתמש, והוא יכול לבחור כמה מהן שירצה.
DROP_DOWN תפריט נפתח: האפשרויות מוצגות למשתמש רק על פי דרישה, אחרת מוצגת רק האפשרות הנוכחית. אפשר לבחור רק אפשרות אחת.

אפשרות

אפשרות לשאלה מסוג 'בחירה'.

ייצוג ב-JSON
{
  "value": string,
  "image": {
    object (Image)
  },
  "isOther": boolean,

  // Union field go_to_section can be only one of the following:
  "goToAction": enum (GoToAction),
  "goToSectionId": string
  // End of list of possible types for union field go_to_section.
}
שדות
value

string

חובה. הבחירה כפי שהוצגה למשתמש.

image

object (Image)

הצגת התמונה כאפשרות.

isOther

boolean

אם האפשרות היא 'אחר'. בשלב הזה, האפשרות הזו רלוונטית רק לסוגי הבחירה RADIO ו-CHECKBOX, אבל אסור להשתמש בה ב-QuestionGroupItem.

שדה האיחוד go_to_section. הקטע שאליו עוברים אם בוחרים באפשרות הזו. בשלב זה, האפשרות הזו רלוונטית רק לסוג הבחירה RADIO ו-SELECT, אבל היא לא מותרת ב-QuestionGroupItem. הערך של go_to_section יכול להיות רק אחת מהאפשרויות הבאות:
goToAction

enum (GoToAction)

סוג הניווט בקטע.

goToSectionId

string

מזהה הפריט של הכותרת העליונה של הקטע שאליו רוצים לעבור.

GoToAction

קבועים לניווט בין קטעים.

טיפוסים בני מנייה (enum)
GO_TO_ACTION_UNSPECIFIED ערך ברירת המחדל. לא בשימוש.
NEXT_SECTION עוברים לקטע הבא.
RESTART_FORM חוזרים לתחילת הטופס.
SUBMIT_FORM יש לשלוח את הטופס באופן מיידי.

תמונה

נתונים שמייצגים תמונה.

ייצוג ב-JSON
{
  "contentUri": string,
  "altText": string,
  "properties": {
    object (MediaProperties)
  },

  // Union field image_source can be only one of the following:
  "sourceUri": string
  // End of list of possible types for union field image_source.
}
שדות
contentUri

string

פלט בלבד. URI שממנו אפשר להוריד את התמונה. הוא תקף לזמן מוגבל בלבד.

altText

string

תיאור של התמונה שמוצגת כשמעבירים מעליה את העכבר, וקוראים אותה קוראי מסך.

properties

object (MediaProperties)

המאפיינים של תמונה.

שדה האיחוד image_source. סוג מקור התמונה. צריך להגדיר שדה אחד בלבד של מקור תמונה כשיוצרים תמונות חדשות. הערך של image_source יכול להיות רק אחת מהאפשרויות הבאות:
sourceUri

string

קלט בלבד. ה-URI של המקור הוא ה-URI שמשמש להוספת התמונה. ה-URI של המקור יכול להיות ריק בזמן האחזור.

MediaProperties

המאפיינים של המדיה.

ייצוג ב-JSON
{
  "alignment": enum (Alignment),
  "width": integer
}
שדות
alignment

enum (Alignment)

המיקום של המדיה.

width

integer

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

יישור

יישור קו בדף.

טיפוסים בני מנייה (enum)
ALIGNMENT_UNSPECIFIED ערך ברירת המחדל. לא בשימוש.
LEFT יישור לשמאל.
RIGHT יישור לימין.
CENTER מרכז.

TextQuestion

שאלה שמבוססת על טקסט.

ייצוג ב-JSON
{
  "paragraph": boolean
}
שדות
paragraph

boolean

האם השאלה היא שאלה של פסקה או לא. אם לא, זו שאלה עם טקסט קצר.

ScaleQuestion

שאלה עם סולם דירוג. המשתמש יכול לבחור מתוך טווח של ערכים מספריים.

ייצוג ב-JSON
{
  "low": integer,
  "high": integer,
  "lowLabel": string,
  "highLabel": string
}
שדות
low

integer

חובה. הערך הנמוך ביותר האפשרי בסולם.

high

integer

חובה. הערך הגבוה ביותר האפשרי בסולם.

lowLabel

string

התווית שמוצגת ומתאר את הנקודה הנמוכה ביותר בסולם.

highLabel

string

התווית שמוצגת ומתאר את הנקודה הגבוהה ביותר בסולם.

DateQuestion

שאלה לגבי תאריך. כברירת מחדל, שאלות לגבי תאריכים כוללות רק את החודש והיום.

ייצוג ב-JSON
{
  "includeTime": boolean,
  "includeYear": boolean
}
שדות
includeTime

boolean

אם לכלול את השעה כחלק מהשאלה.

includeYear

boolean

האם לכלול את השנה כחלק מהשאלה.

TimeQuestion

שאלה לגבי זמן.

ייצוג ב-JSON
{
  "duration": boolean
}
שדות
duration

boolean

true אם השאלה היא על זמן שחלף. אחרת, מדובר בשעה מסוימת ביום.

FileUploadQuestion

שאלה עם העלאת קובץ. בשלב הזה, ה-API לא תומך ביצירת שאלות לגבי העלאת קבצים.

ייצוג ב-JSON
{
  "folderId": string,
  "types": [
    enum (FileType)
  ],
  "maxFiles": integer,
  "maxFileSize": string
}
שדות
folderId

string

חובה. המזהה של התיקייה ב-Drive שבה מאוחסנים הקבצים שמעלים.

types[]

enum (FileType)

סוגי הקבצים שמותר לצרף לשאלה הזו.

maxFiles

integer

המספר המקסימלי של קבצים שאפשר להעלות לשאלה הזו בתשובה אחת.

maxFileSize

string (int64 format)

מספר הבייטים המקסימלי שמותר לכל קובץ בודד שמעלים לשאלה הזו.

FileType

סוגי הקבצים שאפשר להעלות לשאלה עם העלאת קבצים.

טיפוסים בני מנייה (enum)
FILE_TYPE_UNSPECIFIED ערך ברירת המחדל. לא בשימוש.
ANY אין הגבלות על סוגים.
DOCUMENT מסמך ב-Google Docs.
PRESENTATION מצגת ב-Google Slides.
SPREADSHEET גיליון אלקטרוני ב-Google Sheets.
DRAWING שרטוט.
PDF קובץ PDF.
IMAGE תמונה.
VIDEO סרטון.
AUDIO קובץ אודיו.

RowQuestion

הגדרה של שאלה ששייכת לקבוצת שאלות.

ייצוג ב-JSON
{
  "title": string
}
שדות
title

string

חובה. הכותרת של השורה היחידה ב-QuestionGroupItem.

RatingQuestion

שאלה לגבי דירוג. המשתמש יכול לבחור מתוך מגוון סמלים.

ייצוג ב-JSON
{
  "ratingScaleLevel": integer,
  "iconType": enum (RatingIconType)
}
שדות
ratingScaleLevel

integer

חובה. רמת סולם הדירוג של שאלה לדירוג.

iconType

enum (RatingIconType)

חובה. סוג הסמל שרוצים להשתמש בו לדירוג.

RatingIconType

סוג הסמל שרוצים להשתמש בו לדירוג.

טיפוסים בני מנייה (enum)
RATING_ICON_TYPE_UNSPECIFIED ערך ברירת המחדל. לא בשימוש.
STAR סמל כוכב.
HEART סמל של לב.
THUMB_UP סמל של אגודל כלפי מטה.

מתן ציון

מתן ציונים לשאלה אחת

ייצוג ב-JSON
{
  "pointValue": integer,
  "correctAnswers": {
    object (CorrectAnswers)
  },
  "whenRight": {
    object (Feedback)
  },
  "whenWrong": {
    object (Feedback)
  },
  "generalFeedback": {
    object (Feedback)
  }
}
שדות
pointValue

integer

חובה. המספר המקסימלי של נקודות שמשתמש יכול לקבל באופן אוטומטי על תשובה נכונה. הערך לא יכול להיות שלילי.

correctAnswers

object (CorrectAnswers)

חובה. מפתח התשובות לשאלה. התשובות ייבדקו באופן אוטומטי על סמך השדה הזה.

whenRight

object (Feedback)

המשוב שמוצג על תשובות נכונות. אפשר להגדיר משוב כזה רק לשאלות אמריקאיות עם תשובות נכונות.

whenWrong

object (Feedback)

המשוב שמוצג על תשובות שגויות. אפשר להגדיר משוב כזה רק לשאלות אמריקאיות עם תשובות נכונות.

generalFeedback

object (Feedback)

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

CorrectAnswers

מפתח התשובות לשאלה.

ייצוג ב-JSON
{
  "answers": [
    {
      object (CorrectAnswer)
    }
  ]
}
שדות
answers[]

object (CorrectAnswer)

רשימה של תשובות נכונות. אפשר לתת ציון אוטומטי לתשובה לבוחן על סמך התשובות האלה. בשאלות עם ערך יחיד, תשובה מסוימת מסומנת כנכונה אם היא תואמת לאחד מהערכים ברשימה הזו (כלומר, יכולות להיות כמה תשובות נכונות). בשאלות עם מספר ערכים (CHECKBOX), תגובה מסומנת כנכונה אם היא מכילה בדיוק את הערכים שמופיעים ברשימה הזו.

CorrectAnswer

תשובה נכונה אחת לשאלה. בשאלות עם ערכים מרובים (CHECKBOX), יכול להיות שיהיה צורך בכמה CorrectAnswer כדי לייצג אפשרות תשובה נכונה אחת.

ייצוג ב-JSON
{
  "value": string
}
שדות
value

string

חובה. הערך של התשובה הנכונה. בתיעוד של TextAnswer.value מוסבר איך מתבצע הפורמט של סוגי ערכים שונים.

QuestionGroupItem

הגדרה של שאלה שמכילה כמה שאלות מקובצות יחד.

ייצוג ב-JSON
{
  "questions": [
    {
      object (Question)
    }
  ],
  "image": {
    object (Image)
  },

  // Union field kind can be only one of the following:
  "grid": {
    object (Grid)
  }
  // End of list of possible types for union field kind.
}
שדות
questions[]

object (Question)

חובה. רשימה של השאלות ששייכות לקבוצת השאלות הזו. כל שאלה יכולה להשתייך רק לקבוצה אחת. kind של הקבוצה עשוי להשפיע על סוגי השאלות שמותר לשאול.

image

object (Image)

התמונה שמוצגת בקבוצת השאלות מעל השאלות הספציפיות.

שדה האיחוד kind. חובה. סוג קבוצת השאלות, שקובע את סוגי השאלות שמותר להציג ואת אופן הצגתן. הערך של kind יכול להיות רק אחת מהאפשרויות הבאות:
grid

object (Grid)

קבוצת השאלות היא רשת עם שורות של שאלות אמריקאיות שיש להן אותן אפשרויות. כשהערך של grid מוגדר, כל השאלות בקבוצה צריכות להיות מסוג row.

תצוגת רשת

רשת של אפשרויות (תיבות סימון או לחצני בחירה) שבכל שורה יש שאלה נפרדת. בכל שורה מופיעות אותן אפשרויות, שמוצגות כעמודות.

ייצוג ב-JSON
{
  "columns": {
    object (ChoiceQuestion)
  },
  "shuffleQuestions": boolean
}
שדות
columns

object (ChoiceQuestion)

חובה. האפשרויות המשותפות לכל שאלה ברשת. במילים אחרות, הערכים של העמודות. אפשר לבחור רק באפשרויות CHECK_BOX ו-RADIO.

shuffleQuestions

boolean

אם true, השאלות מסודרות באופן אקראי. במילים אחרות, השורות מופיעות בסדר שונה לכל אחד מהמשיבים.

PageBreakItem

אין שדות לסוג הזה.

מעבר דף. השם והתיאור של הפריט יוצגו בחלק העליון של הדף החדש.

TextItem

אין שדות לסוג הזה.

פריט טקסט.

ImageItem

פריט שמכיל תמונה.

ייצוג ב-JSON
{
  "image": {
    object (Image)
  }
}
שדות
image

object (Image)

חובה. התמונה שמוצגת בפריט.

VideoItem

פריט שמכיל סרטון.

ייצוג ב-JSON
{
  "video": {
    object (Video)
  },
  "caption": string
}
שדות
video

object (Video)

חובה. הסרטון שמוצג בפריט.

caption

string

הטקסט שמוצג מתחת לסרטון.

וידאו

נתונים שמייצגים סרטון.

ייצוג ב-JSON
{
  "youtubeUri": string,
  "properties": {
    object (MediaProperties)
  }
}
שדות
youtubeUri

string

חובה. מזהה URI של YouTube.

properties

object (MediaProperties)

המאפיינים של סרטון.

PublishSettings

הגדרות הפרסום של טופס.

ייצוג ב-JSON
{
  "publishState": {
    object (PublishState)
  }
}
שדות
publishState

object (PublishState)

אופציונלי. מצב הפרסום של טופס.

כשמעדכנים את publishState, צריך להגדיר גם את isPublished וגם את isAcceptingResponses. עם זאת, לא ניתן להגדיר את isAcceptingResponses כ-true ואת isPublished כ-false, והפעולה הזו תגרום להצגת שגיאה.

PublishState

מצב הפרסום של טופס.

ייצוג ב-JSON
{
  "isPublished": boolean,
  "isAcceptingResponses": boolean
}
שדות
isPublished

boolean

חובה. האם הטופס פורסם וגלוש לאחרים.

isAcceptingResponses

boolean

חובה. אם הטופס מקבל תשובות. אם השדה isPublished מוגדר ל-false, השדה הזה מוגדר באופן אוטומטי ל-false.

Methods

batchUpdate

שינוי הטופס באמצעות קבוצה של עדכונים.

create

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

get

פותחים טופס.

setPublishSettings

עדכון הגדרות הפרסום של טופס.