Bu hizmet, komut dosyalarının URL'leri getirerek web'deki diğer kaynaklara erişmesini sağlar. Komut dosyası, HTTP ve HTTPS istekleri yayınlamak 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, IP aralıklarından oluşan belirlenmiş bir havuzdan gelir. Bu istekleri beyaz listeye eklemeniz veya onaylamanız gerekiyorsa IP adreslerinin tam listesine bakabilirsiniz.
Bu hizmet için https://www.googleapis.com/auth/script.external_request kapsamı gerekir. Çoğu durumda Apps Komut Dosyası, komut dosyasının ihtiyaç duyduğu kapsamları otomatik olarak tespit edip dahil eder. Ancak kapsamlarınızı açık bir şekilde ayarlıyorsanız UrlFetchApp kullanmak için bu kapsamı manuel olarak eklemeniz gerekir.
Aşağıdaki kaynakları da incelemenizi öneririz:
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 | Kaynakları getirin ve internet üzerinden diğer ana makinelerle iletişim kurun. |
HTTPResponse
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
getAllHeaders() | Object | Dizi olarak döndürülen birden çok değere sahip başlıklara sahip, HTTP yanıtı için başlıkların bir özellik/değer eşlemesini döndürü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ürün. |
getBlob() | Blob | Bu nesnenin içindeki verileri blob olarak döndürün. |
getContent() | Byte[] | Bir HTTP yanıtının ham ikili içeriğini alır. |
getContentText() | String | Dize olarak kodlanmış bir HTTP yanıtının içeriğini alır. |
getContentText(charset) | String | Belirtilen karakter kümesinde dize olarak kodlanmış bir HTTP yanıtının içeriğini döndürür. |
getHeaders() | Object | HTTP yanıtı için üstbilgilerin bir özellik/değer eşlemesini döndürür. |
getResponseCode() | Integer | Bir HTTP yanıtının HTTP durum kodunu (Tamam 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ğinde bulunur. |
fetch(url, params) | HTTPResponse | İsteğe bağlı gelişmiş parametreleri kullanarak URL getirme isteğinde bulunur. |
fetchAll(requests) | HTTPResponse[] | İsteğe bağlı gelişmiş parametreleri kullanarak birden çok URL'yi getirmek için birden çok istekte bulunur. |
getRequest(url) | Object | İşlem çağrıldıysa yapılan isteği döndürür. |
getRequest(url, params) | Object | İşlem çağrıldıysa yapılan isteği döndürür. |