Web からのリソースの取得

Web 上のリソースを管理する必要がある場合は、以下の UrlFetchApp メソッドを使用します。

単純な GET 要求

Web リソースを取得する必要があるだけの場合は、 fetch(url) を使用してください。

    var response = UrlFetchApp.fetch('https://www.contoso.com');

fetch(url) メソッドは、応答を読み取るメソッドを含む HTTResponse オブジェクトを返します。テキスト応答を読み取るには getContentText メソッドを、バイナリ応答を読み取るには getContent メソッドを使用します。

応答本文に JSON オブジェクトが含まれている場合は、 getContentText を使用して JSON オブジェクトを取得します。 JSON オブジェクト内の個々のフィールドにアクセスするには、 JSON.parse() メソッドを使用して応答を解析します。

    var stock = JSON.parse(response.getContentText());
    Logger.log(`stock symbol: ${stock["symbol"]}`);
    Logger.log(`company: ${stock["companyName"]}`);
    Logger.log(`close price: ${stock["close"]}`);

HTTP エラーの処理

要求が失敗した場合 (たとえば、400 Bad request の場合)、サービスはスクリプトの処理を停止し、ログにエラーメッセージを書き込みます。メッセージには要求の HTTP 状態コードが含まれますが、応答の本文にある可能性があるエラーメッセージは含まれません。

応答本文を取得する必要がある場合は、代わりに fetch(url, params) メソッドを呼び出して、muteHttpExceptions パラメーターを true に設定します。 muteHttpExceptions を true に設定すると、常にスクリプトに制御が戻されます。その後、 getResponseCode() メソッドを呼び出して、要求の成功または失敗を判断し、それに応じて処理する必要があります。

    var response = UrlFetchApp.fetch('https://contoso.com', { muteHttpExceptions: true });    

    if (200 == response.getResponseCode())
    {
        Logger.log('HTTP request succeeded');
    }
    else
    {
        Logger.log('HTTP request failed');
    }

Web リソースの追加、更新、または削除

Web リソースを追加、更新、または削除する必要がある場合は、 fetch(url, params) メソッドを使用します。このメソッドでは、使用する HTTP 動詞、Content-Type ヘッダー、要求に必要なその他のヘッダー、および要求のペイロードを指定できます。これらのパラメーターの詳細については、 UrlFetchParams オブジェクトを参照してください。

次の例では、OAuth アクセストークンを必要とするリソースを取得します。 GET はフェッチメソッドの既定の HTTP 動詞であるため、指定する必要があるパラメーターは headers パラメーターのみです。

    var token = "<the oauth token goes here>";
    var response = UrlFetchApp.fetch('https://contoso.com', { headers: { Authorization: `Bearer ${token}` } });    
    var jsonObject = JSON.parse(response.getContentText());

この例では、JSON ペイロードを含む POST 要求を送信します。ペイロードは JSON オブジェクトであるため、この例では contentType パラメーターを application/json に設定します。

    var myData = {
        'id' : '123abc',
        'name' : 'leg',
        'color' : 'red'
    };

    var options = {
        'method' : 'post',
        'contentType' : 'application/json',
        'payload' : JSON.stringify(myData)
    };

    var response = UrlFetchApp.fetch('https://contoso.com', options);    
    var jsonObject = JSON.parse(response.getContentText());

UrlFetchApp を使用して、OneDrive からデータファイルまたは CSV ファイルを取得します。

OneDrive (https://onedrive.live.com) からファイルを取得するには、Microsoft Graph を使用します。 OneDrive ファイルにアクセスするには、OAuth アクセストークンが必要です。また、アクセストークンを取得するには、更新トークンを持っていない限り、ユーザーの同意が必要です。ただし、スクリプトは UI コンポーネントをサポートしていないため、別の方法で同意を得る必要があります。更新トークンを取得する別の方法がまだない場合は、次の PowerShell スクリプトを実行して同意と更新トークンを取得できます。

$clientId = "your application ID goes here"
 
Start-Process "https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=$clientId&scope=files.read offline_access&response_type=code&redirect_uri=https://login.live.com/oauth20_desktop.srf"
 
$code = Read-Host "Please enter the code"
 
$response = Invoke-WebRequest https://login.microsoftonline.com/common/oauth2/v2.0/token -ContentType application/x-www-form-urlencoded -Method POST -Body "client_id=$clientid&redirect_uri=https://login.live.com/oauth20_desktop.srf&code=$code&grant_type=authorization_code"
 
Write-Output "Refresh token: " ($response.Content | ConvertFrom-Json).refresh_token

PowerShell スクリプトを実行する前に、次の手順に従ってクライアント ID を取得する必要があります。

https://apps.dev.microsoft.comに移動し、[アプリの追加] をクリックします。
スクリプト クライアントなどのアプリ名を入力します。 ([ガイド付きセットアップ] をチェックしないでください。)
[ 作成] をクリックし、アプリケーション ID (クライアント ID) をメモします。
[ Add Platform ]、[ Native Application] の順にクリックします。
[Microsoft Graph の委任されたアクセス許可] で、[追加] をクリックし、[Files] を選択します。読み取りとoffline_access。
[保存] をクリックします。

メモ帳またはお気に入りのエディターを開き、PowerShell スクリプトをエディターにコピーします。 $clientID を、アプリの登録時に受け取ったアプリケーション ID に設定します。

$clientId = "abc123-4d9e-44f1-837d-a7244af50027"

ファイルを保存し、GetTokens.ps1 という名前を付けます (任意の名前を付けることができますが、拡張子は .ps1 にする必要があります)。

次に、コンソールウィンドウを開きます。 Microsoft Windows でコンソールウィンドウを開くには、次の Windows コマンド実行コマンド (<Windows ボタン>+r) を入力します。

cmd.exe

コマンドプロンプトで、GetTokens.ps1 を保存したフォルダーに移動します。次に、次のコマンドを入力します。

powershell.exe -File .\GetTokens.ps1

実行ポリシーエラーが発生した場合は、実行ポリシーを変更する必要があります。実行ポリシー・オプションについては、実行ポリシーについてを参照してください。セッションの実行ポリシーを変更するには、次のコマンドを入力します。

powershell.exe -ExecutionPolicy Bypass -File .\GetTokens.ps1

PowerShell スクリプトが正常に実行されると、ブラウザーセッションが開始され、Microsoft アカウント (MSA) の資格情報を入力します (資格情報が OneDrive ファイルにアクセスできる必要があります)。同意すると、ブラウザーのアドレスバーに許可コードが表示されます (?code={copy this code} を参照してください)。

https://login.live.com/oauth20_desktop.srf?code=M7ab570e5-a1c0-32e5-a946-e4490c822954&lc=1033

許可コード (M7ab570e5-a1c0-32e5-a946-e4490c822954) をコピーし、プロンプトでコンソールウィンドウに入力します。その後、PowerShell スクリプトは更新トークンを返します。スクリプトの更新トークンを使用して、アクセストークンを取得します。更新トークンはパスワードと同様に扱う必要があります。誰かがそれを取得すると、そのユーザーはあなたの OneDrive データにアクセスできます。

更新トークンの有効期間は長いですが、無効になる可能性があります。 invalid_grantエラーが発生した場合、更新トークンは無効になります。同意と新しい更新トークンを取得するには、PowerShell スクリプトをもう一度実行する必要があります。

CSV ファイルをダウンロードする例

次の例では、更新トークンを取得した後、1) 更新トークンを使用してアクセストークンを取得し、2) Microsoft Graph を呼び出して CSV ファイルのダウンロードに使用するダウンロード URL を取得する方法を示しています。 {yourclientid} を登録済みアプリのアプリケーション ID に置き換え、{yourrefreshtoken} を更新トークンに置き換えます。

function main() {
    var clientId = "{yourclientid}";
    var refreshToken = "{yourrefreshtoken}";

    var options = {
        'method' : 'post',
        'contentType' : 'application/x-www-form-urlencoded',
        'payload' : `client_id=${clientId}&redirect_uri=https://login.live.com/oauth20_desktop.srf&refresh_token=${refreshToken}&grant_type=refresh_token`
    };
    
    // Use the refresh token to get the access token.

    var response = UrlFetchApp.fetch('https://login.microsoftonline.com/common/oauth2/v2.0/token', options);
 
    var tokens = JSON.parse(response.getContentText());

    // Get the contents of the CSV file from OneDrive passing the access token in the Authorization header. 
    // Replace the path and file name (/me/drive/root/children/bids.csv) with your path and file name.

    response = UrlFetchApp.fetch('https://graph.microsoft.com/v1.0/me/drive/root/children/bids.csv/content', { headers: { Authorization: `Bearer ${tokens['access_token']}` } });    
 
    // Read and parse the contents of the file. The parseCSV method is a placeholder for 
    // whichever method you provide to parse the file.

    var file = response.getContentText();
    var data = parseCSV(file);
}

CSV ファイルを解析する

CSV 解析ツールは組み込まれていないため、自分で作成するか、オンラインで探す必要があります。たとえば、オンラインで簡単に検索すると、Stack Overflow でこれが見つかりました。オンラインで見つけた場合は、使用制限がないことを確認してください。

Google サービスへのアクセス

UrlFetchApp を使用して Google サービスにアクセスする方法については、「Google サービスの呼び出し」を参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-09-11