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 d'évolutivité.

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.

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 portées dont un script a besoin, mais si vous définissez vos portées explicitement, vous devez ajouter manuellement cette portée pour utiliser UrlFetchApp.

Voir aussi

Classes

NomBrève description
HTTPResponseCette classe permet aux utilisateurs d'accéder à des informations spécifiques sur les réponses HTTP.
UrlFetchAppRécupérez des ressources et communiquez avec d'autres hôtes via Internet.

HTTPResponse

Méthodes

MéthodeType renvoyéBrève description
getAllHeaders()ObjectRenvoie un mappage attribut/valeur des en-têtes pour la réponse HTTP, avec des en-têtes dont plusieurs valeurs sont renvoyées sous forme de tableaux.
getAs(contentType)BlobRenvoie les données de cet objet sous forme de blob converti au type de contenu spécifié.
getBlob()BlobRenvoyez les données de cet objet sous la forme d'un objet blob.
getContent()Byte[]Récupère le contenu binaire brut d'une réponse HTTP.
getContentText()StringRécupère le contenu d'une réponse HTTP encodée en tant que chaîne.
getContentText(charset)StringRenvoie le contenu d'une réponse HTTP encodé sous forme de chaîne du jeu de caractères donné.
getHeaders()ObjectRenvoie un mappage attribut/valeur des en-têtes pour la réponse HTTP.
getResponseCode()IntegerObtenez le code d'état HTTP (200 pour "OK", etc.) d'une réponse HTTP.

UrlFetchApp

Méthodes

MéthodeType renvoyéBrève description
fetch(url)HTTPResponseEnvoie une requête pour récupérer une URL.
fetch(url, params)HTTPResponseEnvoie une requête pour extraire une URL à l'aide de paramètres avancés facultatifs.
fetchAll(requests)HTTPResponse[]Effectue plusieurs requêtes pour extraire plusieurs URL à l'aide de paramètres avancés facultatifs.
getRequest(url)ObjectRenvoie la requête effectuée si l'opération a été appelée.
getRequest(url, params)ObjectRenvoie la requête effectuée si l'opération a été appelée.