URL Fetch Service

Recupero URL

Questo servizio consente agli script di accedere ad altre risorse sul web recuperando gli URL. Uno script può utilizzare il servizio UrlFetch per inviare richieste HTTP e HTTPS e ricevere risposte. Il servizio UrlFetch utilizza l'infrastruttura di rete di Google per motivi di efficienza e scalabilità.

Le richieste effettuate utilizzando questo servizio provengono da un pool di intervalli IP impostato. Puoi consultare l'elenco completo degli indirizzi IP se devi inserire nella whitelist o approvare queste richieste.

La stringa dello user agent predefinita delle richieste di servizio UrlFetch è Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID).

Questo servizio richiede l'ambito https://www.googleapis.com/auth/script.external_request. Nella maggior parte dei casi, Apps Script rileva e include automaticamente gli ambiti di cui uno script ha bisogno, ma se imposti gli ambiti in modo esplicito, devi aggiungere manualmente questo ambito per utilizzare UrlFetchApp.

Vedi anche

• HTTPResponse
• Impostazione di ambiti espliciti

Corsi

Nome	Breve descrizione
HTTPResponse	Questa classe consente agli utenti di accedere a informazioni specifiche sulle risposte HTTP.
UrlFetchApp	Recuperare risorse e comunicare con altri host su internet.

HTTPResponse

Metodi

Metodo	Tipo restituito	Breve descrizione
getAllHeaders()	Object	Restituisce una mappa attributo/valore delle intestazioni per la risposta HTTP, con le intestazioni che hanno più valori restituiti come array.
getAs(contentType)	Blob	Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuti specificato.
getBlob()	Blob	Restituisce i dati all'interno di questo oggetto come blob.
getContent()	Byte[]	Recupera i contenuti binari non elaborati di una risposta HTTP.
getContentText()	String	Recupera i contenuti di una risposta HTTP codificati come stringa.
getContentText(charset)	String	Restituisce il contenuto di una risposta HTTP codificata come stringa del set di caratteri specificato.
getHeaders()	Object	Restituisce una mappa attributo/valore delle intestazioni per la risposta HTTP.
getResponseCode()	Integer	Recupera il codice di stato HTTP (200 per OK e così via) di una risposta HTTP.

UrlFetchApp

Metodi

Metodo	Tipo restituito	Breve descrizione
fetch(url)	HTTPResponse	Invia una richiesta per recuperare un URL.
fetch(url, params)	HTTPResponse	Invia una richiesta per recuperare un URL utilizzando parametri avanzati facoltativi.
fetchAll(requests)	HTTPResponse[]	Esegue più richieste per recuperare più URL utilizzando parametri avanzati facoltativi.
getRequest(url)	Object	Restituisce la richiesta effettuata se l'operazione è stata richiamata.
getRequest(url, params)	Object	Restituisce la richiesta effettuata se l'operazione fosse stata richiamata.