Class HTTPResponse

HTTPResponse

Essa classe permite que os usuários acessem informações específicas sobre respostas HTTP.

Consulte também

Métodos

MétodoTipo de retornoBreve descrição
getAllHeaders()ObjectRetorna um mapa de atributo/valor de cabeçalhos para a resposta HTTP, com cabeçalhos que têm vários valores retornados como matrizes.
getAs(contentType)BlobRetorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado.
getBlob()BlobRetorna os dados dentro desse objeto como um blob.
getContent()Byte[]Recebe o conteúdo binário bruto de uma resposta HTTP.
getContentText()StringRecebe o conteúdo de uma resposta HTTP codificada como uma string.
getContentText(charset)StringRetorna o conteúdo de uma resposta HTTP codificada como uma string do conjunto de caracteres especificado.
getHeaders()ObjectRetorna um mapa de atributo/valor de cabeçalhos para a resposta HTTP.
getResponseCode()IntegerRecebe o código de status HTTP (200 para OK etc.) de uma resposta HTTP.

Documentação detalhada

getAllHeaders()

Retorna um mapa de atributo/valor de cabeçalhos para a resposta HTTP, com cabeçalhos que têm vários valores retornados como matrizes. 

// The code below logs the HTTP headers from the response
// received when fetching the Google home page.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getAllHeaders());

Retornar

Object: um mapa de chave/valor JavaScript de cabeçalhos HTTP.

getAs(contentType)

Retorna os dados dentro desse objeto como um blob convertido para o tipo de conteúdo especificado. Esse método adiciona a extensão apropriada ao nome do arquivo, por exemplo, "meuarquivo.pdf". No entanto, ele pressupõe que a parte do nome do arquivo que segue o último ponto (se houver) é uma extensão existente que precisa ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ShoppingList.12.25.pdf".

Para conferir as cotas diárias de conversões, consulte Cotas para serviços do Google. Os domínios do Google Workspace criados recentemente podem estar sujeitos temporariamente a cotas mais rígidas.

Parâmetros

NomeTipoDescrição
contentTypeStringO tipo MIME para conversão. Para a maioria dos blobs, 'application/pdf' é a única opção válida. Para imagens em formato BMP, GIF, JPEG ou PNG, qualquer uma das opções 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' também é válida. Para um documento do Google Docs, 'text/markdown' também é válido.

Retornar

Blob: os dados como um blob.

getBlob()

Retorna os dados dentro desse objeto como um blob.

Retornar

Blob: os dados como um blob.

getContent()

Recebe o conteúdo binário bruto de uma resposta HTTP. 

// The code below logs the value of the first byte of the Google home page.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContent()[0]);

Retornar

Byte[]: o conteúdo como uma matriz binária bruta

getContentText()

Recebe o conteúdo de uma resposta HTTP codificada como uma string. 

// The code below logs the HTML code of the Google home page.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContentText());

Retornar

String: o conteúdo da resposta HTTP, como uma string

getContentText(charset)

Retorna o conteúdo de uma resposta HTTP codificada como uma string do conjunto de caracteres especificado. 

// The code below logs the HTML code of the Google home page with the UTF-8
// charset.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContentText('UTF-8'));

Parâmetros

NomeTipoDescrição
charsetStringuma string que representa o conjunto de caracteres a ser usado para codificar o conteúdo da resposta HTTP

Retornar

String: o conteúdo da resposta HTTP, codificado usando o conjunto de caracteres especificado

getHeaders()

Retorna um mapa de atributo/valor de cabeçalhos para a resposta HTTP. 

// The code below logs the HTTP headers from the response
// received when fetching the Google home page.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getHeaders());

Retornar

Object: um mapa de chave/valor JavaScript de cabeçalhos HTTP.

getResponseCode()

Recebe o código de status HTTP (200 para OK etc.) de uma resposta HTTP. 

// The code below logs the HTTP status code from the response received
// when fetching the Google home page.
// It should be 200 if the request succeeded.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getResponseCode());

Retornar

Integer: o código de resposta HTTP (por exemplo, 200 para OK).