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, đồng thời 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 nâng cao hiệu quả và khả năng mở rộng.

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 cố định. 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.

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à thêm các phạm vi mà một tập lệnh cần, nhưng nếu đặt phạm vi một cách rõ ràng, bạn phải thêm phạm vi này theo cách thủ công để sử dụng UrlFetchApp.

Xem thêm

• HTTPResponse
• Đặt phạm vi rõ ràng

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ể về các 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ủ lưu trữ 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ề một 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 sang loại nội dung đã 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 một phản hồi HTTP.
getContentText()	String	Lấy nội dung của một phản hồi HTTP được mã hoá dưới dạng một chuỗi.
getContentText(charset)	String	Trả 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()	Object	Trả về một bản đồ thuộc tính/giá trị của các tiêu đề cho phản hồi HTTP.
getResponseCode()	Integer	Nhận mã trạng thái HTTP (200 cho OK, v.v.) của một 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 một URL.
fetch(url, params)	HTTPResponse	Đưa ra yêu cầu tìm nạp một URL bằng các tham số nâng cao không bắt buộc.
fetchAll(requests)	HTTPResponse[]	Đưa ra 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)	Object	Trả về yêu cầu được thực hiện nếu thao tác được gọi.
getRequest(url, params)	Object	Trả về yêu cầu được thực hiện nếu thao tác được gọi.