Class UrlFetchApp

URL을 가져오기 위한 요청을 실행합니다.

이는 HTTP와 HTTPS에서 모두 작동합니다.

// The code below logs the HTML code of the Google home page.
const 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.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContentText());

// Make a POST request with form data.
const resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt');
const 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')
const options = {
  method: 'post',
  payload: formData,
};
UrlFetchApp.fetch('https://httpbin.org/post', options);

// Make a POST request with a JSON payload.
const data = {
  name: 'Bob Smith',
  age: 35,
  pets: ['fido', 'fluffy'],
};
const 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.
const resumeBlob = Utilities.newBlob('Hire me!', 'text/plain', 'resume.txt');
const 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')
const request1 = {
  url: 'https://httpbin.org/post',
  method: 'post',
  payload: formData,
};
// A request may also just be a URL.
const 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.
const response = UrlFetchApp.getRequest('http://www.google.com/');
for (const 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