Class HTTPResponse

HTTPResponse

Ta klasa umożliwia użytkownikom dostęp do określonych informacji o odpowiedziach HTTP.

Zobacz też

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.

Szczegółowa dokumentacja

getAllHeaders()

Zwraca mapę atrybutów/wartości nagłówków odpowiedzi HTTP, w której nagłówki z wieloma wartościami są zwracane jako tablice. 

// The code below logs the HTTP headers from the response
// received when fetching the Google home page.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getAllHeaders());

Powrót

Object – mapa kluczy i wartości JavaScripta dla nagłówków HTTP

getAs(contentType)

Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „mójplik.pdf”. Zakłada ona jednak, że część nazwy pliku, która następuje po ostatnim okresie (jeśli w ogóle występuje), to istniejące rozszerzenie, które należy zastąpić. W rezultacie plik „ShoppingList.12.25.2014” staje się „ShoppingList.12.25.pdf”.

Informacje o limitach dziennych konwersji znajdziesz w artykule Limity dotyczące usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma nastąpić konwersja. W przypadku większości blobów opcja 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są również wartości 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'. W przypadku dokumentu w Dokumentach Google możesz też użyć 'text/markdown'.

Powrót

Blob – dane w postaci bloba.

getBlob()

Zwraca dane w tym obiekcie jako blob.

Powrót

Blob – dane w postaci bloba.

getContent()

Pobiera surowe dane binarne odpowiedzi HTTP. 

// The code below logs the value of the first byte of the Google home page.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContent()[0]);

Powrót

Byte[] – treści jako nieprzetworzony tablicowy ciąg binarny;

getContentText()

Pobiera zawartość odpowiedzi HTTP zakodowaną jako ciąg znaków. 

// The code below logs the HTML code of the Google home page.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContentText());

Powrót

String – treść odpowiedzi HTTP jako ciąg znaków

getContentText(charset)

Zwraca zawartość odpowiedzi HTTP zakodowaną jako ciąg znaków w danym zestawie znaków. 

// The code below logs the HTML code of the Google home page with the UTF-8
// charset.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContentText('UTF-8'));

Parametry

NazwaTypOpis
charsetStringciąg tekstowy reprezentujący kod znaków, który ma być użyty do kodowania treści odpowiedzi HTTP;

Powrót

String – zawartość odpowiedzi HTTP zakodowana za pomocą podanego zestawu znaków

getHeaders()

Zwraca mapę atrybutów/wartości nagłówków odpowiedzi HTTP. 

// The code below logs the HTTP headers from the response
// received when fetching the Google home page.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getHeaders());

Powrót

Object – mapa kluczy i wartości JavaScripta dla nagłówków HTTP

getResponseCode()

Pobierz kod stanu HTTP (200 dla OK itp.) odpowiedzi HTTP. 

// The code below logs the HTTP status code from the response received
// when fetching the Google home page.
// It should be 200 if the request succeeded.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getResponseCode());

Powrót

Integer – kod odpowiedzi HTTP (np. 200 dla OK)