الناتج المحلي الإجمالي في حساب معدل النمو الاقتصادي من مستويات

نفّذ ذلك باستخدام واجهة API

استخدم نقطة نهاية ملاحظات GDP للمستويات ونقطة نهاية نمو GDP للنمو الحقيقي. يطلب مثال Python المستويات الأمريكية بدءًا من 2026-Q1 والنمو الحقيقي للفترة 2026-Q2، فيشير الحسابان إلى الربع نفسه. أبقِ تسميات الفترات مرافقة للنتائج عند المقارنة. قيمة value في كل ملاحظة هي مستوى GDP بالدولار الأمريكي USD. تعرض استجابة النمو نسبًا مئوية، فاقرأ الوحدات مع أسماء الحقول: المستوى ونسبة النمو مقياسان مختلفان للاقتصاد.

1. اضبط مفتاح API الخاص بك احصل على مفتاح API مجاني وضعه في متغير البيئة NARWHAL_API_KEY. يقرأ السكربت هذا المتغير ويرسل المفتاح في الترويسة Authorization: Bearer YOUR_KEY.
2. اطلب المستويات والنمو الحقيقي استخدم سكربت Python لجلب ملاحظات GDP واستجابة النمو الحقيقي. يحتفظ بالملاحظات بحسب الفترة، فتستخدم القسمة الربع الثاني من 2026 بسطًا والربع الأول مقامًا.
   Python، النمو الاسمي من المستويات والنمو الحقيقي من API

   import os
   import requests
   
   H = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   API = "https://api.narwhalapi.com/v1/economics/USA"
   gdp = {
       o["period"]: float(o["value"])
       for o in requests.get(
           f"{API}/gdp/observations", params={"start": "2026-Q1"}, headers=H, timeout=10
       ).json()["observations"]
   }
   growth = requests.get(
       f"{API}/gdp-growth", params={"period": "2026-Q2"}, headers=H, timeout=10
   ).json()
   
   q = gdp["2026-Q2"] / gdp["2026-Q1"] - 1
   print(f"nominal GDP, Q2 vs Q1: {q:.2%}   as an annual rate: {(1 + q) ** 4 - 1:.2%}")
   print(
       f"real GDP growth from the API: {growth['quarter_over_quarter']}% on the quarter, "
       f"{growth['year_over_year']}% on the year"
   )

3. اقرأ الحساب الاسمي يحمل المتغير q التغير بين المستويات الفصلية، وتعبّر أول عبارة طباعة عنه بنسبة مئوية. ويركّب حساب المعدل السنوي هذا التغير الفصلي نفسه؛ ولا يزيل تغيرات الأسعار المتضمنة في المستويات.
4. اقرأ استجابة النمو الحقيقي الحقل quarter_over_quarter هو النمو الحقيقي بنسبة مئوية وهو غير محوَّل إلى معدل سنوي. ويعطي الحقل year_over_year النسبة الحقيقية على أساس سنة مقابل سنة، لذا استخدم الحقل الذي يطابق الفترة التي تريد مقارنتها.

نفّذ ذلك في جدول بيانات أو دون شيفرة

ضع مستوى GDP للربع الأسبق في B2 ومستوى الربع الأحدث في B3. وفي مقارنة الربع الثاني من 2026 للولايات المتحدة، تحتوي B2 على مستوى الربع الأول 31,906,274,000,000 USD وتحتوي B3 على مستوى الربع الثاني 32,563,030,000,000 USD. وهذه هي المستويات نفسها المستخدمة في حساب Python. اقسم القيمة الأحدث على القيمة الأسبق ثم اطرح واحدًا. نسّق النتيجة كنسبة مئوية ليعبّر الجدول عن التغير بالشكل نفسه الوارد في المثال المحلول. تشير الصيغة إلى الخلايا، فأبقِ ترتيبها متسقًا مع الفترات التي تريد مقارنتها.

=B3/B2-1

للتعبير عن هذا التغير الفصلي بمعدل سنوي، استخدم الصيغة التالية على الخلايا نفسها. أبقِ المستويات الكاملة في الخلايا لكلا الحسابين؛ فصيغة المعدل السنوي تعمل مباشرة من نسبتها.

=(B3/B2)^4-1

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

متى تستخدم كل خيار

لماذا يختلف نمو GDP المحسوب من المستويات عن الرقم الرئيسي؟

تتضمن المستويات نمو الأسعار لأنها بالأسعار الجارية، بينما المقياس الرئيسي هو النمو الحقيقي بالأسعار الثابتة. وتعطي نقطة نهاية نمو GDP المقارنة الحقيقية عندما تريد النمو بعد إزالة هذا المكوّن.

في الربع الثاني من 2026، النتيجة الاسمية مقابل الربع السابق 2.06% والنتيجة الحقيقية 0.55%. والفرق بينهما 1.51 نقطة مئوية. يعكس هذا الفرق نمو الأسعار داخل المستويات بالأسعار الجارية؛ ولا يغني الطرح التقريبي لمعدل التضخم عن استخدام مؤشر الأسعار.

هل أحوّل نمو GDP الفصلي إلى معدل سنوي؟

حوّله إلى معدل سنوي فقط عندما تريد مقارنة بمعدل سنوي. يُذكر الرقم الرئيسي الأمريكي غالبًا بمعدل سنوي، بينما الحقل quarter_over_quarter في API غير محوَّل. طابِق اصطلاح المعدل إلى جانب الربع قبل مقارنة الأرقام.

تحمل ملاحظات GDP القيمة annualized: true لأن كل مستوى معبَّر عنه بمعدل سنوي. وتبقى قسمة مستوى فصلي على آخر معطية للتغير مقابل الربع السابق. ورفع هذه النسبة إلى القوة الرابعة وطرح واحد يعبّر عن التغير بمعدل سنوي؛ ولا يعطي النمو على أساس سنة مقابل سنة.

هل يمكنني استخدام GDP الاسمي لقياس حجم الاقتصاد؟

نعم، تقيس مستويات GDP الحجم الاسمي بالدولار الأمريكي USD وبالأسعار الجارية. استخدم المستوى عندما تحتاج إلى هذا الحجم، أو قارن المستويات عندما تحتاج إلى تغيره الاسمي على فترة اخترتها. ولمقارنة النمو في الحجم، استخدم أرقام النمو الحقيقي في نقطة نهاية نمو GDP.

مثال محلول: الربع الثاني من 2026 في الولايات المتحدة

ابدأ بمستويات GDP الأمريكية للربعين الأول والثاني من 2026. كلتا القيمتين بالدولار USD وبمعدل سنوي. اقسم قيمة الربع الثاني على قيمة الربع الأول قبل طرح واحد أو التعبير عن التغير بمعدل سنوي.

قسمة مستوى الربع الثاني على مستوى الربع الأول تعطي نسبة 1.020583. اطرح واحدًا من ناتج القسمة لتحصل على التغير الاسمي، ثم عبّر عنه بنسبة مئوية: 2.06% للربع الثاني من 2026 مقارنة بالربع الأول. استخدم المستويات الكاملة في الحساب، وأبقِ ناتج القسمة غير المقرّب لحساب المعدل السنوي.

للتعبير عن تغير الربع الثاني من 2026 في الولايات المتحدة بمعدل سنوي، ارفع ناتج القسمة غير المقرّب إلى القوة الرابعة واطرح واحدًا. النتيجة 8.49%. وبصورة منفصلة، يبلغ حقل النمو الحقيقي مقابل الربع السابق للفترة 2026-Q2 ما قيمته 0.55%. قارن الرقم الفصلي الاسمي بالرقم الفصلي الحقيقي: 2.06% ناقص 0.55% يعطي فرقًا قدره 1.51 نقطة مئوية.