URL Fetch Service

URL 取得

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

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

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

関連ドキュメント

クラス

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

HTTPResponse

Methods

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

UrlFetchApp

Methods

方法戻り値の型概要
fetch(url)HTTPResponseURL を取得するリクエストを送信します。
fetch(url, params)HTTPResponse任意の詳細パラメータを使用して、URL を取得するリクエストを送信します。
fetchAll(requests)HTTPResponse[]任意の詳細パラメータを使用して、複数の URL を取得する複数のリクエストを実行します。
getRequest(url)Objectオペレーションが呼び出されたときに発行されるリクエストを返します。
getRequest(url, params)Objectオペレーションが呼び出されたときに行われるリクエストを返します。