Class HTTPResponse

HTTPResponse

這個類別可讓使用者存取 HTTP 回應的特定資訊。

另請參閱

方法

方法傳回類型簡短說明
getAllHeaders()Object傳回 HTTP 回應標頭的屬性/值對應，其中標頭的多個值會以陣列的形式傳回。
getAs(contentType)Blob將此物件內的資料傳回為轉換為指定內容類型的 Blob。
getBlob()Blob將此物件內的資料以 blob 格式傳回。
getContent()Byte[]取得 HTTP 回應的原始二進位內容。
getContentText()String取得以字串編碼的 HTTP 回應內容。
getContentText(charset)String傳回以指定字元集編碼的字串形式的 HTTP 回應內容。
getHeaders()Object傳回 HTTP 回應標頭的屬性/值對應。
getResponseCode()Integer取得 HTTP 回應的 HTTP 狀態碼 (200 代表「OK」等)。

內容詳盡的說明文件

getAllHeaders()

傳回 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.getAllHeaders());

回攻員

Object：HTTP 標頭的 JavaScript 鍵/值對應

getAs(contentType)

將此物件內的資料傳回為轉換為指定內容類型的 Blob。這個方法會在檔案名稱中加入適當的副檔名，例如「myfile.pdf」。不過，這會假設檔案名稱中最後一個句點 (如有) 後面的部分是應取代的現有副檔名。因此，「ShoppingList.12.25.2014」會變成「ShoppingList.12.25.pdf」。

如要查看轉換的每日配額，請參閱「Google 服務的配額」。新建立的 Google Workspace 網域可能會暫時受到較嚴格的配額限制。

參數

名稱類型說明
contentTypeString要轉換的 MIME 類型。對於大多數 Blob 而言，'application/pdf' 是唯一有效的選項。如果是 BMP、GIF、JPEG 或 PNG 格式的圖片，'image/bmp'、'image/gif'、'image/jpeg' 或 'image/png' 皆可用。如果是 Google 文件，'text/markdown' 也是有效的。

回攻員

Blob：資料為 Blob。

getBlob()

將此物件內的資料以 blob 格式傳回。

回攻員

Blob：資料為 Blob。

getContent()

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

回攻員

Byte[]：內容為原始二進位陣列

getContentText()

取得以字串編碼的 HTTP 回應內容。

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

回攻員

String：HTTP 回應內容，以字串表示

getContentText(charset)

傳回以指定字元集編碼的字串形式，以 HTTP 回應內容。

// 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'));

參數

名稱類型說明
charsetString字串，代表用於編碼 HTTP 回應內容的字元集

回攻員

String：HTTP 回應內容，使用指定的字元集編碼

getHeaders()

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

回攻員

Object：HTTP 標頭的 JavaScript 鍵/值對應

getResponseCode()

取得 HTTP 回應的 HTTP 狀態碼 (200 代表成功等)。

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

回攻員

Integer：HTTP 回應代碼 (例如 200 代表「OK」)