Bài viết/Nhà phát triển

Tạo bảng theo dõi danh mục vàng trong Google Sheets

Nhập mẫu danh mục vàng vào Google Sheets, cập nhật một mức giá tham chiếu và tính giá trị ước tính, chi phí cùng mức thay đổi cho từng khoản nắm giữ.

Nhà phát triển

Nếu bạn nắm giữ vàng miếng, tiền vàng hoặc trang sức, chỉ một con số tổng sẽ khó kiểm tra. Mẫu này dành một hàng cho mỗi khoản nắm giữ, tách chi phí mua khỏi giá trị tham chiếu theo giá giao ngay và hiển thị thời điểm của mức giá được dùng. Đây là công cụ tính giá trị tham khảo, không phải bản thẩm định hoặc cam kết giá mua lại.

Tải xuống và nhập mẫu

Tải bảng theo dõi danh mục vàng. Trong Google Drive, chọn New → File upload, mở tệp .xlsx, sau đó chọn File → Save as Google Sheets. Hướng dẫn của Google về việc mở và tải tệp bảng tính có tại: https://support.google.com/docs/answer/49114.

Sổ tính có ba trang:

  • Portfolio để nhập các khoản nắm giữ và xem tổng hợp.
  • Price Data để lưu tiền tệ, endpoint, thời điểm và giá 24K dùng trong công thức.
  • Read me để giải thích giả định và giới hạn.

Tên trang và tên cột giữ nguyên tiếng Anh để khớp với tệp, công thức và hướng dẫn.

Nhập các khoản nắm giữ

Trong Portfolio, thay ba hàng mẫu bằng dữ liệu của bạn. Mỗi hàng là một khoản nắm giữ hoặc một nhóm vật phẩm giống nhau.

CộtNội dung cần nhập
HoldingNhãn như 1 oz bar hoặc 18K ring
Unitgrams hoặc troy oz
QuantitySố lượng đo được
Purity99.9%, 75% cho 18K, hoặc độ tinh khiết đã xác nhận
Purchase costTổng chi phí bằng cùng loại tiền trong Price Data
Purchase dateNgày mua hoặc ngày ghi nhận
NotesGhi chú tùy chọn về người bán hoặc hóa đơn

Hãy dùng một loại tiền cho tất cả chi phí. Mẫu chuyển ounce troy theo 31.1034768 gram và vẫn hiển thị số lượng ban đầu để bạn kiểm tra.

Cập nhật giá tham chiếu

Endpoint của mẫu là:

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

Phản hồi có price_gram_24k, timestampcurrency. Sao chép giá 24K dạng số vào Price Data → B6, thời điểm phản hồi vào B5 và loại tiền của báo giá vào B7, rồi cập nhật cả ba từ cùng một phản hồi. Nếu dùng loại tiền khác được hỗ trợ, hãy lấy báo giá mới trước khi đổi B3 và bảo đảm chi phí mua dùng cùng loại tiền. Không biến báo giá USD cũ thành IDR chỉ bằng cách đổi B3. Các trường giá trong JSON là chuỗi thập phân; trong bảng tính, hãy nhập chúng dưới dạng số để công thức tính được.

Tệp tải xuống có dữ liệu mẫu được đánh dấu rõ để công thức hiển thị kết quả ngay sau khi nhập. Hãy thay giá mẫu trước khi sử dụng kết quả. Sổ tính không tự gọi API và không lưu API key. Nếu một sổ tính dùng chung cần xác thực, hãy dùng proxy máy chủ; không đặt thông tin đăng nhập trong bảng hoặc bound script mà biên tập viên khác có thể kiểm tra.

Cập nhật thủ công bằng một lần nhấp

Để thêm menu cập nhật, tải Apps Script đi kèm, mở sổ tính trong Google Sheets, chọn Extensions → Apps Script, xóa mã ban đầu và dán nội dung tệp. Lưu rồi tải lại bảng tính. Menu Gold portfolio → Refresh price data gửi đúng một yêu cầu không cần khóa, dùng loại tiền trong Price Data → B3. Script kiểm tra trạng thái HTTP, loại tiền trong phản hồi, price_gram_24k dương và hữu hạn, cùng timestamp trước khi ghi B5:B7 cùng lúc. Nếu lỗi, giá, thời điểm và loại tiền trước đó được giữ nguyên. Nếu dán thủ công, hãy cập nhật B5, B6B7 từ cùng một phản hồi. Script không tạo bộ hẹn giờ và không polling nền.

Công thức hoạt động thế nào

Mỗi hàng có bốn bước rõ ràng:

  1. Weight (g) chuyển số lượng thành gram.
  2. Spot price/g liên kết với giá 24K trong Price Data.
  3. Indicative value tính Weight (g) × Purity × Spot price/g.
  4. Change tính Indicative value − Purchase cost.

Ví dụ, 10 gram vàng 75% với giá 24K là 128.24 mỗi gram cho kết quả 10 × 0.75 × 128.24 = 961.80 theo loại tiền của giá. Đây là giá trị hàm lượng vàng theo giá giao ngay tham chiếu; chưa bao gồm công chế tác, đá quý, thuế, phí chênh lệch của người bán hoặc chiết khấu mua lại.

Phần tổng hợp đếm số hàng có số lượng, cộng tổng trọng lượng đã chuyển đổi, chi phí mua, giá trị ước tính và mức thay đổi. Hàng trống vẫn để trống trong các cột tính toán.

Lưu thời điểm cùng với giá

Giá giao ngay thay đổi. Price timestamp (UTC) cho biết phản hồi nào được dùng. Khi cập nhật giá, hãy cập nhật thời điểm cùng lúc. Nếu lưu sổ tính làm báo cáo, giữ phản hồi gốc hoặc ghi thời điểm để có thể lặp lại phép tính.

Lỗi thường gặp và giới hạn

Đừng nhập 0.999 dưới dạng văn bản thay cho 99.9%; đừng trộn chi phí USD với giá IDR và đừng nhầm gram với ounce troy. Change không phải lợi nhuận được bảo đảm vì chưa trừ chi phí bán. Mẫu này không phải bản thẩm định, sổ kế toán, tờ khai thuế, lời khuyên đầu tư hay giá bán được bảo đảm. Hãy kiểm tra quy định địa phương và báo giá thực tế trước quyết định tài chính.

Xem hướng dẫn Gold Price API cho Google Sheets để lấy giá vàng hiện tại và lịch sử trong bảng tính.

hướng dẫn liên quan

goldprice.dev

Giá vàng trực tiếp, dữ liệu OHLC lịch sử và tổng hợp nhiều nguồn qua REST và SSE.