Ce service permet aux scripts d'accéder à d'autres ressources sur le Web en récupérant des URL. Un script peut utiliser le service UrlFetch pour émettre des requêtes HTTP et HTTPS, et recevoir des réponses. Le service UrlFetch utilise l'infrastructure réseau de Google à des fins d'efficacité et de scaling.
Les requêtes effectuées à l'aide de ce service proviennent d'un pool défini de plages d'adresses IP. Vous pouvez consulter la liste complète des adresses IP si vous devez ajouter ces requêtes à la liste blanche ou les approuver.
Ce service nécessite le champ d'application https://www.googleapis.com/auth/script.external_request. Dans la plupart des cas, Apps Script détecte et inclut automatiquement les champs d'application dont un script a besoin. Toutefois, si vous définissez explicitement vos champs d'application, vous devez ajouter manuellement ce champ d'application pour utiliser UrlFetchApp.
Voir aussi
Classes
| Nom | Brève description |
|---|---|
HTTPResponse | Cette classe permet aux utilisateurs d'accéder à des informations spécifiques sur les réponses HTTP. |
UrlFetchApp | Récupérez des ressources et communiquez avec d'autres hôtes sur Internet. |
HTTPResponse
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
getAllHeaders() | Object | Renvoie un mappage d'attributs/valeurs d'en-têtes pour la réponse HTTP, les en-têtes avec plusieurs valeurs renvoyées sous forme de tableaux. |
getAs(contentType) | Blob | Renvoyez les données de cet objet en tant qu'objet blob converti au type de contenu spécifié. |
getBlob() | Blob | Renvoyez les données de cet objet en tant que blob. |
getContent() | Byte[] | Récupère le contenu binaire brut d'une réponse HTTP. |
getContentText() | String | Récupère le contenu d'une réponse HTTP encodée sous forme de chaîne. |
getContentText(charset) | String | Renvoie le contenu d'une réponse HTTP encodée sous la forme d'une chaîne du charset donné. |
getHeaders() | Object | Renvoie un mappage d'attributs/valeurs d'en-têtes pour la réponse HTTP. |
getResponseCode() | Integer | Obtenez le code d'état HTTP (200 pour "OK", etc.) d'une réponse HTTP. |
UrlFetchApp
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
fetch(url) | HTTPResponse | Envoie une requête pour récupérer une URL. |
fetch(url, params) | HTTPResponse | Envoie une requête pour récupérer une URL à l'aide de paramètres avancés facultatifs. |
fetchAll(requests) | HTTPResponse[] | Envoie plusieurs requêtes pour récupérer plusieurs URL à l'aide de paramètres avancés facultatifs. |
getRequest(url) | Object | Renvoie la requête effectuée si l'opération a été appelée. |
getRequest(url, params) | Object | Renvoie la requête effectuée si l'opération a été appelée. |