Class UrlFetchApp

URL の取得をリクエストします。

これは HTTP と HTTPS の両方で機能します。

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

パラメータ

復路

HTTPResponse - HTTP レスポンス データ。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープで承認が必要です。

• https://www.googleapis.com/auth/script.external_request

オプションの高度なパラメータを使用して、URL の取得をリクエストします。

これは HTTP と HTTPS の両方で機能します。

// Make a GET request and log the returned content.
var response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContentText());

// Make a POST request with form data.
var resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt');
var formData = {
  'name': 'Bob Smith',
  'email': 'bob@example.com',
  'resume': resumeBlob
};
// Because payload is a JavaScript object, it is interpreted as
// as form data. (No need to specify contentType; it automatically
// defaults to either 'application/x-www-form-urlencoded'
// or 'multipart/form-data')
var options = {
  'method' : 'post',
  'payload' : formData
};
UrlFetchApp.fetch('https://httpbin.org/post', options);

// Make a POST request with a JSON payload.
var data = {
  'name': 'Bob Smith',
  'age': 35,
  'pets': ['fido', 'fluffy']
};
var options = {
  'method' : 'post',
  'contentType': 'application/json',
  // Convert the JavaScript object to a JSON string.
  'payload' : JSON.stringify(data)
};
UrlFetchApp.fetch('https://httpbin.org/post', options);

パラメータ

拡張パラメータ

復路

HTTPResponse - HTTP レスポンス データ。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープで承認が必要です。

• https://www.googleapis.com/auth/script.external_request

オプションの高度なパラメータを使用して、複数の URL を取得する複数のリクエストを行います。

これは HTTP と HTTPS の両方で機能します。

// Make both a POST request with form data, and a GET request.
var resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt');
var formData = {
  'name': 'Bob Smith',
  'email': 'bob@example.com',
  'resume': resumeBlob
};
// Because payload is a JavaScript object, it is interpreted as
// as form data. (No need to specify contentType; it defaults to either
// 'application/x-www-form-urlencoded' or 'multipart/form-data')
var request1 = {
  'url': 'https://httpbin.org/post',
  'method' : 'post',
  'payload' : formData
};
// A request may also just be a URL.
var request2 = 'https://httpbin.org/get?key=value';
UrlFetchApp.fetchAll([request1, request2]);

パラメータ

拡張パラメータ

復路

HTTPResponse[] - 各入力リクエストからの HTTP レスポンス データの配列。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープで承認が必要です。

• https://www.googleapis.com/auth/script.external_request

オペレーションが呼び出されたときに行われたリクエストを返します。

このメソッドは実際には、リクエストを発行しません。

// The code below logs the value for every key of the returned map.
var response = UrlFetchApp.getRequest("http://www.google.com/");
for(i in response) {
  Logger.log(i + ": " + response[i]);
}

パラメータ

復路

Object - フィールド名から値へのマッピング。このマップには少なくとも url、method、contentType、payload、headers のキーがあります。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープで承認が必要です。

• https://www.googleapis.com/auth/script.external_request

オペレーションが呼び出されたときに行われたリクエストを返します。

このメソッドは実際には、リクエストを発行しません。

パラメータ

拡張パラメータ

復路

Object - フィールド名から値へのマッピング。このマップには少なくとも url、method、contentType、payload、headers のキーがあります。

承認

この方法を使用するスクリプトには、次の 1 つ以上のスコープで承認が必要です。

• https://www.googleapis.com/auth/script.external_request