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 表示正常等)。

內容詳盡的說明文件

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