URL Fetch Service

Tìm nạp URL

Dịch vụ này cho phép tập lệnh truy cập vào các tài nguyên khác trên web bằng cách tìm nạp URL. Tập lệnh có thể sử dụng dịch vụ UrlFetch để đưa ra các yêu cầu HTTP và HTTPS cũng như nhận phản hồi. Dịch vụ UrlFetch sử dụng cơ sở hạ tầng mạng của Google cho mục đích hiệu quả và mở rộng quy mô.

Các yêu cầu được thực hiện bằng dịch vụ này bắt nguồn từ một nhóm các dải IP đã đặt. Bạn có thể tra cứu danh sách đầy đủ các địa chỉ IP nếu cần thêm vào danh sách trắng hoặc phê duyệt các yêu cầu này.

Chuỗi tác nhân người dùng mặc định của các yêu cầu dịch vụ UrlFetch là Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).

Dịch vụ này yêu cầu phạm vi https://www.googleapis.com/auth/script.external_request. Trong hầu hết các trường hợp, Apps Script sẽ tự động phát hiện và đưa vào các phạm vi mà tập lệnh cần, nhưng nếu bạn đang thiết lập phạm vi một cách rõ ràng, thì bạn phải thêm phạm vi này theo cách thủ công để sử dụng UrlFetchApp.

Xem thêm

Lớp

TênMô tả ngắn
HTTPResponseLớp này cho phép người dùng truy cập vào thông tin cụ thể về các phản hồi HTTP.
UrlFetchAppTìm nạp tài nguyên và giao tiếp với các máy chủ lưu trữ khác qua Internet.

HTTPResponse

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
getAllHeaders()ObjectTrả về một bản đồ thuộc tính/giá trị của các tiêu đề cho phản hồi HTTP, trong đó các tiêu đề có nhiều giá trị được trả về dưới dạng mảng.
getAs(contentType)BlobTrả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi thành loại nội dung đã chỉ định.
getBlob()BlobTrả về dữ liệu bên trong đối tượng này dưới dạng blob.
getContent()Byte[]Lấy nội dung nhị phân thô của phản hồi HTTP.
getContentText()StringLấy nội dung của phản hồi HTTP được mã hoá dưới dạng chuỗi.
getContentText(charset)StringTrả về nội dung của một phản hồi HTTP được mã hoá dưới dạng một chuỗi của bộ ký tự đã cho.
getHeaders()ObjectTrả về một bản đồ thuộc tính/giá trị của tiêu đề cho phản hồi HTTP.
getResponseCode()IntegerLấy mã trạng thái HTTP (200 cho OK, v.v.) của phản hồi HTTP.

UrlFetchApp

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
fetch(url)HTTPResponseTạo yêu cầu tìm nạp URL.
fetch(url, params)HTTPResponseTạo yêu cầu tìm nạp URL bằng các tham số nâng cao không bắt buộc.
fetchAll(requests)HTTPResponse[]Thực hiện nhiều yêu cầu để tìm nạp nhiều URL bằng các tham số nâng cao không bắt buộc.
getRequest(url)ObjectTrả về yêu cầu được thực hiện nếu thao tác được gọi.
getRequest(url, params)ObjectTrả về yêu cầu được thực hiện nếu thao tác được gọi.