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
Nazwa | Krótki opis |
---|---|
HTTPResponse | Ta klasa umożliwia użytkownikom dostęp do określonych informacji w odpowiedziach HTTP. |
UrlFetchApp | Pobieranie zasobów i komunikacja z innymi hostami przez internet. |
HTTPResponse
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getAllHeaders() | Object | Zwraca mapę atrybutów/wartości nagłówków HTTP z nagłówkami, które zawierają wiele wartości zwróconych jako tablice. |
getAs(contentType) | Blob | Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. |
getBlob() | Blob | Zwraca dane wewnątrz tego obiektu jako blob. |
getContent() | Byte[] | Pobiera nieprzetworzoną treść binarną odpowiedzi HTTP. |
getContentText() | String | Pobiera treść odpowiedzi HTTP zakodowanej jako ciąg znaków. |
getContentText(charset) | String | Zwraca zawartość odpowiedzi HTTP zakodowanej jako ciąg danego znaku. |
getHeaders() | Object | Zwraca mapę atrybutów/wartości nagłówków HTTP. |
getResponseCode() | Integer | Uzyskaj kod stanu HTTP (200 dla OK itp.) w 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 opcjonalnymi parametrami zaawansowanymi. |
fetchAll(requests) | HTTPResponse[] | Wysyła wiele żądań pobrania wielu adresów URL z opcjonalnymi parametrami zaawansowanymi. |
getRequest(url) | Object | Zwraca żądanie, które zostało wysłane, jeśli operacja została wywołana. |
getRequest(url, params) | Object | Zwraca żądanie, które zostało wysłane, jeśli operacja została wywołana. |