このサービスを使用すると、スクリプトは 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() | String | HTTP レスポンスのコンテンツを文字列としてエンコードして取得します。 |
getContentText(charset) | String | 指定された文字セットの文字列としてエンコードされた HTTP レスポンスの内容を返します。 |
getHeaders() | Object | HTTP レスポンスのヘッダーの属性と値のマッピングを返します。 |
getResponseCode() | Integer | HTTP レスポンスの HTTP ステータス コード（OK の場合は 200）を取得します。 |
UrlFetchApp
Methods
| 方法 | 戻り値の型 | 概要 |
|---|---|---|
fetch(url) | HTTPResponse | URL を取得するリクエストを送信します。 |
fetch(url, params) | HTTPResponse | 任意の詳細パラメータを使用して、URL を取得するリクエストを送信します。 |
fetchAll(requests) | HTTPResponse[] | 任意の詳細パラメータを使用して、複数の URL を取得する複数のリクエストを実行します。 |
getRequest(url) | Object | オペレーションが呼び出されたときに発行されるリクエストを返します。 |
getRequest(url, params) | Object | オペレーションが呼び出されたときに行われるリクエストを返します。 |