Esta página foi traduzida pela API Cloud Translation.

Class GridItem

Um item de pergunta, apresentado como uma grade de colunas e linhas, que permite ao entrevistado selecionar uma opção por linha entre uma sequência de botões de opção. Os itens podem ser acessados ou criados com uma Form.

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Métodos

Método	Tipo de retorno	Breve descrição
`clearValidation()`	`GridItem`	Remove qualquer validação de dados para este item de grade.
`createResponse(responses)`	`ItemResponse`	Cria um novo `ItemResponse` para este item da grade.
`duplicate()`	`GridItem`	Cria uma cópia desse item e a anexa ao final do formulário.
`getColumns()`	`String[]`	Recebe os valores de cada coluna da grade.
`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`	Recebe o identificador exclusivo do item.
`getIndex()`	`Integer`	Recebe o índice do item entre todos os itens do formulário.
`getRows()`	`String[]`	Recebe os valores de cada linha da grade.
`getTitle()`	`String`	Recebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um `SectionHeaderItem`).
`getType()`	`ItemType`	Recebe o tipo do item, representado como um `ItemType`.
`isRequired()`	`Boolean`	Determina se o entrevistado deve responder à pergunta.
`setColumns(columns)`	`GridItem`	Define as colunas da grade com base em uma matriz de valores.
`setHelpText(text)`	`GridItem`	Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como `ImageItems`, `PageBreakItems` e `SectionHeaderItems`).
`setRequired(enabled)`	`GridItem`	Define se o respondente precisa responder à pergunta.
`setRows(rows)`	`GridItem`	Define as linhas da grade com base em uma matriz de valores.
`setTitle(title)`	`GridItem`	Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um `SectionHeaderItem`).
`setValidation(validation)`	`GridItem`	Define a validação de dados para este item da grade.

Documentação detalhada

`clearValidation()`

Remove qualquer validação de dados para este item de grade.

Retorno

GridItem: este item para encadeamento.

Autorização

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

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

`createResponse(responses)`

Cria um novo ItemResponse para este item da grade. O argumento responses precisa ser uma matriz String[] contendo tantos valores quanto o número de linhas na grade. Um elemento null para uma pergunta de grade não obrigatória indica que não há resposta para essa linha. Lança uma exceção se algum dos valores não corresponder a uma escolha válida.

Parâmetros

Nome	Tipo	Descrição
`responses`	`String[]`	uma matriz de respostas válidas para este item da grade

Retorno

ItemResponse: a resposta do item

Autorização

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

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

`duplicate()`

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

Retorno

GridItem: uma cópia deste GridItem, para encadeamento.

Autorização

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

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

`getColumns()`

Recebe os valores de cada coluna da grade.

Retorno

String[]: uma matriz de valores de coluna, que os entrevistados veem como rótulos ao visualizar o formulário.

Autorização

Os scripts que usam esse método exigem 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).

Retorno

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

Autorização

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

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

`getId()`

Recebe o identificador exclusivo do item.

Retorno

Integer: ID do item

Autorização

Os scripts que usam esse método exigem 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.

Retorno

Integer: o índice do item

Autorização

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

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

`getRows()`

Recebe os valores de cada linha da grade.

Retorno

String[]: uma matriz de valores de linha, que os entrevistados veem como rótulos ao visualizar o formulário.

Autorização

Os scripts que usam esse método exigem 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 do cabeçalho, no caso de um SectionHeaderItem).

Retorno

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

Autorização

Os scripts que usam esse método exigem 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 um ItemType.

Retorno

ItemType: o tipo do item

Autorização

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

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

`isRequired()`

Determina se o entrevistado deve responder à pergunta.

Retorno

Boolean: se o participante precisa responder à pergunta.

Autorização

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

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

`setColumns(columns)`

Define as colunas da grade com base em uma matriz de valores. Lança uma exceção se a matriz fornecida estiver vazia.

Parâmetros

Nome	Tipo	Descrição
`columns`	`String[]`	Uma matriz de valores de coluna, que os entrevistados veem como rótulos ao visualizar o formulário

Retorno

GridItem: este item para encadeamento.

Gera

Error: se a matriz fornecida for null ou estiver vazia.

Autorização

Os scripts que usam esse método exigem 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

Retorno

GridItem: este GridItem, para encadeamento.

Autorização

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

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

`setRequired(enabled)`

Define se o respondente precisa responder à pergunta.

Parâmetros

Nome	Tipo	Descrição
`enabled`	`Boolean`	se o respondente deve responder à pergunta

Retorno

GridItem: o item atual (para encadeamento).

Autorização

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

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

`setRows(rows)`

Define as linhas da grade com base em uma matriz de valores. Lança uma exceção se a matriz fornecida estiver vazia.

Parâmetros

Nome	Tipo	Descrição
`rows`	`String[]`	Uma matriz de valores de linha, que os entrevistados veem como rótulos ao visualizar o formulário

Retorno

GridItem: este item para encadeamento.

Gera

Error: se a matriz fornecida for null ou estiver vazia.

Autorização

Os scripts que usam esse método exigem 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 do cabeçalho, no caso de um SectionHeaderItem).

Parâmetros

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

Retorno

GridItem: este GridItem, para encadeamento.

Autorização

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

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

`setValidation(validation)`

Define a validação de dados para este item da grade. Transmitir "null" ou uma validação sem nenhuma função de exigência chamada vai remover qualquer validação anterior.

Parâmetros

Nome	Tipo	Descrição
`validation`	`GridValidation`	um GridValidation para aplicar a este item.

Retorno

GridItem: este GridItem, para encadeamento.

Autorização

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

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