Class HTTPResponse

HTTPResponse

Mit dieser Klasse können Nutzer auf bestimmte Informationen zu HTTP-Antworten zugreifen.

Weitere Informationen

Methoden

MethodeRückgabetypKurzbeschreibung
getAllHeaders()ObjectGibt eine Attribut/Wert-Zuordnung von Headern für die HTTP-Antwort zurück. Header mit mehreren Werten werden als Arrays zurückgegeben.
getAs(contentType)BlobGibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getContent()Byte[]Ruft den Rohbinärinhalt einer HTTP-Antwort ab.
getContentText()StringRuft den Inhalt einer HTTP-Antwort ab, die als String codiert ist.
getContentText(charset)StringGibt den Inhalt einer HTTP-Antwort zurück, die als String des angegebenen Zeichensatzes codiert ist.
getHeaders()ObjectGibt eine Attribut/Wert-Zuordnung von Headern für die HTTP-Antwort zurück.
getResponseCode()IntegerRuft den HTTP-Statuscode (z. B. 200 für „OK“) einer HTTP-Antwort ab.

Detaillierte Dokumentation

getAllHeaders()

Gibt eine Attribut/Wert-Zuordnung von Headern für die HTTP-Antwort zurück. Header mit mehreren Werten werden als Arrays zurückgegeben.

// 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());

Rückflug

Object – eine JavaScript-Schlüssel/Wert-Zuordnung von HTTP-Headern


getAs(contentType)

Gibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meinedatei.pdf“. Es wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt (falls vorhanden) folgt, eine vorhandene Erweiterung ist, die ersetzt werden soll. Daraus wird „Einkaufsliste.25.12.2014“ zu „Einkaufsliste.25.12.pdf“.

Die täglichen Kontingente für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.

Parameter

NameTypBeschreibung
contentTypeStringDer MIME-Typ, in den konvertiert werden soll. Für die meisten Blobs ist 'application/pdf' die einzige gültige Option. Bei Bildern im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' zulässig. Für ein Google Docs-Dokument ist auch 'text/markdown' zulässig.

Rückflug

Blob – Die Daten als Blob.


getBlob()

Gibt die Daten in diesem Objekt als Blob zurück.

Rückflug

Blob – Die Daten als Blob.


getContent()

Ruft den Rohbinärinhalt einer HTTP-Antwort ab.

// 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]);

Rückflug

Byte[] – der Inhalt als rohes Binärarray


getContentText()

Ruft den Inhalt einer HTTP-Antwort ab, die als String codiert ist.

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

Rückflug

String: Der Inhalt der HTTP-Antwort als String


getContentText(charset)

Gibt den Inhalt einer HTTP-Antwort zurück, die als String des angegebenen Zeichensatzes codiert ist.

// 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'));

Parameter

NameTypBeschreibung
charsetStringEin String, der das Charset darstellt, das für die Codierung des HTTP-Antwortinhalts verwendet werden soll

Rückflug

String: Der Inhalt der HTTP-Antwort, codiert mit dem angegebenen Zeichensatz


getHeaders()

Gibt eine Attribut/Wert-Zuordnung von Headern für die HTTP-Antwort zurück.

// 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());

Rückflug

Object – eine JavaScript-Schlüssel/Wert-Zuordnung von HTTP-Headern


getResponseCode()

Ruft den HTTP-Statuscode (z. B. 200 für „OK“) einer HTTP-Antwort ab.

// 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());

Rückflug

Integer: HTTP-Antwortcode (z.B. 200 für „OK“)