이 페이지는 Cloud Translation API를 통해 번역되었습니다.

URL Fetch Service

이 서비스를 사용하면 스크립트가 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`	작업이 호출된 경우 이루어진 요청을 반환합니다.