Class HTTPResponse

HTTPResponse

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

Veja 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()BlobRetorne 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()IntegerReceber 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.
var 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, "myfile.pdf". No entanto, supõe que a parte do nome do arquivo que segue o último período (se houver) é uma extensão existente que precisa ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ShoppingList.12.25.pdf".

Para ver as cotas diárias de conversões, consulte Cotas do Google Services. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a cotas mais rígidas.

Parâmetros

NomeTipoDescrição
contentTypeStringO tipo MIME para o qual será feita a conversão. Para a maioria dos blobs, 'application/pdf' é a única opção válida. Para imagens nos formatos BMP, GIF, JPEG ou PNG, qualquer um dos 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' também é válido.

Retornar

Blob: os dados como um blob.

getBlob()

Retorne 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.
var 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.
var 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.
var 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.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getHeaders());

Retornar

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

getResponseCode()

Receber 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.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getResponseCode());

Retornar

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