URL Fetch Service

Récupération d'URL

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 envoyer 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 mise à l'échelle.

Les requêtes effectuées à l'aide de ce service proviennent d'un pool fixe de plages d'adresses IP. Vous pouvez consulter la liste complète des adresses IP si vous devez mettre ces requêtes sur liste blanche ou les approuver.

La chaîne user-agent par défaut des requêtes du service UrlFetch est Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).

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 autorisations dont un script a besoin. Toutefois, si vous définissez vos autorisations de manière explicite, vous devez ajouter manuellement cette autorisation pour utiliser UrlFetchApp.

Voir aussi

• HTTPResponse
• Définir des niveaux d'accès explicites

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érer des ressources et communiquer avec d'autres hôtes sur Internet

HTTPResponse

Méthodes

Méthode	Type renvoyé	Brève description
getAllHeaders()	Object	Renvoie un mappage attribut/valeur des en-têtes pour la réponse HTTP, avec les en-têtes comportant plusieurs valeurs renvoyées sous forme de tableaux.
getAs(contentType)	Blob	Renvoie les données de cet objet sous forme de blob converti au type de contenu spécifié.
getBlob()	Blob	Renvoie les données de cet objet sous forme de blob.
getContent()	Byte[]	Obtient le contenu binaire brut d'une réponse HTTP.
getContentText()	String	Obtient 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 forme de chaîne du jeu de caractères donné.
getHeaders()	Object	Renvoie un mappage attribut/valeur des 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[]	Effectue 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 était appelée.