Esta página foi traduzida pela API Cloud Translation.

Interface Item

Um item de formulário genérico que contém propriedades comuns a todos os itens, como título e texto de ajuda. Os itens podem ser acessados ou criados em um Form.

Para operar em propriedades específicas do tipo, use getType() para verificar o ItemType do item e, em seguida, transmita o item para o a classe apropriada usando um método como asCheckboxItem().

// Create a new form and add a text item.
var form = FormApp.create('Form Name');
form.addTextItem();

// Access the text item as a generic item.
var items = form.getItems();
var item = items[0];

// Cast the generic item to the text-item class.
if (item.getType() == 'TEXT') {
  var textItem = item.asTextItem();
  textItem.setRequired(false);
}

Implementação de classes

Nome	Breve descrição

Métodos

Método	Tipo de retorno	Breve descrição
`asCheckboxGridItem()`	`CheckboxGridItem`	Retorna o item como um item de grade da caixa de seleção.
`asCheckboxItem()`	`CheckboxItem`	Retorna o item como um item da caixa de seleção.
`asDateItem()`	`DateItem`	Retorna o item como um item de data.
`asDateTimeItem()`	`DateTimeItem`	Retorna o item como um item de data-hora.
`asDurationItem()`	`DurationItem`	Retorna o item como um item de duração.
`asGridItem()`	`GridItem`	Retorna o item como um item de grade.
`asImageItem()`	`ImageItem`	Retorna o item como um item de imagem.
`asListItem()`	`ListItem`	Retorna o item como um item da lista.
`asMultipleChoiceItem()`	`MultipleChoiceItem`	Retorna o item como um item de múltipla escolha.
`asPageBreakItem()`	`PageBreakItem`	Retorna o item como um item de quebra de página.
`asParagraphTextItem()`	`ParagraphTextItem`	Retorna o item como texto de parágrafo.
`asScaleItem()`	`ScaleItem`	Retorna o item como um item de escala.
`asSectionHeaderItem()`	`SectionHeaderItem`	Retorna o item como um cabeçalho de seção.
`asTextItem()`	`TextItem`	Retorna o item como um item de texto.
`asTimeItem()`	`TimeItem`	Retorna o item como um item de tempo.
`asVideoItem()`	`VideoItem`	Retorna o item como um item de vídeo.
`duplicate()`	`Item`	Cria uma cópia desse item e a anexa ao final do formulário.
`getHelpText()`	`String`	Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`getId()`	`Integer`	Extrai o identificador exclusivo do item.
`getIndex()`	`Integer`	Recebe o índice do item entre todos os itens do formulário.
`getTitle()`	`String`	Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de uma `SectionHeaderItem`).
`getType()`	`ItemType`	Recebe o tipo do item, representado como `ItemType`.
`setHelpText(text)`	`Item`	Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`setTitle(title)`	`Item`	Define o título do item, às vezes chamado de texto de cabeçalho, no caso de uma `SectionHeaderItem`.

Documentação detalhada

`asCheckboxGridItem()`

Retorna o item como um item de grade da caixa de seleção. Gera uma exceção de script se o ItemType ainda não era CHECKBOX_GRID.

Retornar

CheckboxGridItem: o item de grade da caixa de seleção.

Gera

Error: se o item não for um item de grade da caixa de seleção.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asCheckboxItem()`

Retorna o item como um item da caixa de seleção. Gera uma exceção de script se o ItemType ainda não era CHECKBOX.

Retornar

CheckboxItem: o item da caixa de seleção.

Gera

Error: se o item não for um item da caixa de seleção.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asDateItem()`

Retorna o item como um item de data. Gera uma exceção de script se o ItemType ainda não era DATE.

Retornar

DateItem: o item de data.

Gera

Error: se o item não for um item de data.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asDateTimeItem()`

Retorna o item como um item de data-hora. Gera uma exceção de script se o ItemType ainda não era DATETIME.

Retornar

DateTimeItem: o item de data-hora.

Gera

Error: se o item não for de data e hora.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asDurationItem()`

Retorna o item como um item de duração. Gera uma exceção de script se o ItemType ainda não era DURATION.

Retornar

DurationItem: o item de duração.

Gera

Error: se o item não for um item de duração.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asGridItem()`

Retorna o item como um item de grade. Gera uma exceção de script se o ItemType ainda não era GRID.

Retornar

GridItem: o item da grade.

Gera

Error: se o item não for de grade.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asImageItem()`

Retorna o item como um item de imagem. Gera uma exceção de script se o ItemType ainda não era IMAGE.

Retornar

ImageItem: o item de imagem.

Gera

Error: se o item não for um item de imagem.

`asListItem()`

Retorna o item como um item da lista. Gera uma exceção de script se o ItemType ainda não era LIST.

Retornar

ListItem: o item da lista.

Gera

Error: se o item não for um item da lista.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asMultipleChoiceItem()`

Retorna o item como um item de múltipla escolha. Gera uma exceção de script se o ItemType ainda não era MULTIPLE_CHOICE.

Retornar

MultipleChoiceItem: o item de múltipla escolha.

Gera

Error: se o item não for de múltipla escolha.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asPageBreakItem()`

Retorna o item como um item de quebra de página. Gera uma exceção de script se o ItemType ainda não era PAGE_BREAK.

Retornar

PageBreakItem: o item de quebra de página.

Gera

Error: se o item não for um item de quebra de página.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asParagraphTextItem()`

Retorna o item como texto de parágrafo. Gera uma exceção de script se o ItemType ainda não era PARAGRAPH_TEXT.

Retornar

ParagraphTextItem: o item de texto de parágrafo

Gera

Error: se o item não for um item de texto de parágrafo.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asScaleItem()`

Retorna o item como um item de escala. Gera uma exceção de script se o ItemType ainda não era SCALE.

Retornar

ScaleItem: o item da balança

Gera

Error: se o item não for um item de escala.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asSectionHeaderItem()`

Retorna o item como um cabeçalho de seção. Gera uma exceção de script se o ItemType ainda não era SECTION_HEADER.

Retornar

SectionHeaderItem: o item do cabeçalho da seção

Gera

Error: se o item não for um item de cabeçalho de seção.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asTextItem()`

Retorna o item como um item de texto. Gera uma exceção de script se o ItemType ainda não era TEXT.

Retornar

TextItem: o item de texto.

Gera

Error: se o item não for um item de texto.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asTimeItem()`

Retorna o item como um item de tempo. Gera uma exceção de script se o ItemType ainda não era TIME.

Retornar

TimeItem: o item de tempo.

Gera

Error: se o item não for um item de tempo.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`asVideoItem()`

Retorna o item como um item de vídeo. Gera uma exceção de script se o ItemType ainda não era VIDEO.

Retornar

VideoItem: o item de vídeo.

Gera

Error: se o item não for um item de vídeo.

`duplicate()`

Cria uma cópia desse item e a anexa ao final do formulário.

Retornar

Item: uma cópia deste Item para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`getHelpText()`

Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems, PageBreakItems e SectionHeaderItems).

Retornar

String: o texto de ajuda ou de descrição do item.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`getId()`

Extrai o identificador exclusivo do item.

Retornar

Integer: o código do item.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`getIndex()`

Recebe o índice do item entre todos os itens do formulário.

Retornar

Integer: o índice do item.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`getTitle()`

Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de uma SectionHeaderItem).

Retornar

String: o título ou texto do cabeçalho do item

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`getType()`

Recebe o tipo do item, representado como ItemType.

Retornar

ItemType: o tipo do item.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`setHelpText(text)`

Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems, PageBreakItems e SectionHeaderItems).

Parâmetros

Nome	Tipo	Descrição
`text`	`String`	o novo texto de ajuda

Retornar

Item: este Item, para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

`setTitle(title)`

Define o título do item, às vezes chamado de texto de cabeçalho, no caso de uma SectionHeaderItem.

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	o novo título ou texto do cabeçalho

Retornar

Item: este Item, para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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