이 서비스를 통해 스크립트는 URL을 가져와 웹의 다른 리소스에 액세스할 수 있습니다. 스크립트는 UrlFetch 서비스를 사용하여 HTTP 및 HTTPS 요청을 실행하고 응답을 수신할 수 있습니다. UrlFetch 서비스는 효율성과 확장 용도로 Google의 네트워크 인프라를 사용합니다.
이 서비스를 사용하는 요청은 설정된 IP 범위 풀에서 시작됩니다. 이러한 요청을 허용 또는 승인해야 하는 경우 IP 주소의 전체 목록을 조회할 수 있습니다.
이 서비스에는 https://www.googleapis.com/auth/script.external_request 범위가 필요합니다. 대부분의 경우 Apps Script는 스크립트에 필요한 범위를 자동으로 감지하고 포함하지만 범위를 명시적으로 설정하는 경우 UrlFetchApp을 사용하려면 이 범위를 수동으로 추가해야 합니다.
참고 항목
클래스
| 이름 | 간략한 설명 |
|---|---|
HTTPResponse | 이 클래스를 사용하면 사용자가 HTTP 응답의 특정 정보에 액세스할 수 있습니다. |
UrlFetchApp | 인터넷을 통해 리소스를 가져오고 다른 호스트와 통신합니다. |
HTTPResponse
메서드
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
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 상태 코드 (예: OK의 경우 200)를 가져옵니다. |
UrlFetchApp
메서드
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
fetch(url) | HTTPResponse | URL 가져오기를 요청합니다. |
fetch(url, params) | HTTPResponse | 선택적 고급 매개변수를 사용하여 URL 가져오기를 요청합니다. |
fetchAll(requests) | HTTPResponse[] | 선택적 고급 매개변수를 사용하여 여러 URL을 가져오도록 여러 번 요청합니다. |
getRequest(url) | Object | 작업이 호출된 경우 이루어진 요청을 반환합니다. |
getRequest(url, params) | Object | 작업이 호출된 경우 이루어진 요청을 반환합니다. |