Method: forms.setPublishSettings

更新表單的發布設定。

舊版表單不支援此功能，因為這些表單沒有 publishSettings 欄位。

HTTP 要求

POST https://forms.googleapis.com/v1/forms/{formId}:setPublishSettings

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
formId

string

必要欄位。表單 ID。您可以從 Form.form_id 欄位取得 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "publishSettings": {
    object (PublishSettings)
  },
  "updateMask": string
}
欄位
publishSettings

object (PublishSettings)

必要欄位。要套用至表單的發布設定。
updateMask

string (FieldMask format)

選用設定。要更新的 publishSettings 欄位。這個欄位遮罩可接受下列值：

  • publishState：更新或取代所有 publishState 設定。
  • "*"：更新或取代所有 publishSettings 欄位。

這是以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。

回應主體

forms.setPublishSettings 要求的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "formId": string,
  "publishSettings": {
    object (PublishSettings)
  }
}
欄位
formId

string

必要欄位。表單的 ID。這與 Form.form_id 欄位相同。
publishSettings

object (PublishSettings)

表單的發布設定。

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱授權指南。