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

コーディング レベル: 初級
所要時間: 5 分
プロジェクト タイプ: 時間主導型トリガーによる自動化

目標

  • ソリューションの機能を理解します。
  • ソリューション内で Apps Script サービスが何を行うかを理解します。
  • スクリプトを設定します。
  • スクリプトを実行します。

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

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

株価と Gmail のメール アラートが表示された Google スプレッドシートのスクリーンショット。

仕組み

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

Apps Script サービス

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

前提条件

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

  • 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
// 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 が管理しています。

次のステップ