URL Fetch Service

Pobieranie adresów URL

Ta usługa umożliwia skryptom dostęp do innych zasobów w internecie przez pobranie 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 sieci Google, aby zwiększać wydajność i skalować.

Żądania wysyłane za pomocą tej usługi pochodzą ze zbioru zakresów adresów IP. Jeśli chcesz dodać te prośby do białej listy lub je zatwierdzić, wyszukaj pełną listę adresów IP.

Ta usługa wymaga zakresu https://www.googleapis.com/auth/script.external_request. W większości przypadków Apps Script automatycznie wykrywa i uwzględnia zakresy potrzebne przez skrypt, ale jeśli wyznaczasz zakresy ręcznie, musisz dodać ten zakres ręcznie, aby używać UrlFetchApp.

Zobacz też

Zajęcia

NazwaKrótki opis
HTTPResponseTa klasa umożliwia użytkownikom dostęp do określonych informacji w odpowiedziach HTTP.
UrlFetchAppPobieranie zasobów i komunikacja z innymi hostami przez internet.

HTTPResponse

Metody

MetodaZwracany typKrótki opis
getAllHeaders()ObjectZwraca mapę atrybutów/wartości nagłówków HTTP z nagłówkami, które zawierają wiele wartości zwróconych jako tablice.
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane wewnątrz tego obiektu jako blob.
getContent()Byte[]Pobiera nieprzetworzoną treść binarną odpowiedzi HTTP.
getContentText()StringPobiera treść odpowiedzi HTTP zakodowanej jako ciąg znaków.
getContentText(charset)StringZwraca zawartość odpowiedzi HTTP zakodowanej jako ciąg danego znaku.
getHeaders()ObjectZwraca mapę atrybutów/wartości nagłówków HTTP.
getResponseCode()IntegerUzyskaj kod stanu HTTP (200 dla OK itp.) w odpowiedzi HTTP.

UrlFetchApp

Metody

MetodaZwracany typKrótki opis
fetch(url)HTTPResponseWysyła żądanie pobrania adresu URL.
fetch(url, params)HTTPResponseWysyła żądanie pobrania adresu URL z opcjonalnymi parametrami zaawansowanymi.
fetchAll(requests)HTTPResponse[]Wysyła wiele żądań pobrania wielu adresów URL z opcjonalnymi parametrami zaawansowanymi.
getRequest(url)ObjectZwraca żądanie, które zostało wysłane, jeśli operacja została wywołana.
getRequest(url, params)ObjectZwraca żądanie, które zostało wysłane, jeśli operacja została wywołana.