値下げアラートを受け取る

コーディング レベル: 初級
所要時間: 5 分
プロジェクトの種類: 時間ベースのトリガーを使用した自動化

目標

• ソリューションの機能について理解する。
• ソリューション内での Apps Script サービスの役割を理解する。
• スクリプトを設定します。
• スクリプトを実行します。

このソリューションについて

株式を購入して価値が下がった場合は、その株式を売却して別の株式を購入し、税額控除を申請できます。これは、税金の損失を回収する方法として知られています。Google スプレッドシートのスプレッドシートに株式をリストし、株価が購入価格を下回った場合にメール通知を受け取ります。

仕組み

このスプレッドシートでは、スプレッドシートの Google ファイナンスの組み込み関数を使用して、株式の現在の価格を取得しています。このスクリプトは、各上場株式の購入価格と現在の価格を比較します。購入価格を下回った株式のリストがメールで送信されます。スクリプトは、任意の頻度で実行するように設定できます。

Apps Script サービス

このソリューションでは、次のサービスを使用します。

• スプレッドシート サービス - 上場されている各株式をループし、株式価格と購入価格を比較します。
• Gmail サービス - 購入価格を下回った株式のメールを作成し、送信します。

前提条件

このサンプルを使用するには、次の前提条件を満たしている必要があります。

• Google アカウント（Google Workspace アカウントの場合、管理者の承認が必要となる可能性があります）。
• インターネットに接続できるウェブブラウザ。

スクリプトを設定する

1. 次のボタンをクリックして、税金損失の回収アラートのサンプル スプレッドシートのコピーを作成します。このソリューションの Apps Script プロジェクトがスプレッドシートに添付されています。
   コピーを作成
2. コピーしたスプレッドシートで、独自の在庫情報を使用してシートを更新するか、提供されたテストデータを使用します。

スクリプトを実行する

1. コピーしたスプレッドシートで、[拡張機能] > [Apps Script] をクリックします。
2. 関数のプルダウンで [checkLosses] を選択します。
3. [実行] をクリックします。

4. プロンプトが表示されたら、スクリプトを承認します。OAuth 同意画面に [このアプリは確認されていません] という警告が表示された場合は、[詳細] > [{プロジェクト名} に移動（安全でない）] を選択して続行します。

5. 購入価格を下回った株式のリストがメールで届きます。メールが届かない場合は、リスト内の株価が購入価格を下回っていないか確認します。

時間ベースのトリガーを作成する

1. スクリプト プロジェクトに戻ります。
2. 左側の [トリガー] をクリックします。
3. 右下の [トリガーを追加] をクリックします。
4. [実行する関数を選択] で、[checkLosses] が選択されていることを確認します。
5. [イベントのソースを選択] で [時間主導型] を選択します。
6. スクリプトを実行する頻度を設定し、[保存] をクリックします。

コードを確認する

このソリューションの Apps Script コードを確認するには、下の [ソースコードを表示] をクリックします。

ソースコードを表示

コード.gs

solutions/automations/tax-loss-harvest-alerts/Code.js

GitHub で表示

// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/automations/tax-loss-harvest-alerts

/*
Copyright 2022 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

/** 
* Checks for losses in the sheet.
*/
function checkLosses() {
  // Pulls data from the spreadsheet
  let sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(
    "Calculations"
  );
  let source = sheet.getRange("A:G");
  let data = source.getValues();

  //Prepares the email alert content
  let message = "Stocks: <br><br>";

  let send_message = false;

  console.log("starting loop");

  //Loops through the cells in the spreadsheet to find cells where the stock fell below purchase price
  let n = 0;
  for (let i in data) {
    //Skips the first row
    if (n++ == 0) continue;

    //Loads the current row
    let row = data[i];

    console.log(row[1]);
    console.log(row[6]);

    //Once at the end of the list, exits the loop
    if (row[1] == "") break;

    //If value is below purchase price, adds stock ticker and difference to list of tax loss opportunities
    if (row[6] < 0) {
      message +=
        row[1] +
        ": " +
        (parseFloat(row[6].toString()) * 100).toFixed(2).toString() +
        "%<br>";
      send_message = true;
    }
  }
  if (!send_message) return;

  MailApp.sendEmail({
    to: SpreadsheetApp.getActiveSpreadsheet().getOwner().getEmail(),
    subject: "Tax-loss harvest",
    htmlBody: message,

  });
}

寄稿者

このサンプルは、プロダクト管理およびプラットフォーム戦略コンサルタントの Jeremy Glassenberg によって作成されました。Jeremy の Twitter アカウントは @jglassenberg です。

このサンプルは、Google デベロッパー エキスパートの協力を得て Google によって管理されています。

次のステップ

• 時間ドリブンのトリガー
• Google スプレッドシートを拡張する