Layanan ini memungkinkan skrip mengakses resource lain di web dengan mengambil URL. Skrip dapat menggunakan layanan UrlFetch untuk mengajukan permintaan HTTP dan HTTPS serta menerima respons. Layanan UrlFetch menggunakan infrastruktur jaringan Google untuk tujuan efisiensi dan penskalaan.
Permintaan yang dibuat menggunakan layanan ini berasal dari kumpulan rentang IP. Anda dapat mencari daftar lengkap alamat IP jika perlu mengizinkan atau menyetujui permintaan ini.
Layanan ini memerlukan cakupan
https://www.googleapis.com/auth/script.external_request. Pada umumnya, Apps Script otomatis mendeteksi dan menyertakan cakupan yang diperlukan skrip, tetapi
jika Anda
menetapkan cakupan secara eksplisit,
Anda harus menambahkan cakupan ini secara manual agar dapat menggunakan UrlFetchApp.
Lihat juga
Class
| Nama | Deskripsi singkat |
|---|---|
HTTPResponse | Class ini memungkinkan pengguna mengakses informasi spesifik tentang respons HTTP. |
UrlFetchApp | Mengambil resource dan berkomunikasi dengan host lain melalui Internet. |
HTTPResponse
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
|---|---|---|
getAllHeaders() | Object | Menampilkan peta atribut/nilai header untuk respons HTTP, dengan header yang memiliki beberapa nilai yang ditampilkan sebagai array. |
getAs(contentType) | Blob | Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. |
getBlob() | Blob | Menampilkan data di dalam objek ini sebagai blob. |
getContent() | Byte[] | Mendapatkan konten biner mentah dari respons HTTP. |
getContentText() | String | Mendapatkan konten respons HTTP yang dienkode sebagai string. |
getContentText(charset) | String | Menampilkan konten respons HTTP yang dienkode sebagai string dari charset yang diberikan. |
getHeaders() | Object | Menampilkan peta atribut/nilai header untuk respons HTTP. |
getResponseCode() | Integer | Mendapatkan kode status HTTP (200 untuk OK, dll.) dari respons HTTP. |
UrlFetchApp
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
|---|---|---|
fetch(url) | HTTPResponse | Membuat permintaan untuk mengambil URL. |
fetch(url, params) | HTTPResponse | Membuat permintaan untuk mengambil URL menggunakan parameter lanjutan opsional. |
fetchAll(requests) | HTTPResponse[] | Membuat beberapa permintaan untuk mengambil beberapa URL menggunakan parameter lanjutan opsional. |
getRequest(url) | Object | Menampilkan permintaan yang dibuat jika operasi dipanggil. |
getRequest(url, params) | Object | Menampilkan permintaan yang dibuat jika operasi dipanggil. |