URL Fetch Service

URL Getirme

Bu hizmet, komut dosyalarının URL'leri getirerek web'deki diğer kaynaklara erişmesine olanak tanır. Komut dosyaları, HTTP ve HTTPS istekleri göndermek ve yanıt almak için UrlFetch hizmetini kullanabilir. UrlFetch hizmeti, verimlilik ve ölçeklendirme amacıyla Google'ın ağ altyapısını kullanır.

Bu hizmet kullanılarak yapılan istekler, belirli bir IP aralığı havuzundan gelir. Bu istekleri beyaz listeye eklemeniz veya onaylamanız gerekiyorsa IP adreslerinin tam listesini görüntüleyebilirsiniz.

UrlFetch hizmet isteklerinin varsayılan kullanıcı aracısı dizesi Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID)'tür.

Bu hizmet için https://www.googleapis.com/auth/script.external_request kapsamı gereklidir. Çoğu durumda Apps Script, komut dosyasının ihtiyaç duyduğu kapsamları otomatik olarak algılayıp dahil eder. Ancak kapsamlarınızı açıkça ayarlıyorsanız UrlFetchApp kullanmak için bu kapsamı manuel olarak eklemeniz gerekir.

Aşağıdaki kaynakları da incelemenizi öneririz:

• HTTPResponse
• Açık kapsamlar belirleme

Sınıflar

Ad	Kısa açıklama
HTTPResponse	Bu sınıf, kullanıcıların HTTP yanıtlarıyla ilgili belirli bilgilere erişmesine olanak tanır.
UrlFetchApp	İnternet üzerinden kaynaklar getirmek ve diğer ana makinelerle iletişim kurmak.

HTTPResponse

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
getAllHeaders()	Object	HTTP yanıtının üstbilgilerinin özellik/değer haritasını döndürür. Birden fazla değeri olan üstbilgiler dizi olarak döndürülür.
getAs(contentType)	Blob	Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürme.
getBlob()	Blob	Bu nesnenin içindeki verileri bir blob olarak döndürme.
getContent()	Byte[]	Bir HTTP yanıtının ham ikili içeriğini alır.
getContentText()	String	Bir HTTP yanıtının içeriğini dize olarak kodlanmış şekilde alır.
getContentText(charset)	String	Belirtilen karakter kümesinin dizesi olarak kodlanmış bir HTTP yanıtının içeriğini döndürür.
getHeaders()	Object	HTTP yanıtının üst bilgilerinin özellik/değer haritasını döndürür.
getResponseCode()	Integer	Bir HTTP yanıtının HTTP durum kodunu (OK için 200 vb.) alın.

UrlFetchApp

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
fetch(url)	HTTPResponse	URL getirme isteği gönderir.
fetch(url, params)	HTTPResponse	İsteğe bağlı gelişmiş parametreleri kullanarak bir URL getirme isteği gönderir.
fetchAll(requests)	HTTPResponse[]	İsteğe bağlı gelişmiş parametreleri kullanarak birden fazla URL almak için birden fazla istek gönderir.
getRequest(url)	Object	İşlem çağrıldıysa yapılan isteği döndürür.
getRequest(url, params)	Object	İşlem çağrılmış olsaydı yapılan isteği döndürür.