الأسئلة الشائعة وتحديد المشاكل وحلّها

ما هي الاختلافات بين استخدام Gemini Developer API وVertex AI Gemini API؟

يسرد الجدول التالي الاختلافات المهمة بين مقدِّمَي خدمة "Gemini API" بشكل عام بغض النظر عن طريقة الوصول إليهما:

¹ يختلف السعر الذي يتم دفعه حسب الاستخدام بين مقدِّمَي الخدمة لواجهة برمجة التطبيقات (يمكنك الاطّلاع على مزيد من المعلومات في المستندات الخاصة بكل منهما).

² لا تتوافق Files API الخاصة بـ Gemini Developer API مع حِزم تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic.

يعرض الجدول التالي مدى توفّر الميزات التي يتم طرح أسئلة شائعة بشأنها لمقدّمي خدمة "Gemini API". ينطبق هذا الجدول على وجه التحديد عند استخدام حِزم تطوير البرامج (SDK) الخاصة بعميل Firebase AI Logic.

هل يمكنني استخدام كل من Gemini Developer API وVertex AI Gemini API؟

نعم، يمكنك تفعيل كل من موفّرَي خدمة "Gemini API" في مشروعك على Firebase، ويمكنك استخدام كلتا واجهتَي برمجة التطبيقات في تطبيقك.

للتبديل بين موفّري واجهات برمجة التطبيقات في الرمز، ما عليك سوى التأكّد من ضبط الخدمة الخلفية بشكل مناسب في الرمز.

ما هي واجهات برمجة التطبيقات المطلوبة؟ وكيف يمكنني تفعيلها؟

لاستخدام حِزم تطوير البرامج (SDK) مع Firebase AI Logic، يجب تفعيل واجهتَي برمجة التطبيقات التاليتَين في مشروعك:Gemini Developer API

• Gemini Developer API (generativelanguage.googleapis.com)
• Firebase AI Logic API (firebasevertexai.googleapis.com)

يجب تفعيل هاتين الواجهتين باستخدام وحدة تحكّم Firebase:

1. في وحدة تحكّم Firebase، انتقِل إلى خدمات الذكاء الاصطناعي > منطق الذكاء الاصطناعي.

2. انقر على البدء.

3. انقر على الرمز لبدء استخدام Gemini Developer API.

   سيؤدي ذلك إلى بدء سير عمل موجّه يتيح لك استخدام واجهتَي برمجة التطبيقات. ستنشئ وحدة التحكّم أيضًا مفتاح واجهة برمجة تطبيقات Gemini، بالإضافة إلى إضافة واجهة برمجة التطبيقات Firebase AI Logic إلى القائمة المسموح بها لمفتاح واجهة برمجة تطبيقات Firebase.

كيف يمكنني إيقاف واجهات برمجة التطبيقات في مشروع Firebase الخاص بي؟

بالنسبة إلى Firebase AI Logic، نحاول تسهيل عملية إعداد مشروع Firebase لاستخدام موفّر Gemini API الذي اخترته قدر الإمكان. ويشمل ذلك تفعيل واجهات برمجة التطبيقات المطلوبة في مشروع Firebase أثناء رحلات معيّنة، مثل سير العمل الإرشادي في وحدة تحكّم Firebase.

ومع ذلك، إذا قرّرت عدم استخدام Firebase AI Logic أو أحد مقدّمي خدمة Gemini API، يمكنك إيقاف واجهات برمجة التطبيقات المرتبطة في مشروع Firebase.

ما هي النماذج التي يمكن استخدامها مع حِزم تطوير البرامج (SDK) Firebase AI Logic؟

اطّلِع على قوائم الطُرز المتوافقة. نضيف إمكانات جديدة إلى حِزم SDK بشكل متكرّر، لذا يُرجى مراجعة هذه الأسئلة الشائعة للاطّلاع على آخر الأخبار (وكذلك في ملاحظات الإصدار والمدوّنات والمشاركات على وسائل التواصل الاجتماعي).

• Gemini Developer API

  • Gemini وImagen هما نموذجان أساسيان.

    يُرجى العِلم أنّ Gemini Developer API (بغض النظر عن طريقة الوصول إليه) لا يتيح سوى نماذج Imagen ثابتة معيّنة.

• Vertex AI Gemini API

  • Gemini وImagen هما نموذجان أساسيان.

• بغض النظر عن Gemini APIمقدّم الخدمة الذي اخترته

  • Firebase AI Logic لا يتيح استخدام ما يلي:

    • نماذج Gemini غير أساسية (مثل نماذج PaLM أو النماذج المعدَّلة أو النماذج المستندة إلى Gemma)

    • طُرز Imagen أو imagen-3.0-capability-001 الأقدم

ماذا يجب أن أفعل عند إيقاف النماذج نهائيًا؟

عندما نُصدر إصدارًا ثابتًا من النموذج، نسعى إلى ضمان توفّره لمدة عام واحد على الأقل قبل إيقافه نهائيًا.

مكان العثور على تاريخ إيقاف نموذج

في ما يلي بعض الطرق التي يمكنك من خلالها العثور على تاريخ إيقاف نموذج:

• عند طرح النموذج: ندرِج تاريخ الإيقاف المتوقّع لكل نموذج في عدة مواضع في مستندات موفّر Gemini API وفي مستندات Firebase (راجِع صفحة النماذج المتوافقة).

• عند اقتراب تاريخ الإيقاف النهائي: ترسل Google رسائل إلكترونية إلى أعضاء المشروع المعنيين، وننشر تذكيرات في ملاحظات الإصدار والقنوات الأخرى بشأن أي عمليات إيقاف نهائي وشيكة (على سبيل المثال، تذكير بمواعيد الإيقاف النهائي للنموذجين الثابتين Gemini 1.5 و1.0).

ما هي الإجراءات التي يجب اتّخاذها إذا كان النموذج الذي تستخدمه سيتم إيقافه نهائيًا؟

1. ابحث عن طراز متوافق حاليًا واسم الطراز.

2. عدِّل اسم النموذج الذي يستخدمه تطبيقك قبل تاريخ إيقاف الخدمة، وإلا ستتعذّر معالجة أي طلبات إلى هذا النموذج وسيظهر الخطأ 404.

   • يمكنك ضبط اسم النموذج أثناء عملية التهيئة عند إنشاء مثيل GenerativeModel أو LiveModel أو ImagenModel. يُرجى مراجعة التوصية المهمة أدناه بشأن استخدام Firebase Remote Config.

   • عند استخدام Firebase AI Logic، عادةً لن تحتاج إلى تعديل أي جزء من الرمز الذي يستدعي النموذج فعليًا.

3. اختبِر تطبيقك للتأكّد من أنّ الاستجابات لا تزال على النحو المتوقّع.

Imagen النماذج الثابتة - تواريخ إيقاف التشغيل والبدائل

• سيتم إيقاف جميع نماذج Imagen في 24 يونيو 2026.

الاستبدال: يمكنك نقل تطبيقاتك لاستخدام Gemini نماذج معالجة الصور (نماذج Nano Banana).

Gemini 2.0 النماذج الثابتة - تواريخ إيقاف التشغيل والبدائل

• ‫Gemini 2.0 Flash وGemini 2.0 Flash‑Lite:

  gemini-2.0-flash-001 (والاسم المستعار الذي يتم تعديله تلقائيًا gemini-2.0-flash)
  gemini-2.0-flash-lite-001 (والاسم المستعار الذي يتم تعديله تلقائيًاgemini-2.0-flash-lite)

  • ‫6 فبراير 2026: لن تكون هذه النماذج متاحة للاستخدام في المشاريع التي لم يسبق لها استخدام النموذج.

  • ‫31 مارس 2026: سيتم إيقاف هذه النماذج.

  يُرجى العِلم أنّ نماذج Gemini Live API 2.0 الثابتة لا تتأثر.

الاستبدال: يمكنك الانتقال إلى استخدام نموذج Gemini 2.5 (مثل gemini-2.5-flash-lite) أو تجربة أحد نماذج Gemini 3 الجديدة (مثل gemini-3.1-flash-lite-preview).

النماذج الثابتة من Gemini 1.5 و1.0 - تواريخ إيقاف التشغيل والبدائل

• طرُز Gemini 1.5 Pro:

  • gemini-1.5-pro-002 (وgemini-1.5-pro): 24 سبتمبر 2025
  • gemini-1.5-pro-001: 24 مايو 2025

• طرُز Gemini 1.5 Flash:

  • gemini-1.5-flash-002 (وgemini-1.5-flash): 24 سبتمبر 2025
  • gemini-1.5-flash-001: 24 مايو 2025

• طُرز Gemini 1.0 Pro Vision: 21 أبريل 2025 (كان من المقرر سابقًا أن يتم إيقافها نهائيًا في 9 أبريل 2025)

• طُرز Gemini 1.0 Pro: 21 أبريل 2025 (كان من المقرر سابقًا أن يتم إيقافها نهائيًا في 9 أبريل 2025)

الاستبدال: يمكنك الانتقال إلى استخدام نموذج Gemini 2.5 (مثل gemini-2.5-flash-lite) أو تجربة أحد نماذج Gemini 3 الجديدة (مثل gemini-3.1-flash-lite-preview).

ما هي الأذونات التي قد تكون مطلوبة لاستخدام حِزم تطوير البرامج (SDK) التي تتضمّن Firebase AI Logic؟

هل يستخدم Firebase AI Logic بياناتي لتدريب النماذج؟

اطّلِع على إدارة البيانات والذكاء الاصطناعي المسؤول.

كيف يمكنني ضبط حدّ السعر لكل مستخدم؟

بشكلٍ تلقائي، يضبط Firebase AI Logic الحد الأقصى للطلبات لكل مستخدم على 100 طلب في الدقيقة (RPM).

إذا أردت تعديل الحد الأقصى لعدد الطلبات لكل مستخدم، عليك تعديل إعدادات الحصة لواجهة برمجة التطبيقات Firebase AI Logic.

Firebase AI Logic مزيد من المعلومات عن حصة واجهة برمجة التطبيقات في تلك الصفحة، يمكنك أيضًا التعرّف على كيفية عرض حصتك وتعديلها.

كيف يمكنني تقليل وقت الاستجابة والاستخدام العالي للرموز المميزة؟

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

تستخدم نماذج Gemini 3 والإصدارات الأحدث دائمًا "عملية تفكير" داخلية تحسّن بشكل كبير قدراتها على الاستنتاج والتخطيط المتعدّد الخطوات، ما يجعلها فعّالة للغاية في المهام المعقّدة، مثل الترميز والرياضيات المتقدّمة وتحليل البيانات.

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

يُرجى العِلم أنّه بالنسبة إلى معظم طُرز Gemini 3 والإصدارات الأحدث، تم ضبط مستوى التفكير التلقائي على HIGH.

هل يجب تضمين نوع MIME في طلباتي المتعددة الوسائط؟ (مثل الصور وملفات PDF والفيديوهات والملفات الصوتية)

نعم، في كل طلب متعدد الوسائط، يجب تقديم ما يلي دائمًا:

• mimeType الملف الاطّلاع على استثناء أدناه

• الملف يمكنك تقديم الملف كبيانات مضمّنة أو باستخدام عنوان URL الخاص به.

يمكنك التعرّف على أنواع ملفات الإدخال المتوافقة وكيفية تحديد نوع MIME وخياري توفير الملف في ملفات الإدخال المتوافقة والمتطلبات.

استثناء من تضمين نوع MIME في طلبك

يُستثنى من تقديم نوع MIME مدخلات الصور المضمّنة للطلبات الواردة من تطبيقات منصتَي Android وApple الأصلية.

توفّر حِزم تطوير البرامج (SDK) لمنصتَي Android وApple طريقة مبسطة ومتوافقة مع المنصات للتعامل مع الصور في الطلبات، إذ يتم تحويل جميع الصور (بغض النظر عن تنسيقها) من جهة العميل إلى تنسيق JPEG بجودة% 80 قبل إرسالها إلى الخادم.Firebase AI Logic وهذا يعني أنّه عند تقديم صور كبيانات مضمّنة باستخدام حِزم تطوير البرامج (SDK) لمنصتَي Android وApple، لن تحتاج إلى تحديد نوع MIME في الطلب.

يظهر هذا التعامل المبسّط في مستندات Firebase AI Logic في أمثلة إرسال الصور المشفرة بتنسيق base64 في الطلبات.

في ما يلي بعض المعلومات الإضافية الخاصة بكل منصة حول هذه الميزة:

• على أجهزة Android:

  • يمكنك الاستفادة من الطريقة المبسّطة للتعامل مع أنواع الصور المتوافقة مع النظام الأساسي (Bitmap) في الطلبات المتعدّدة الوسائط التي تحتوي على صور كبيانات مضمّنة (راجِع المثال).

  • للحصول على مزيد من التحكّم في تنسيقات الصور وعمليات التحويل، يمكنك تقديم الصور بتنسيق InlineDataPart وتوفير نوع MIME المحدّد. على سبيل المثال:

    content { inlineData(/* PNG as byte array */, "image/png") }

• بالنسبة إلى منصات Apple:

  • يمكنك الاستفادة من الطريقة المبسّطة للتعامل مع أنواع الصور المتوافقة مع النظام الأساسي (UIImage وNSImage وCIImage وCGImage) في الطلبات المتعدّدة الوسائط التي تحتوي على صور كبيانات مضمّنة (اطّلِع على المثال).

  • للحصول على مزيد من التحكّم في تنسيقات الصور وعمليات التحويل، يمكنك تقديم الصور بتنسيق InlineDataPart وتوفير نوع MIME المحدّد. على سبيل المثال:

    InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")

هل تتوفّر هذه الميزات عند استخدام Firebase AI Logic: تحديد المصدر باستخدام "بحث صور Google"، واستخدام "خرائط Google" كمصدر، والضبط الدقيق للنموذج، وإنشاء عمليات التضمين، والاسترجاع الدلالي؟

تتوفّر الميزات التالية في نماذج مختلفة ومقدّمي خدمات واجهات برمجة التطبيقات، ولكن لا تتوفّر عند استخدام Firebase AI Logic:

• تحديد المصدر من خلال "بحث صور Google"
• استخدام "خرائط Google" كمصدر
• ضبط نموذج
• إنشاء التضمينات
• الاسترجاع الدلالي

إذا أردت إضافة هذه الميزات كطلبات ميزات أو التصويت على طلب ميزة حالي، يُرجى الانتقال إلى Firebase UserVoice.

لماذا تم تغيير الاسم من "Vertex AI in Firebase" إلى "Firebase AI Logic"؟

في عام 2024، أطلقنا مجموعة من حِزم تطوير البرامج (SDK) الخاصة بالعملاء في Firebase والتي يمكنها استخدام Vertex AI Gemini API، بالإضافة إلى بوابة وكيل Firebase لحماية واجهة برمجة التطبيقات هذه من إساءة الاستخدام ولإتاحة عمليات الدمج مع منتجات Firebase الأخرى. أطلقنا على منتجنا اسم "Vertex AI في Firebase"، وقد وصف هذا الاسم بدقة حالات الاستخدام المتاحة لمنتجنا في ذلك الوقت.

ومنذ ذلك الحين، وسّعنا إمكانات منتجنا. على سبيل المثال، اعتبارًا من مايو 2025، أصبحنا نوفّر دعمًا لـ Gemini Developer API، بما في ذلك إمكانية حماية Gemini Developer API من إساءة الاستخدام من خلال عملية التكامل مع Firebase App Check.

نتيجةً لذلك، لم يعُد الاسم "Vertex AI في Firebase" يمثّل بدقة النطاق الموسّع لمنتجنا. لذلك، اخترنا اسمًا جديدًا هو Firebase AI Logic يعكس بشكل أفضل مجموعة الخصائص المتطوّرة ويسمح لنا بمواصلة توسيع عروضنا في المستقبل.

راجِع دليل نقل البيانات للتأكّد من حصولك على جميع الميزات الجديدة من Firebase AI Logic (ويمكنك اختياريًا البدء في استخدام Gemini Developer API).

بالنسبة إلى تطبيقات Swift على منصات Apple، ماذا يجب أن أفعل بشأن تغيير اسم الوحدة من FirebaseAI إلى FirebaseAILogic؟

بالنسبة إلى تطبيقات منصة Apple، بدءًا من الإصدار 12.5.0 من حزمة تطوير البرامج (SDK) لمنصة Firebase، يتم الآن توزيع Firebase AI Logic ضمن الوحدة FirebaseAILogic. لقد حرصنا على أن يكون هذا التغيير غير متوافق مع الإصدارات السابقة.

لماذا أجرينا هذا التغيير؟

كنا نوزّع هذه الخدمة سابقًا ضمن الوحدة FirebaseAI. ومع ذلك، كان علينا إعادة تسميته إلى FirebaseAILogic للأسباب التالية:

• تجنُّب حدوث تعارض في الأسماء بين الوحدة النمطية والفئة، ما يؤدي إلى حدوث مشاكل في التوزيعات الثنائية.

• إتاحة استخدام وحدات ماكرو Swift لتطوير الميزات المستقبلية

ماذا يجب أن أفعل إذا كنت أرقّي إلى الإصدار 12.5.0 أو إصدار أحدث؟

إنّ تغيير اسم الوحدة إلى FirebaseAILogic لا يؤدي إلى حدوث أي مشاكل وهو متوافق مع الإصدارات القديمة. ومع ذلك، قد نزيل الوحدة القديمة في النهاية مع إصدار مستقبلي لتغيير رئيسي غير متوافق في حزمة Firebase SDK (لم يتم تحديد الإطار الزمني حاليًا).

لا يلزم إجراء أي تغييرات على اسم هذا الوحدة، ولكننا ننصحك بما يلي:

1. عند اختيار تبعيات Swift PM، اختَر FirebaseAILogic (بدلاً من FirebaseAI).

2. غيِّر عبارات الاستيراد إلى FirebaseAILogic (بدلاً من FirebaseAI).

ما هو Gemini مفتاح واجهة برمجة التطبيقات؟

تستخدم Gemini Developer API "مفتاح واجهة برمجة تطبيقات Gemini" لتفويض المتصل. لذا، إذا كنت تستخدم Gemini Developer API من خلال حِزم تطوير البرامج (SDK) Firebase AI Logic، ستحتاج إلى مفتاح واجهة برمجة التطبيقات Gemini صالح في مشروع Firebase لإرسال طلبات إلى واجهة برمجة التطبيقات هذه.

يشير "مفتاح واجهة برمجة التطبيقات Gemini" إلى مفتاح واجهة برمجة تطبيقات يتضمّن Gemini Developer API في قائمة واجهة برمجة التطبيقات المسموح بها.

عند اتّباع Firebase AI Logic سير عمل الإعداد في وحدة تحكّم Firebase، ننشئ مفتاح واجهة برمجة تطبيقات Gemini يقتصر على Gemini Developer API فقط، ونضبط خدمة وكيل Firebase AI Logic لاستخدام مفتاح واجهة برمجة التطبيقات هذا. يُطلق على مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه في Firebase Gemini اسم مفتاح Gemini Developer API (تم إنشاؤه تلقائيًا بواسطة Firebase) في صفحة بيانات الاعتماد ضمن Google Cloud.

مزيد من المعلومات حول قيود واجهة برمجة التطبيقات لمفاتيح واجهة برمجة التطبيقات

لا تُضِف مفتاح واجهة برمجة التطبيقات Gemini إلى المصدر البرمجي لتطبيقك عند استخدام حِزم تطوير البرامج Firebase AI Logic. مزيد من المعلومات حول كيفية الحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini

هل يجب إضافة مفتاح واجهة برمجة التطبيقات Gemini إلى قاعدة رموز تطبيق الويب أو تطبيق الأجهزة الجوّالة؟

عند استخدام حِزم تطوير البرامج Firebase AI Logic، لا تُضِف مفتاح واجهة برمجة التطبيقات Gemini إلى قاعدة رموز تطبيقك.

في الواقع، أثناء التطوير باستخدام حِزم تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic، لن تحتاج إلى التفاعل مباشرةً مع مفتاح واجهة برمجة التطبيقات Gemini. بدلاً من ذلك، ستضمّ خدمة الوكيل Firebase AI Logic لدينا داخليًا مفتاح واجهة برمجة التطبيقات Gemini في كل طلب يتم إرساله إلى Gemini Developer API، وذلك بشكل كامل في الخلفية.

كيف يمكنني تغيير مفتاح واجهة برمجة التطبيقات Gemini المستخدَم لطلب بيانات من Gemini Developer API؟

عند استخدام حِزم تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic، من غير المحتمل أن تحتاج إلى تغيير مفتاح واجهة برمجة التطبيقات Gemini. في ما يلي حالتان قد تحتاج فيهما إلى إجراء ذلك:

• إذا تسرّبت المفتاح عن طريق الخطأ وأردت استبداله بمفتاح آمن جديد.

• إذا حذفت المفتاح عن طريق الخطأ يُرجى العِلم أنّه يمكنك إلغاء حذف المفتاح في غضون 30 يومًا من تاريخ الحذف.

إليك كيفية تغيير مفتاح واجهة برمجة التطبيقات Gemini الذي تستخدمه حِزم تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic:

1. إذا كان مفتاح واجهة برمجة التطبيقات الذي أنشأته Firebase Gemini لا يزال موجودًا، احذفه.

   يمكنك حذف مفتاح واجهة برمجة التطبيقات هذا في لوحة واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد في وحدة تحكّم Google Cloud. اسم المفتاح هو:
   مفتاح Gemini Developer API (يتم إنشاؤه تلقائيًا بواسطة Firebase).

2. في الصفحة نفسها من وحدة تحكّم Google Cloud، أنشئ مفتاح API جديدًا. ننصحك بتسميته على النحو التالي:
   مفتاح Gemini Developer API لمنصة Firebase.

3. إلى مفتاح واجهة برمجة التطبيقات الجديد هذا، أضِف قيودًا على واجهة برمجة التطبيقات واختر Generative Language API فقط.
   يُطلق على Gemini Developer API أحيانًا اسم "Generative Language API" في وحدة تحكّم Google Cloud.

   يجب عدم إضافة أي قيود على التطبيقات، وإلا لن تعمل خدمة الخادم الوكيل Firebase AI Logic على النحو المتوقّع.

4. نفِّذ الأمر التالي لضبط هذا المفتاح الجديد كمفتاح واجهة برمجة التطبيقات Gemini الذي يجب أن تستخدمه خدمة الخادم الوكيل Firebase AI Logic.

   PROJECT_ID="PROJECT_ID"
   GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY"
   curl \
     -X PATCH \
     -H "x-goog-user-project: ${PROJECT_ID}" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \
     -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
   

   gcloud CLI

احرص على عدم إضافة مفتاح واجهة برمجة التطبيقات الجديد Gemini إلى قاعدة رموز تطبيقك. مزيد من المعلومات حول كيفية الحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini

هل يمكنني استخدام "مفتاح واجهة برمجة التطبيقات في Firebase" كمفتاح واجهة برمجة التطبيقات في Gemini؟

لا، لا يجب استخدام "مفتاح واجهة برمجة التطبيقات في Firebase" كمفتاح واجهة برمجة التطبيقات في Gemini. ننصحك بشدة بعدم إضافة Gemini Developer API إلى قائمة السماح لمفتاح واجهة برمجة التطبيقات في Firebase.

مفتاح واجهة برمجة التطبيقات (API) في Firebase هو مفتاح واجهة برمجة التطبيقات المُدرَج في ملف إعدادات Firebase أو العنصر الذي تضيفه إلى قاعدة رموز تطبيقك لربط تطبيقك بمنصة Firebase. لا بأس بتضمين مفتاح واجهة برمجة التطبيقات Firebase في الرمز عند استخدام المفتاح مع واجهات برمجة التطبيقات ذات الصلة بمنصة Firebase فقط (مثل Firebase AI Logic). مزيد من المعلومات حول مفاتيح واجهة برمجة التطبيقات Firebase

في لوحة واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد في وحدة تحكّم Google Cloud، يظهر مفتاح واجهة برمجة التطبيقات في Firebase على النحو التالي:

بما أنّه عليك إضافة مفتاح واجهة برمجة التطبيقات في Firebase إلى قاعدة رموز تطبيقك لكي تعمل واجهات برمجة التطبيقات المرتبطة بـ Firebase، وبما أنّ Gemini Developer API مُخوَّلة من خلال مفتاح واجهة برمجة التطبيقات، ننصحك بشدة بعدم إضافة Gemini Developer API (المعروفة باسم "Generative Language API" في وحدة تحكّم Google Cloud) إلى قائمة السماح الخاصة بمفتاح واجهة برمجة التطبيقات في Firebase. وفي حال فعلت ذلك، ستعرّض Gemini Developer API لإساءة الاستخدام المحتملة.

كيف يمكنني الحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini؟

توضّح الأسئلة الشائعة التالية بعض أفضل الممارسات المقترَحة للحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini.

إذا كنت تتصل بـ Gemini Developer API مباشرةً من تطبيقك على الأجهزة الجوّالة أو تطبيق الويب:

• استخدِم حِزم تطوير البرامج (SDK) الخاصة بالعملاء في الإصدار Firebase AI Logic.
• لا تُضِف مفتاح واجهة برمجة التطبيقات Gemini إلى قاعدة الرموز البرمجية لتطبيقك.

توفّر Firebase AI Logic خدمة وكيل تتضمّن داخليًا مفتاح واجهة برمجة التطبيقات Gemini في كل طلب إلى Gemini Developer API، وذلك بالكامل في الخلفية.

بالإضافة إلى ذلك، ننصحك بشدة بما يلي:

• ما إن تبدأ في تطوير تطبيقك بشكل جاد، عليك دمجه مع Firebase App Check للمساعدة في حماية موارد الخلفية وواجهات برمجة التطبيقات المستخدَمة للوصول إلى النماذج التوليدية.

• لا تعِد استخدام مفتاح واجهة برمجة التطبيقات Gemini الذي تم إنشاؤه في Firebase خارج Firebase AI Logic. إذا كنت بحاجة إلى مفتاح واجهة برمجة تطبيقات Gemini لحالة استخدام أخرى، أنشئ مفتاحًا منفصلاً.

• بشكل عام، لا يجب تعديل مفتاح واجهة برمجة التطبيقات الذي أنشأته Firebase.Gemini يُطلق على هذا المفتاح اسم مفتاح Gemini Developer API (يتم إنشاؤه تلقائيًا بواسطة Firebase) في وحدة تحكّم Google Cloud.

  • لا تُضِف أي واجهات برمجة تطبيقات إضافية إلى قائمة السماح الخاصة بواجهة برمجة التطبيقات لمفتاح Gemini الذي تم إنشاؤه في Firebase. في قائمة واجهات برمجة التطبيقات المسموح بها، يجب أن يتضمّن مفتاح واجهة برمجة التطبيقات فقط النطاق Gemini Developer API (المعروف باسم "Generative Language API" في Google Cloud).Gemini

  • يجب عدم إضافة أي قيود على التطبيقات، وإلا لن تعمل خدمة الخادم الوكيل Firebase AI Logic على النحو المتوقّع.

تم اختراق مفتاح واجهة برمجة التطبيقات Gemini. ما هو الإجراء الواجب اتّخاذه؟

إذا تم اختراق مفتاح واجهة برمجة التطبيقات Gemini، اتّبِع التعليمات لتغيير مفتاح واجهة برمجة التطبيقات Gemini المستخدَم لإجراء طلبات إلى Gemini Developer API.

ننصحك أيضًا بمراجعة أفضل الممارسات المقترَحة للحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini.