Mit diesem Dienst können Skripts auf andere Ressourcen im Web zugreifen, indem sie URLs abrufen. Ein Skript kann den UrlFetch-Dienst verwenden, um HTTP- und HTTPS-Anfragen zu senden und Antworten zu erhalten. Aus Gründen der Effizienz und Skalierung nutzt der UrlFetch-Dienst die Netzwerkinfrastruktur von Google.
Anfragen über diesen Dienst stammen aus einem festgelegten Pool von IP-Bereichen. Sie können die vollständige Liste der IP-Adressen aufrufen, wenn Sie diese Anfragen auf die Zulassungsliste setzen oder genehmigen müssen.
Für diesen Dienst ist der Bereich https://www.googleapis.com/auth/script.external_request erforderlich. In den meisten Fällen erkennt Apps Script 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 zu verwenden.
Weitere Informationen
Kurse
| Name | Kurzbeschreibung |
|---|---|
HTTPResponse | Mit dieser Klasse können Nutzer auf bestimmte Informationen zu HTTP-Antworten zugreifen. |
UrlFetchApp | Ressourcen abrufen und mit anderen Hosts über das Internet kommunizieren |
HTTPResponse
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
getAllHeaders() | Object | Gibt eine Attribut-/Wertzuordnung von Headern für die HTTP-Antwort zurück, wobei Header mit mehreren Werten als Arrays zurückgegeben werden. |
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 codiert ab. |
getContentText(charset) | String | Gibt den Inhalt einer HTTP-Antwort zurück, codiert als String des angegebenen Zeichensatzes. |
getHeaders() | Object | Gibt eine Attribut-/Wertezuordnung von Headern für die HTTP-Antwort zurück. |
getResponseCode() | Integer | HTTP-Statuscode (200 für OK usw.) einer HTTP-Antwort abrufen. |
UrlFetchApp
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
fetch(url) | HTTPResponse | Sendet eine Anfrage zum Abrufen einer URL. |
fetch(url, params) | HTTPResponse | Sendet eine Anfrage zum Abrufen einer URL mithilfe optionaler erweiterter Parameter. |
fetchAll(requests) | HTTPResponse[] | Sendet mehrere Anfragen zum Abrufen mehrerer URLs mit optionalen erweiterten Parametern. |
getRequest(url) | Object | Gibt die Anfrage zurück, die gestellt wurde, wenn der Vorgang aufgerufen wurde. |
getRequest(url, params) | Object | Gibt die Anfrage zurück, die gestellt wird, wenn der Vorgang aufgerufen wurde. |