URL Fetch Service

URL フェッチ

このサービスを使用すると、スクリプトは 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 スコープが必要です。ほとんどの場合、スクリプトに必要なスコープは自動的に検出され、含まれますが、スコープを明示的に設定している場合は、UrlFetchApp を使用するにはこのスコープを手動で追加する必要があります。

関連情報

クラス

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

HTTPResponse

メソッド

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

UrlFetchApp

メソッド

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