Class VideoItem

VideoItem

顯示影片的版面配置項目。您可以透過 Form 存取或建立項目。

// Open a form by ID and add three new video items, using a long URL,
// a short URL, and a video ID.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
form.addVideoItem()
    .setTitle('Video Title')
    .setHelpText('Video Caption')
    .setVideoUrl('www.youtube.com/watch?v=1234abcdxyz');

form.addVideoItem()
    .setTitle('Video Title')
    .setHelpText('Video Caption')
    .setVideoUrl('youtu.be/1234abcdxyz');

form.addVideoItem()
    .setTitle('Video Title')
    .setHelpText('Video Caption')
    .setVideoUrl('1234abcdxyz');

方法

方法傳回類型簡短說明
duplicate()VideoItem建立這個項目的副本,並附加到表單末尾。
getAlignment()Alignment取得影片的水平對齊方式。
getHelpText()String取得項目的說明文字 (有時稱為 ImageItemsPageBreakItemsSectionHeaderItems 等版面配置項目的說明文字)。
getId()Integer取得項目的專屬 ID。
getIndex()Integer取得表單中所有項目的索引。
getTitle()String取得項目的標題 (在 SectionHeaderItem 中則稱為標題文字)。
getType()ItemType取得項目的類型,以 ItemType 表示。
getWidth()Integer取得影片的寬度 (以像素為單位)。
setAlignment(alignment)VideoItem設定影片的水平對齊方式。
setHelpText(text)VideoItem設定項目的說明文字 (有時稱為 ImageItemsPageBreakItemsSectionHeaderItems 等版面配置項目的說明文字)。
setTitle(title)VideoItem設定項目的標題 (在 SectionHeaderItem 中也稱為標題文字)。
setVideoUrl(youtubeUrl)VideoItem以指定的 YouTube 網址或 YouTube 影片 ID 來設定影片本身。
setWidth(width)VideoItem設定影片的寬度 (以像素為單位)。

內容詳盡的說明文件

duplicate()

建立這個項目的副本,並附加到表單末尾。

回攻員

VideoItem — 此 VideoItem 的重複項目,用於鏈結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getAlignment()

取得影片的水平對齊方式。

回攻員

Alignment:水平對齊

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getHelpText()

取得項目的說明文字 (有時稱為 ImageItemsPageBreakItemsSectionHeaderItems 等版面配置項目的說明文字)。

回攻員

String:商品的說明文字或說明文字

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getId()

取得項目的專屬 ID。

回攻員

Integer:項目的 ID

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getIndex()

取得表單中所有項目的索引。

回攻員

Integer:項目的索引

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

取得項目的標題 (在 SectionHeaderItem 中則稱為標題文字)。

回攻員

String:項目的標題或標題文字

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getType()

取得項目的類型,以 ItemType 表示。

回攻員

ItemType:項目的類型

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getWidth()

取得影片的寬度 (以像素為單位)。

回攻員

Integer:寬度 (以像素為單位)

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setAlignment(alignment)

設定影片的水平對齊方式。

參數

名稱類型說明
alignmentAlignment水平對齊

回攻員

VideoItem — 此 VideoItem,用於鏈結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

設定項目的說明文字 (有時稱為 ImageItemsPageBreakItemsSectionHeaderItems 等版面配置項目的說明文字)。

參數

名稱類型說明
textString新的說明文字

回攻員

VideoItem — 此 VideoItem,用於鏈結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

設定項目的標題 (在 SectionHeaderItem 中也稱為標題文字)。

參數

名稱類型說明
titleString新的標題或標題文字

回攻員

VideoItem — 此 VideoItem,用於鏈結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setVideoUrl(youtubeUrl)

以指定的 YouTube 網址或 YouTube 影片 ID 來設定影片本身。

參數

名稱類型說明
youtubeUrlStringYouTube 網址或 ID

回攻員

VideoItem — 此 VideoItem,用於鏈結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setWidth(width)

設定影片的寬度 (以像素為單位)。只能設定影片的寬度。系統會自動設定高度,以維持影片的比例。

參數

名稱類型說明
widthInteger寬度 (以像素為單位)

回攻員

VideoItem — 此 VideoItem,用於鏈結

授權

使用這個方法的指令碼必須取得以下一或多個範圍的授權:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms