URL Fetch Service

Pobieranie adresu URL

Ta usługa umożliwia skryptom dostęp do innych zasobów w internecie przez pobieranie adresów URL. Skrypt może używać usługi UrlFetch do wysyłania żądań HTTP i HTTPS oraz odbierania odpowiedzi. Usługa UrlFetch korzysta z infrastruktury sieciowej Google w celu zwiększenia wydajności i skalowalności.

Żądania wysyłane za pomocą tej usługi pochodzą z zdefiniowanego zbioru zakresów adresów IP. Jeśli chcesz dodać te adresy do białej listy lub zatwierdzić te żądania, sprawdź pełną listę adresów IP.

Domyślny ciąg znaków klienta użytkownika w żądaniach usługi UrlFetch to Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).

Ta usługa wymaga zakresu https://www.googleapis.com/auth/script.external_request. W większości przypadków Google Apps Script automatycznie wykrywa i uwzględnia zakresy potrzebne skryptowi, ale jeśli określasz je wyraźnie, musisz ręcznie dodać ten zakres, aby go użyć.UrlFetchApp

Zobacz też

Zajęcia

NazwaKrótki opis
HTTPResponseTa klasa umożliwia użytkownikom dostęp do określonych informacji o odpowiedziach HTTP.
UrlFetchAppPobierać zasoby i komunikować się z innymi hostami przez Internet.

HTTPResponse

Metody

MetodaZwracany typKrótki opis
getAllHeaders()ObjectZwraca mapę atrybutów/wartości nagłówków odpowiedzi HTTP, w której nagłówki z wieloma wartościami są zwracane jako tablice.
getAs(contentType)BlobZwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane w tym obiekcie jako blob.
getContent()Byte[]Pobiera surowe dane binarne odpowiedzi HTTP.
getContentText()StringPobiera zawartość odpowiedzi HTTP zakodowaną jako ciąg znaków.
getContentText(charset)StringZwraca zawartość odpowiedzi HTTP zakodowaną jako ciąg znaków w danym zestawie znaków.
getHeaders()ObjectZwraca mapę atrybutów/wartości nagłówków odpowiedzi HTTP.
getResponseCode()IntegerPobierz kod stanu HTTP (200 dla OK itp.) odpowiedzi HTTP.

UrlFetchApp

Metody

MetodaZwracany typKrótki opis
fetch(url)HTTPResponseWysyła żądanie pobierania adresu URL.
fetch(url, params)HTTPResponseWysyła żądanie pobierania adresu URL za pomocą opcjonalnych parametrów zaawansowanych.
fetchAll(requests)HTTPResponse[]Wysyła wiele żądań, aby pobrać wiele adresów URL, używając opcjonalnych parametrów zaawansowanych.
getRequest(url)ObjectZwraca żądanie, które zostało wykonane, jeśli wywołano operację.
getRequest(url, params)ObjectZwraca żądanie, które zostałoby wykonane, gdyby operacja została wywołana.