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 atributos/valores de cabeçalhos para a resposta HTTP, com cabeçalhos que têm vários valores retornados como matrizes.
getAs(contentType)BlobRetorne 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 atributos/valores dos cabeçalhos para a resposta HTTP.
getResponseCode()IntegerConsiga o código de status HTTP (200 para OK etc.) de uma resposta HTTP.

Documentação detalhada

getAllHeaders()

Retorna um mapa de atributos/valores 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());

Retorno

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


getAs(contentType)

Retorne 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, ela pressupõe que a parte do nome do arquivo que segue o último ponto (se houver) é uma extensão 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 para Serviços do Google. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a cotas mais rigorosas.

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 no formato BMP, GIF, JPEG ou PNG, qualquer elemento 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' também é válido.

Retorno

Blob: os dados como um blob.


getBlob()

Retorne os dados dentro desse objeto como um blob.

Retorno

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]);

Retorno

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());

Retorno

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

Retorno

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


getHeaders()

Retorna um mapa de atributos/valores dos 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());

Retorno

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


getResponseCode()

Consiga 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());

Retorno

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