URL Fetch Service

URL Fetch

Mit diesem Dienst können Skripts auf andere Ressourcen im Web zugreifen, indem sie URLs abrufen. Ein Skript kann mit dem UrlFetch-Dienst HTTP- und HTTPS-Anfragen senden und Antworten empfangen. Der UrlFetch-Dienst nutzt die Netzwerkinfrastruktur von Google, um die Effizienz und Skalierbarkeit zu verbessern.

Anfragen, die über diesen Dienst gestellt werden, stammen aus einem bestimmten Pool von IP-Bereichen. Die vollständige Liste der IP-Adressen finden Sie, wenn Sie diese Anfragen auf die Zulassungsliste setzen oder genehmigen müssen.

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 Bereich https://www.googleapis.com/auth/script.external_request erforderlich. In den meisten Fällen erkennt Apps Script automatisch die Bereiche, die ein Skript benötigt, und fügt sie hinzu. Wenn Sie jedoch Ihre Bereiche explizit festlegen, müssen Sie diesen Bereich manuell hinzufügen, um UrlFetchApp verwenden zu können.

Weitere Informationen

• HTTPResponse
• Explizite Bereiche festlegen

Klassen

Name	Kurzbeschreibung
HTTPResponse	Mit dieser Klasse können Nutzer auf bestimmte Informationen zu HTTP-Antworten zugreifen.
UrlFetchApp	Ressourcen abrufen und über das Internet mit anderen Hosts kommunizieren.

HTTPResponse

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getAllHeaders()	Object	Gibt eine Attribut-/Wertzuordnung von Headern für die HTTP-Antwort zurück. Header mit mehreren Werten werden als Arrays zurückgegeben.
getAs(contentType)	Blob	Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()	Blob	Gibt die Daten in diesem Objekt als Blob zurück.
getContent()	Byte[]	Ruft den binären Rohinhalt einer HTTP-Antwort ab.
getContentText()	String	Ruft den Inhalt einer HTTP-Antwort als String ab.
getContentText(charset)	String	Gibt den Inhalt einer HTTP-Antwort zurück, die als String des angegebenen Zeichensatzes codiert ist.
getHeaders()	Object	Gibt eine Attribut-/Wertzuordnung von Headern für die HTTP-Antwort zurück.
getResponseCode()	Integer	Ruft den HTTP-Statuscode (200 für OK usw.) einer HTTP-Antwort ab.

UrlFetchApp

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
fetch(url)	HTTPResponse	Stellt eine Anfrage zum Abrufen einer URL.
fetch(url, params)	HTTPResponse	Stellt eine Anfrage zum Abrufen einer URL mit optionalen erweiterten Parametern.
fetchAll(requests)	HTTPResponse[]	Es werden mehrere Anfragen gesendet, um mehrere URLs mit optionalen erweiterten Parametern abzurufen.
getRequest(url)	Object	Gibt die Anfrage zurück, die gestellt wird, wenn der Vorgang aufgerufen wurde.
getRequest(url, params)	Object	Gibt die Anfrage zurück, die gestellt würde, wenn der Vorgang aufgerufen würde.