このサービスを使用すると、スクリプトは 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 | オペレーションが呼び出された場合に行われたリクエストを返します。 |