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 응답 데이터

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

• 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 응답 데이터

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

• 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 응답 데이터 배열입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

• 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 키가 있습니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

작업이 호출된 경우 수행된 요청을 반환합니다.

이 메서드는 실제로 요청을 실행하지 않습니다.

매개변수

고급 매개변수

리턴

Object - 필드 이름과 값 매핑된 맵입니다. 맵에 최소한 url, method, contentType, payload, headers 키가 있습니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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