Dịch vụ này cho phép các 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 và nhận phản hồi. Dịch vụ UrlFetch sử dụng cơ sở hạ tầng mạng của Google để đạt được hiệu suất 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 dải IP đã đặt. Bạn có thể tra cứu danh sách đầy đủ các địa chỉ IP nếu cần đưa các yêu cầu này vào danh sách cho phép hoặc phê duyệt.
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à thêm các phạm vi mà tập lệnh cần, nhưng nếu đang đặt phạm vi rõ ràng, bạn phải tự thêm phạm vi này để sử dụng UrlFetchApp.
Xem thêm
Lớp
| Tên | Mô tả ngắn |
|---|---|
HTTPResponse | Lớp này cho phép người dùng truy cập vào thông tin cụ thể trên phản hồi HTTP. |
UrlFetchApp | Tìm nạp tài nguyên và giao tiếp với các máy chủ khác qua Internet. |
HTTPResponse
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
getAllHeaders() | Object | Trả về bản đồ thuộc tính/giá trị của 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) | Blob | Trả 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 được chỉ định. |
getBlob() | Blob | Trả về dữ liệu bên trong đối tượng này dưới dạng một blob. |
getContent() | Byte[] | Lấy nội dung nhị phân thô của phản hồi HTTP. |
getContentText() | String | Lấy nội dung của phản hồi HTTP được mã hoá dưới dạng chuỗi. |
getContentText(charset) | String | Trả về nội dung của phản hồi HTTP được mã hoá dưới dạng chuỗi của bộ ký tự đã cho. |
getHeaders() | Object | Trả về bản đồ thuộc tính/giá trị của tiêu đề cho phản hồi HTTP. |
getResponseCode() | Integer | Lấy mã trạng thái HTTP (200 đối với OK, v.v.) của phản hồi HTTP. |
UrlFetchApp
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
fetch(url) | HTTPResponse | Đưa ra yêu cầu tìm nạp URL. |
fetch(url, params) | HTTPResponse | Đưa ra yêu cầu tìm nạp URL bằng cách sử dụng các thông 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ách sử dụng thông số nâng cao không bắt buộc. |
getRequest(url) | Object | Trả về yêu cầu được thực hiện nếu hoạt động đã được gọi. |
getRequest(url, params) | Object | Trả về yêu cầu được thực hiện nếu hoạt động được gọi. |