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 participante selecionar uma opção por linha em uma sequência de botões de opção. Os itens podem ser acessados ou criados em um Form.

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 de grade.
`duplicate()`	`GridItem`	Cria uma cópia do item e a anexa ao final do formulário.
`getColumns()`	`String[]`	Extrai os valores de cada coluna na 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`	Consegue o índice do item entre todos os itens no formulário.
`getRows()`	`String[]`	Recebe os valores de cada linha na grade.
`getTitle()`	`String`	Extrai 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 participante precisa 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.

Retornar

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 de grade. O argumento responses precisa ser uma matriz String[] que contenha 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. Gera 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

Retornar

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 do item e a anexa ao final do formulário.

Retornar

GridItem: uma cópia desta 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()`

Extrai os valores de cada coluna na grade.

Retornar

String[]: uma matriz de valores de coluna, que os respondentes 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).

Retornar

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.

Retornar

Integer: o 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()`

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

Retornar

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 na grade.

Retornar

String[]: uma matriz de valores de linha, que os respondentes 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()`

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

Retornar

String: o título ou o 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.

Retornar

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 participante precisa responder à pergunta.

Retornar

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. Gera uma exceção se a matriz for dada vazia.

Parâmetros

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

Retornar

GridItem: este item, para encadeamento

Gera

Error: se a matriz especificada for null ou 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

Retornar

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 participante precisa responder à pergunta

Retornar

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. Gera uma exceção se a matriz escolhida estiver vazia.

Parâmetros

Nome	Tipo	Descrição
`rows`	`String[]`	uma matriz de valores de linha, que os respondentes veem como marcadores ao visualizar o formulário

Retornar

GridItem: este item, para encadeamento

Gera

Error: se a matriz especificada for null ou 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

Retornar

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. A transmissão de um valor nulo ou de uma validação sem nenhuma função de requisito chamada remove qualquer validação anterior.

Parâmetros

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

Retornar

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