URL Fetch Service

URL Getirme

Bu hizmet, komut dosyalarının URL'leri getirerek web'deki diğer kaynaklara erişmesine olanak tanır. Bir komut dosyası, 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, bir dizi IP aralığından kaynaklanır. Bu istekleri beyaz listeye eklemeniz veya onaylamanız gerekiyorsa IP adreslerinin tam listesini arayabilirsiniz.

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

Bu hizmet için https://www.googleapis.com/auth/script.external_request kapsamı gerekir. Çoğu durumda Apps Komut Dosyası, bir komut dosyasının ihtiyaç duyduğu kapsamları otomatik olarak algılar ve ekler. Ancak kapsamlarınızı açıkça ayarlıyorsanız UrlFetchApp özelliğini kullanmak için bu kapsamı manuel olarak eklemeniz gerekir.

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

• HTTPResponse
• Açık kapsamlar ayarlama

Sınıflar

Ad	Kısa açıklama
HTTPResponse	Bu sınıf, kullanıcıların HTTP yanıtlarındaki belirli bilgilere erişmesine olanak tanır.
UrlFetchApp	Kaynakları getirmek ve internet üzerinden diğer ana makinelerle iletişim kurmak için kullanılır.

HTTPResponse

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
getAllHeaders()	Object	HTTP yanıtı için üstbilgilerin özellik/değer eşlemesini döndürür. Birden fazla değere sahip ü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ürür.
getBlob()	Blob	Bu nesnenin içindeki verileri blob olarak döndürür.
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	Bir HTTP yanıtının, verilen karakter kümesi dizesi olarak kodlanmış içeriğini döndürür.
getHeaders()	Object	HTTP yanıtı için başlıkların bir özellik/değer haritasını döndürür.
getResponseCode()	Integer	Bir HTTP yanıtının HTTP durum kodunu (ör. OK için 200) alın.

UrlFetchApp

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
fetch(url)	HTTPResponse	Bir URL'yi getirmek için istekte bulunur.
fetch(url, params)	HTTPResponse	İsteğe bağlı gelişmiş parametreleri kullanarak bir URL'yi getirmek için istekte bulunur.
fetchAll(requests)	HTTPResponse[]	İsteğe bağlı gelişmiş parametreleri kullanarak birden fazla URL getirmek için birden fazla 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ılırsa yapılan isteği döndürür.