Class HTTPResponse

HTTPResponse

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

另請參閱

方法

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

內容詳盡的說明文件

getAllHeaders()

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

回攻員

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

getAs(contentType)

以 blob 的形式傳回這個物件中的資料，做為轉換成指定內容類型的 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.
var 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.
var 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.
var 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.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getHeaders());

回攻員

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

getResponseCode()

取得 HTTP 回應的 HTTP 狀態碼 (例如 200 代表 OK 和 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.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getResponseCode());

回攻員

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