URL Fetch Service

URL 가져오기

이 서비스를 사용하면 스크립트가 URL을 가져와 웹의 다른 리소스에 액세스할 수 있습니다. 스크립트는 UrlFetch 서비스를 사용하여 HTTP 및 HTTPS 요청을 실행하고 응답을 수신할 수 있습니다. UrlFetch 서비스는 효율성과 확장성을 위해 Google의 네트워크 인프라를 사용합니다.

이 서비스를 사용하여 이루어진 요청은 지정된 IP 범위 풀에서 시작됩니다. 이러한 요청을 허용 목록에 추가하거나 승인해야 하는 경우 IP 주소의 전체 목록을 조회할 수 있습니다.

UrlFetch 서비스 요청의 기본 사용자 에이전트 문자열은 Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID)입니다.

이 서비스에는 https://www.googleapis.com/auth/script.external_request 범위가 필요합니다. 대부분의 경우 Apps Script는 스크립트에 필요한 범위를 자동으로 감지하고 포함하지만 범위를 명시적으로 설정하는 경우 UrlFetchApp를 사용하려면 이 범위를 수동으로 추가해야 합니다.

참고 항목

클래스

이름간략한 설명
HTTPResponse이 클래스를 사용하면 사용자가 HTTP 응답의 특정 정보에 액세스할 수 있습니다.
UrlFetchApp인터넷을 통해 리소스를 가져오고 다른 호스트와 통신합니다.

HTTPResponse

메서드

메서드반환 유형간략한 설명
getAllHeaders()ObjectHTTP 응답의 헤더의 속성/값 매핑을 반환하며, 여러 값이 있는 헤더는 배열로 반환됩니다.
getAs(contentType)Blob이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다.
getBlob()Blob이 객체 내의 데이터를 blob으로 반환합니다.
getContent()Byte[]HTTP 응답의 원시 바이너리 콘텐츠를 가져옵니다.
getContentText()StringHTTP 응답의 콘텐츠를 문자열로 인코딩하여 가져옵니다.
getContentText(charset)String지정된 문자 집합의 문자열로 인코딩된 HTTP 응답의 콘텐츠를 반환합니다.
getHeaders()ObjectHTTP 응답의 헤더 속성/값 매핑을 반환합니다.
getResponseCode()IntegerHTTP 응답의 HTTP 상태 코드 (OK의 경우 200 등)를 가져옵니다.

UrlFetchApp

메서드

메서드반환 유형간략한 설명
fetch(url)HTTPResponseURL을 가져오기 위한 요청을 실행합니다.
fetch(url, params)HTTPResponse선택적 고급 매개변수를 사용하여 URL을 가져오도록 요청합니다.
fetchAll(requests)HTTPResponse[]선택적 고급 매개변수를 사용하여 여러 URL을 가져오기 위해 여러 번 요청합니다.
getRequest(url)Object작업이 호출된 경우 이루어진 요청을 반환합니다.
getRequest(url, params)Object작업이 호출된 경우 이루어진 요청을 반환합니다.