إنشاء متتبع لمحفظة الذهب في 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 استبدل الصفوف الثلاثة التجريبية ببياناتك. يمثل كل صف حيازة واحدة أو مجموعة من القطع المتطابقة.

استخدم عملة واحدة لكل التكاليف. يحول القالب الأونصة الترويسية باستخدام 31.1034768 غراماً مع إبقاء الكمية الأصلية ظاهرة للتحقق من التحويل.

حدّث السعر المرجعي

نقطة النهاية المستخدمة في القالب هي:

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

تتضمن الاستجابة price_gram_24k وtimestamp وcurrency. انسخ سعر 24K الرقمي إلى Price Data → B6، والطابع الزمني إلى B5، وعملة التسعير المطابقة إلى B7، وحدّث الخلايا الثلاث معاً. غيّر B3 فقط عند حصولك على عرض جديد بتلك العملة، وتأكد من أن تكاليف الشراء تستخدم العملة نفسها. لا تغيّر تسمية عرض USD قديم إلى IDR بتغيير B3 وحده. تصل حقول السعر في 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 بسعر 24K في Price Data.
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.