URL Fetch Service

Pengambilan URL

Layanan ini memungkinkan skrip mengakses resource lain di web dengan mengambil URL. Skrip dapat menggunakan layanan UrlFetch untuk mengeluarkan 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 yang ditetapkan. Anda dapat mencari daftar lengkap alamat IP jika perlu memasukkan alamat IP ini ke dalam daftar yang diizinkan atau menyetujui permintaan ini.

String agen pengguna default dari permintaan layanan UrlFetch adalah Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).

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 untuk menggunakan UrlFetchApp.

Lihat juga

Class

NamaDeskripsi singkat
HTTPResponseClass ini memungkinkan pengguna mengakses informasi spesifik tentang respons HTTP.
UrlFetchAppMengambil resource dan berkomunikasi dengan host lain melalui Internet.

HTTPResponse

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getAllHeaders()ObjectMenampilkan peta atribut/nilai header untuk respons HTTP, dengan header yang memiliki beberapa nilai yang ditampilkan sebagai array.
getAs(contentType)BlobMenampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
getBlob()BlobMenampilkan data di dalam objek ini sebagai blob.
getContent()Byte[]Mendapatkan konten biner mentah dari respons HTTP.
getContentText()StringMendapatkan konten respons HTTP yang dienkode sebagai string.
getContentText(charset)StringMenampilkan konten respons HTTP yang dienkode sebagai string dari set karakter yang diberikan.
getHeaders()ObjectMenampilkan peta atribut/nilai header untuk respons HTTP.
getResponseCode()IntegerMendapatkan kode status HTTP (200 untuk OK, dll.) dari respons HTTP.

UrlFetchApp

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
fetch(url)HTTPResponseMembuat permintaan untuk mengambil URL.
fetch(url, params)HTTPResponseMembuat permintaan untuk mengambil URL menggunakan parameter lanjutan opsional.
fetchAll(requests)HTTPResponse[]Membuat beberapa permintaan untuk mengambil beberapa URL menggunakan parameter lanjutan opsional.
getRequest(url)ObjectMenampilkan permintaan yang dibuat jika operasi dipanggil.
getRequest(url, params)ObjectMenampilkan permintaan yang dibuat jika operasi dipanggil.