Esta página foi traduzida pela API Cloud Translation.

Class TextOutput

Um objeto TextOutput que pode ser exibido a partir de um script.

Devido a considerações de segurança, os scripts não podem retornar conteúdo de texto diretamente para um navegador. Em vez disso, o navegador é redirecionado para googleusercontent.com, que o exibirá sem nenhuma ou manipulação ou sanitização adicional.

É possível retornar um conteúdo de texto como este:

function doGet() {
  return ContentService.createTextOutput("hello world!");
}

Há também métodos para disponibilizar JSON, RSS e XML como TextOutputs; os métodos correspondentes em ContentService.

Métodos

Método	Tipo de retorno	Breve descrição
`append(addedContent)`	`TextOutput`	Anexa conteúdo novo ao conteúdo que será veiculado.
`clear()`	`TextOutput`	Limpa o conteúdo atual.
`downloadAsFile(filename)`	`TextOutput`	Instrui os navegadores a fazer download em vez de exibir esse conteúdo.
`getContent()`	`String`	Recebe o conteúdo que será veiculado.
`getFileName()`	`String`	Retorna o nome do arquivo no qual será feito download desse arquivo ou retorna nulo se ele deve ser exibido em vez baixado.
`getMimeType()`	`MimeType`	Define o tipo MIME com que o conteúdo será veiculado.
`setContent(content)`	`TextOutput`	Define o conteúdo que será veiculado.
`setMimeType(mimeType)`	`TextOutput`	Define o tipo MIME do conteúdo que será veiculado.

Documentação detalhada

`append(addedContent)`

Anexa conteúdo novo ao conteúdo que será veiculado.

Parâmetros

Nome	Tipo	Descrição
`addedContent`	`String`	o conteúdo a ser anexado

Retornar

TextOutput: essa TextOutput em si, útil para encadeamento.

`clear()`

Limpa o conteúdo atual.

Retornar

TextOutput: essa TextOutput em si, útil para encadeamento.

`downloadAsFile(filename)`

Instrui os navegadores a fazer download em vez de exibir esse conteúdo.

Alguns navegadores podem ignorar essa configuração. Se for definido como nulo, ele será apagado de volta para o comportamento padrão de exibição em vez de download.

Parâmetros

Nome	Tipo	Descrição
`filename`	`String`	o nome do arquivo para instruir o navegador a usar

Retornar

TextOutput: o objeto TextOutput, útil para encadeamento

Gera

Error: se o nome do arquivo tiver caracteres inválidos.

`getContent()`

Recebe o conteúdo que será veiculado.

Retornar

String: o conteúdo que será veiculado

`getFileName()`

Retorna o nome do arquivo no qual será feito download desse arquivo ou retorna nulo se ele deve ser exibido em vez baixado.

Retornar

String: o nome do arquivo.

`getMimeType()`

Define o tipo MIME com que o conteúdo será veiculado.

Retornar

MimeType: o tipo MIME com que será veiculado

`setContent(content)`

Define o conteúdo que será veiculado.

Parâmetros

Nome	Tipo	Descrição
`content`	`String`	o conteúdo a ser veiculado

Retornar

TextOutput: essa TextOutput em si, útil para encadeamento.

`setMimeType(mimeType)`

Define o tipo MIME do conteúdo que será veiculado. O padrão é texto simples.

Parâmetros

Nome	Tipo	Descrição
`mimeType`	`MimeType`	o tipo MIME

Retornar

TextOutput: essa TextOutput em si, útil para encadeamento.