URL Fetch Service

URL-Abruf

Mit diesem Dienst können Scripts durch Abrufen von URLs auf andere Ressourcen im Web zugreifen. Ein Script kann den UrlFetch-Dienst verwenden, um HTTP- und HTTPS-Anfragen zu senden und Antworten zu empfangen. Der UrlFetch-Dienst nutzt die Netzwerkinfrastruktur von Google aus Effizienz- und Skalierungsgründen.

Anfragen, die über diesen Dienst gesendet werden, stammen aus einem festgelegten Pool von IP-Bereichen. Wenn Sie diese Anfragen auf die Zulassungsliste setzen oder genehmigen möchten, können Sie die vollständige Liste der IP-Adressen aufrufen.

Der Standard-User-Agent-String von UrlFetch-Dienstanfragen ist Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).

Für diesen Dienst ist der Umfang https://www.googleapis.com/auth/script.external_request erforderlich. In den meisten Fällen werden in Apps Script die für ein Script erforderlichen Bereiche automatisch erkannt und eingeschlossen. Wenn Sie Ihre Bereiche jedoch explizit festlegen, müssen Sie diesen Bereich manuell hinzufügen, um UrlFetchApp verwenden zu können.

Weitere Informationen

Klassen

NameKurzbeschreibung
HTTPResponseMit dieser Klasse können Nutzer auf bestimmte Informationen zu HTTP-Antworten zugreifen.
UrlFetchAppRessourcen abrufen und über das Internet mit anderen Hosts kommunizieren.

HTTPResponse

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.

UrlFetchApp

Methoden

MethodeRückgabetypKurzbeschreibung
fetch(url)HTTPResponseStellt eine Anfrage zum Abrufen einer URL.
fetch(url, params)HTTPResponseStellt eine Anfrage zum Abrufen einer URL mit optionalen erweiterten Parametern.
fetchAll(requests)HTTPResponse[]Er führt mithilfe optionaler erweiterter Parameter mehrere Anfragen aus, um mehrere URLs abzurufen.
getRequest(url)ObjectGibt die Anfrage zurück, die gesendet wird, wenn der Vorgang aufgerufen wurde.
getRequest(url, params)ObjectGibt die Anfrage zurück, die gesendet wird, wenn der Vorgang aufgerufen wird.