É um item de pergunta, apresentado como uma grade de colunas e linhas, permitindo que o participante selecione
uma opção por linha em uma sequência de botões de opção. Os itens podem ser acessados ou criados a partir de um
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 deste item da grade. |
createResponse(responses) | ItemResponse | Cria um novo ItemResponse para esse item da grade. |
duplicate() | GridItem | Cria uma cópia desse item e a anexa ao final do formulário. |
getColumns() | String[] | Acessa os valores para 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 | Acessa o índice do item entre todos os itens no formulário. |
getRows() | String[] | Acessa os valores para cada linha na grade. |
getTitle() | String | Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de um SectionHeaderItem ). |
getType() | ItemType | Recebe o tipo do item, representado como 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 de 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()
createResponse(responses)
Cria um novo ItemResponse
para esse item da 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. Emite 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 desse item e a anexa ao final do formulário.
Retornar
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()
Acessa os valores para cada coluna na grade.
Retornar
String[]
: uma matriz de valores de coluna, que os participantes veem como marcadores 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 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()
Acessa 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()
Acessa os valores para cada linha na grade.
Retornar
String[]
: uma matriz de valores de linha, que os participantes veem como marcadores 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 de cabeçalho, no caso de um SectionHeaderItem
).
Retornar
String
: o 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()
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. Lança uma exceção se a matriz especificada estiver vazia.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
columns | String[] | uma matriz de valores de coluna que os participantes veem como marcadores ao visualizar o formulário |
Retornar
GridItem
: este item para encadeamento
Gera
Error
: se a matriz especificada 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 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. Lança uma exceção se a matriz especificada estiver vazia.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
rows | String[] | uma matriz de valores de linha que os participantes veem como marcadores ao visualizar o formulário |
Retornar
GridItem
: este item para encadeamento
Gera
Error
: se a matriz especificada 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 de 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 nulo ou uma validação sem nenhuma função de chamada chamada removerá qualquer validação anterior.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
validation | GridValidation | uma GridValidation para aplicar ao 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