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 otrzymywania 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 określonej puli zakresów adresów IP. Jeśli musisz umieścić te żądania na białej liście lub je zatwierdzić, możesz sprawdzić 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 Apps Script automatycznie wykrywa i uwzględnia zakresy, których skrypt potrzebuje, ale jeśli ustawiasz zakresy jawnie, musisz ręcznie dodać ten zakres, aby używać UrlFetchApp.

Zobacz też

• HTTPResponse
• Ustawianie jawnych zakresów

Zajęcia

Nazwa	Krótki opis
HTTPResponse	Ta klasa umożliwia użytkownikom dostęp do określonych informacji o odpowiedziach HTTP.
UrlFetchApp	pobierać zasoby i komunikować się z innymi hostami w internecie;

HTTPResponse

Metody

Metoda	Zwracany typ	Krótki opis
getAllHeaders()	Object	Zwraca mapę atrybutów i wartości nagłówków odpowiedzi HTTP. Nagłówki, które mają wiele wartości, są zwracane jako tablice.
getAs(contentType)	Blob	Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
getBlob()	Blob	Zwraca dane w tym obiekcie jako obiekt blob.
getContent()	Byte[]	Pobiera nieprzetworzoną zawartość binarną odpowiedzi HTTP.
getContentText()	String	Pobiera treść odpowiedzi HTTP zakodowaną jako ciąg znaków.
getContentText(charset)	String	Zwraca treść odpowiedzi HTTP zakodowaną jako ciąg znaków w danym zestawie znaków.
getHeaders()	Object	Zwraca mapę atrybutów i wartości nagłówków odpowiedzi HTTP.
getResponseCode()	Integer	Pobierz kod stanu HTTP (200 w przypadku OK itp.) odpowiedzi HTTP.

UrlFetchApp

Metody

Metoda	Zwracany typ	Krótki opis
fetch(url)	HTTPResponse	Wysyła żądanie pobrania adresu URL.
fetch(url, params)	HTTPResponse	Wysyła żądanie pobrania adresu URL z użyciem opcjonalnych parametrów zaawansowanych.
fetchAll(requests)	HTTPResponse[]	Wysyła wiele żądań pobrania wielu adresów URL przy użyciu opcjonalnych parametrów zaawansowanych.
getRequest(url)	Object	Zwraca żądanie, które jest wysyłane, jeśli operacja została wywołana.
getRequest(url, params)	Object	Zwraca żądanie, które zostanie wysłane, jeśli operacja zostanie wywołana.