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 deste objeto como um blob convertido para o tipo de conteúdo especificado.
getBlob()BlobRetorne os dados dentro deste 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()IntegerReceba 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 deste 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, 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 dos Serviços do Google. 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 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 formatos 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' também é válido. Para um documento do Documentos Google, 'text/markdown' também é válido.

Retornar

Blob: os dados como um blob.

getBlob()

Retorne os dados dentro deste 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 fornecido

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

Receba 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: código de resposta HTTP (por exemplo, 200 para "OK")