لديك أسئلة أو مشكلات؟ اكتب في GitHub Discussions.

يوفّر Google Sheets الدالة GOOGLEFINANCE لأسعار الصرف، وهي مناسبة للتحويل السريع. المشكلة في المصدر: مزيج سوقي مجهول لا يمكنك فحصه ولا اختياره. أما Frankfurter فيدمج أسعار البنوك المركزية بطريقة قابلة للفحص، وحين يجب أن يكون المصدر دقيقًا يمكنك تثبيت جهة واحدة: السعر المرجعي للبنك المركزي الأوروبي لضريبة القيمة المضافة في الاتحاد الأوروبي، أو NBP في بولندا، أو PTAX في البرازيل. ويبقى سجل المصدر المثبّت كما نُشر. ضع الصيغ أدناه حيثما كنت ستضع GOOGLEFINANCE.

البدء السريع

لا إعداد ولا مفتاح API. ضع سعرًا حاليًا في خلية باستخدام IMPORTDATA ونقطة نهاية CSV:

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur")

يملأ Sheets جدولًا صغيرًا date,base,quote,rate. ويصل عمود date رقمًا تسلسليًا؛ حدّده واختر تنسيق، رقم، تاريخ ليظهر تاريخًا. واطلب عدة عملات مقابلة دفعة واحدة بفصلها بفواصل:

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur,gbp,jpy")

تحويل مبلغ

تُرجع IMPORTDATA السعر، لا المبلغ المحوّل. اضرب المبلغ في خلية السعر المستورد، أو استخدم الدالة المخصصة أدناه لاستدعاء واحد مرتّب.

دالة مخصصة

للحصول على دالة =FRANKFURTER() قابلة لإعادة الاستخدام، أضف نص Apps Script قصيرًا. في جدولك، افتح الإضافات، Apps Script، والصق هذا الكود، ثم احفظ:

/**
 * Converts an amount between currencies, at today's rate or on a date.
 * @customfunction
 */
function FRANKFURTER(amount, from, to, date) {
  let url = `https://api.frankfurter.dev/v2/rate/${from}/${to}`;
  if (date) {
    const tz = SpreadsheetApp.getActive().getSpreadsheetTimeZone();
    url += `?date=${Utilities.formatDate(date, tz, "yyyy-MM-dd")}`;
  }
  const data = JSON.parse(UrlFetchApp.fetch(url).getContentText());
  return amount * data.rate;
}

ثم استدعها من أي خلية:

=FRANKFURTER(100, "usd", "eur")

مرّر تاريخًا للحصول على سعر تاريخي:

=FRANKFURTER(100, "usd", "eur", DATE(2020, 1, 2))

تثبيت مصدر رسمي

تحصل افتراضيًا على السعر المدمج من جميع المصادر. أضف providers لتثبيت جهة واحدة. وهذا مهم في الضرائب والمحاسبة: إذ تشترط دول كثيرة السعر الذي ينشره بنكها المركزي عند تحويل المبالغ بالعملات الأجنبية.

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur&providers=ecb")
ECB
السعر المرجعي للبنك المركزي الأوروبي، المعيار لضريبة القيمة المضافة والجمارك في الاتحاد الأوروبي.
NBP
Narodowy Bank Polski. تُحوَّل ضريبة القيمة المضافة وضريبة الشركات في بولندا بسعر NBP.
CNB
تثبيت البنك الوطني التشيكي، المستخدم في المحاسبة والضرائب التشيكية.
BCB
PTAX من Banco Central do Brasil، المرجع للعقود والضرائب البرازيلية.
BANXICO
سعر FIX من Banco de México لتسوية الالتزامات بالدولار الأمريكي.

تصفّح جميع المصادر. يتبع المصدر المثبّت جدول نشره الخاص، لذا قد يتأخر أحدث أسعاره عن أحدث سعر مدمج بيوم.

السلاسل التاريخية

استخدم from لنطاق تواريخ وgroup=month لاختصاره إلى صف واحد لكل شهر، جاهز للرسم البياني. قد يتغير السجل المدمج قليلًا مع وصول بيانات جديدة، لذا ثبّت مصدرًا حين يجب أن تبقى الأرقام ثابتة.

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd&quotes=gbp&providers=bbk&group=month")

يجلب هذا الدولار الأمريكي مقابل الجنيه الإسترليني منذ 1949 من أرشيف Deutsche Bundesbank. يمكنك أن ترى ربط الـcable عند $2.80 ثابتًا لسنوات، ثم انكساره في 1967. ويمتد السجل العميق عبر تثبيتات البوندسبنك في فرانكفورت: الدولار مقابل المارك منذ 1948، ومعظم أزواج الدولار الأخرى من 1949 إلى 1970. ويتولى البنك المركزي الأوروبي المهمة منذ 1999، لذا تستخدم السلسلة الحديثة المتصلة السعر المدمج الافتراضي أو providers=ecb.