URL Fetch Service

URL Fetch

このサービスを使用すると、スクリプトは URL を取得してウェブ上の他のリソースにアクセスできます。スクリプトは、UrlFetch サービスを使用して HTTP と HTTPS リクエストを送信し、レスポンスを受信できます。UrlFetch サービスは、効率とスケーリングのために Google のネットワーク インフラストラクチャを使用します。

このサービスを使用して行われたリクエストは、設定された IP 範囲のプールから送信されます。これらのリクエストをホワイトリストに登録または承認する必要がある場合は、IP アドレスの完全なリストを検索できます。

UrlFetch サービス リクエストのデフォルトのユーザー エージェント文字列は Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID) です。

このサービスには https://www.googleapis.com/auth/script.external_request スコープが必要です。ほとんどの場合、Apps Script はスクリプトに必要なスコープを自動的に検出して含めますが、スコープを明示的に設定している場合は、UrlFetchApp を使用するためにこのスコープを手動で追加する必要があります。

関連情報

• HTTPResponse
• 明示的なスコープの設定

クラス

名前	概要
HTTPResponse	このクラスを使用すると、ユーザーは HTTP レスポンスに関する特定の情報にアクセスできます。
UrlFetchApp	リソースを取得し、インターネット経由で他のホストと通信します。

HTTPResponse

メソッド

メソッド	戻り値の型	概要
getAllHeaders()	Object	HTTP レスポンスのヘッダーの属性と値のマップを返します。複数の値を持つヘッダーは配列として返されます。
getAs(contentType)	Blob	このオブジェクト内のデータを、指定されたコンテンツ タイプに変換された Blob として返します。
getBlob()	Blob	このオブジェクト内のデータを blob として返します。
getContent()	Byte[]	HTTP レスポンスの未加工のバイナリ コンテンツを取得します。
getContentText()	String	文字列としてエンコードされた HTTP レスポンスのコンテンツを取得します。
getContentText(charset)	String	指定された文字セットの文字列としてエンコードされた HTTP レスポンスのコンテンツを返します。
getHeaders()	Object	HTTP レスポンスのヘッダーの属性/値マップを返します。
getResponseCode()	Integer	HTTP レスポンスの HTTP ステータス コード（OK の場合は 200 など）を取得します。

UrlFetchApp

メソッド

メソッド	戻り値の型	概要
fetch(url)	HTTPResponse	URL を取得するリクエストを行います。
fetch(url, params)	HTTPResponse	オプションの高度なパラメータを使用して URL を取得するリクエストを行います。
fetchAll(requests)	HTTPResponse[]	オプションの詳細パラメータを使用して、複数の URL を取得するリクエストを複数行います。
getRequest(url)	Object	オペレーションが呼び出された場合に作成されるリクエストを返します。
getRequest(url, params)	Object	オペレーションが呼び出された場合に作成されるリクエストを返します。