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-/Wertzuordnung 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, das in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getContent()Byte[]Ruft den binären Rohinhalt einer HTTP-Antwort ab.
getContentText()StringRuft den Inhalt einer HTTP-Antwort als String ab.
getContentText(charset)StringGibt den Inhalt einer HTTP-Antwort zurück, die als String des angegebenen Zeichensatzes codiert ist.
getHeaders()ObjectGibt eine Attribut-/Wertzuordnung von Headern für die HTTP-Antwort zurück.
getResponseCode()IntegerRuft den HTTP-Statuscode (200 für OK usw.) einer HTTP-Antwort ab.

Detaillierte Dokumentation

getAllHeaders()

Gibt eine Attribut-/Wertzuordnung 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, das in den angegebenen Inhaltstyp konvertiert wurde. Bei dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. „meine_datei.pdf“. Dabei wird jedoch davon ausgegangen, dass der Teil des Dateinamens, der auf den letzten Punkt folgt (falls vorhanden), eine vorhandene Erweiterung ist, die ersetzt werden soll. Folglich wird aus „ShoppingList.12.25.2014“ „ShoppingList.12.25.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. Für Bilder im BMP-, GIF-, JPEG- oder PNG-Format sind auch 'image/bmp', 'image/gif', 'image/jpeg' oder 'image/png' gültig. Für ein Google Docs-Dokument ist auch 'text/markdown' gültig.

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 binären Rohinhalt 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 binäres Roh-Array

getContentText()

Ruft den Inhalt einer HTTP-Antwort als String ab. 

// 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 den Zeichensatz darstellt, der für die Codierung des Inhalts der HTTP-Antwort verwendet werden soll

Rückflug

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

getHeaders()

Gibt eine Attribut-/Wertzuordnung 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 (200 für OK usw.) 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: Der HTTP-Antwortcode (z. B. 200 für „OK“).