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 atributos/valor de cabeçalhos para a resposta HTTP, com cabeçalhos que têm diversos valores retornados como matrizes.
getAs(contentType)BlobRetorna os dados dentro desse objeto como um blob convertido no tipo de conteúdo especificado.
getBlob()BlobRetorne os dados dentro desse objeto como um blob.
getContent()Byte[]Extrai 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 de cabeçalhos para a resposta HTTP.
getResponseCode()IntegerObter o código de status HTTP (200 para OK etc.) de uma resposta HTTP.

Documentação detalhada

getAllHeaders()

Retorna um mapa de atributos/valor de cabeçalhos para a resposta HTTP, com cabeçalhos que têm diversos 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 no tipo de conteúdo especificado. Isso adiciona a extensão adequada ao nome do arquivo, por exemplo, "myfile.pdf". No entanto, pressupõe que a parte do nome do arquivo que segue o ponto final (se houver) é uma que deve ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ListaShopping.12.25.pdf".

Para acessar as cotas diárias para conversões, consulte Cotas do Google Serviços. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a medidas cotas.

Parâmetros

NomeTipoDescrição
contentTypeStringO tipo MIME em que a conversão será feita. Para a maioria dos blobs, 'application/pdf' é a única opção válida. Para imagens no formato BMP, GIF, JPEG ou PNG, qualquer um dos valores 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' também precisa ser válidos. Para um documento do Documentos Google, 'text/markdown' 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()

Extrai 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 a resposta HTTP conteúdo

Retornar

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


getHeaders()

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

Obter 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)