Class GridItem

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 do item de grade.
createResponse(responses)	ItemResponse	Cria um novo ItemResponse para este item de grade.
duplicate()	GridItem	Cria uma cópia deste item e a anexa ao final do formulário.
getColumns()	String[]	Recebe os valores de todas as colunas 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	Recebe o índice do item entre todos os itens do formulário.
getRows()	String[]	Recebe os valores de cada linha na 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 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 participante 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 do 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 na 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 opção 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 deste item e a anexa ao final do formulário.

Retornar

GridItem: uma duplicata de 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 todas as colunas na grade.

Retornar

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

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 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 participantes veem como rótulos ao acessar 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).

Retornar

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

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: indica se o entrevistado 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 fornecida estiver vazia.

Parâmetros

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

Retornar

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

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

Parâmetros

Nome	Tipo	Descrição
enabled	Boolean	se o entrevistado 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 fornecida estiver vazia.

Parâmetros

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

Retornar

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

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. Transmitir null ou uma instância GridValidation em que nenhuma função de exigência foi chamada remove qualquer validação anterior.

Parâmetros

Nome	Tipo	Descrição
validation	GridValidation	um GridValidation a ser aplicado 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