在 Google Sheets 中制作黄金投资组合追踪表

如果你持有金条、金币或首饰，只看一个总额很难核对。这个模板为每项持仓提供一行，把买入成本与按现货价格计算的参考价值分开，并显示计算所用价格的时间。它用于计算参考值，不是鉴定报告，也不保证回收或出售价格。

下载并导入模板

下载黄金投资组合追踪表。在 Google Drive 中选择 New → File upload，打开 .xlsx 文件，然后选择 File → Save as Google Sheets。Google 的帮助页说明了如何打开和下载电子表格文件：https://support.google.com/docs/answer/49114。

工作簿包含三个工作表：

• Portfolio：输入持仓并查看汇总。
• Price Data：保存货币、接口、时间戳和公式使用的24K价格。
• Read me：说明假设和计算范围。

工作表和列名保留英文，以便与下载文件、公式和说明一致。

输入持仓

在 Portfolio 中替换三行示例。一行可以代表一件持仓，也可以代表条件相同的一组物品。

所有成本使用同一种货币。模板按1金衡盎司等于31.1034768克进行换算，同时保留原始数量，便于检查换算结果。

更新参考价格

模板使用的接口是：

GET https://api.goldprice.dev/v1/carat?currency=USD

响应包括 price_gram_24k、timestamp 和 currency。将24K数值复制到 Price Data → B6，将响应时间复制到 B5，并将对应的报价货币复制到 B7，三者必须来自同一个响应。如果使用其他受支持的货币，请先取得该货币的新报价，再修改 B3，并确认买入成本也使用同一货币。不要只修改 B3 就把旧 USD 报价标成 IDR。JSON 中的价格字段是小数文本；在表格中应输入为数字，公式才能计算。

下载文件包含明确标注的示例数据，所以导入后公式会立即显示结果。使用结果前请替换示例价格。工作簿不会自动调用接口，也不会保存 API 密钥。如果共享工作簿需要身份验证，请使用服务器端代理；不要把凭据放在表格或其他编辑者可以检查的绑定脚本中。

一键手动刷新

如果需要添加刷新菜单，请下载配套 Apps Script，在 Google Sheets 中打开工作簿，选择 Extensions → Apps Script，删除初始代码并粘贴文件内容。保存后重新加载表格。Gold portfolio → Refresh price data 菜单会使用 Price Data → B3 中的货币发送一次无密钥请求。脚本会先验证 HTTP 状态、响应货币、正数且有限的 price_gram_24k 和时间戳，然后同时写入 B5:B7。请求或验证失败时，原来的价格、时间戳和报价货币保持不变。手动粘贴时，也要从同一响应更新 B5、B6 和 B7。脚本不会创建定时器，也不会在后台轮询。

计算方式

每一行按照四个透明步骤计算：

1. Weight (g) 将数量换算为克。
2. Spot price/g 引用 Price Data 中的24K价格。
3. Indicative value 计算 Weight (g) × Purity × Spot price/g。
4. Change 计算 Indicative value − Purchase cost。

例如，10克、纯度75%，24K价格为每克128.24时，结果是 10 × 0.75 × 128.24 = 961.80，单位与价格货币相同。这是按参考现货价格计算的黄金含量价值，不包括加工费、宝石、税费、当地溢价、商家价差或回购折扣。

汇总区域会统计有数量的行数、换算后的总重量、总买入成本、参考现货价值和变动。空白行在计算列中仍保持空白。

保存价格与时间戳

现货价格会变化。汇总中的 Price timestamp (UTC) 表示公式使用的响应时间。更新价格时同时更新时间戳。如果要把工作簿作为报告保存，请保留原始响应或记录时间戳，以便其他人复核计算。

常见错误和限制

不要把0.999作为文本输入，应输入百分比99.9%；不要混用 USD 成本与 IDR 价格，也不要把克和金衡盎司混为一谈。Change不是保证收益，只是未扣除出售成本的现货价格差异。模板不是鉴定、会计记录、税务申报、投资建议或保证的出售价格。实际交易前请核对当地规则和商家报价。

如需在表格中读取实时和历史金价，请查看 Gold Price API 的 Google Sheets 教程。