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 i wartości nagłówków odpowiedzi HTTP. Nagłówki, które mają wiele wartości, są zwracane jako tablice.
getAs(contentType)BlobZwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane w tym obiekcie jako obiekt blob.
getContent()Byte[]Pobiera surową zawartość binarną odpowiedzi HTTP.
getContentText()StringPobiera treść odpowiedzi HTTP zakodowaną jako ciąg znaków.
getContentText(charset)StringZwraca treść odpowiedzi HTTP zakodowaną jako ciąg znaków w danym zestawie znaków.
getHeaders()ObjectZwraca mapę atrybutów i wartości nagłówków odpowiedzi HTTP.
getResponseCode()IntegerPobierz kod stanu HTTP (200 w przypadku OK itp.) odpowiedzi HTTP.

Szczegółowa dokumentacja

getAllHeaders()

Zwraca mapę atrybutów i wartości nagłówków odpowiedzi HTTP. Nagłówki, które mają wiele wartości, 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 klucz/wartość w JavaScript zawierająca nagłówki HTTP.

getAs(contentType)

Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, np. „mójplik.pdf”. Zakłada jednak, że część nazwy pliku, która następuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W konsekwencji nazwa „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zapoznaj się z artykułem Limity usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME, na który ma zostać przekonwertowany plik. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf'. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są też znaki 'image/bmp', 'image/gif', 'image/jpeg' i 'image/png'. W przypadku dokumentu w Dokumentach Google 'text/markdown' jest również prawidłowe.

Powrót

Blob – dane w formie obiektu blob.

getBlob()

Zwraca dane w tym obiekcie jako obiekt blob.

Powrót

Blob – dane w formie obiektu blob.

getContent()

Pobiera surową zawartość binarną 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ść jako surowa tablica binarna;

getContentText()

Pobiera treść 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 w postaci ciągu znaków.

getContentText(charset)

Zwraca treść 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 znaków reprezentujący zestaw znaków, który ma być używany do kodowania treści odpowiedzi HTTP;

Powrót

String – treść odpowiedzi HTTP zakodowana przy użyciu podanego zestawu znaków.

getHeaders()

Zwraca mapę atrybutów i 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 klucz/wartość w JavaScript zawierająca nagłówki HTTP.

getResponseCode()

Pobierz kod stanu HTTP (200 w przypadku 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 w przypadku OK).