ورقة غوغل جيميني: التطبيق وواجهة برمجية وCLI

يظهر Gemini كتطبيق دردشة، لوحة جانبية داخل Google Workspace، واجهة برمجية، ووكيل طرفية. الأسماء تتداخل ومعرفات النموذج لا تتداخل. هذه الورقة تسرد الميزات الموثقة فقط على صفحات Google الخاصة بها في أكتوبر 2026، ثم الاستدعاءات التي يمكنك لصقها.

تطبيق Gemini

يجب أن تكون مسجل دخول على gemini.google.com. صفحات المساعدة تقول حساب العمل أو المدرسة يحتاج أيضًا إلى مسؤول لتفعيل الميزة التي تريدها.

Gems

افتح الشريط الجانبي، افتح Gems، واختر New Gem. إذا لم تنشئ واحد من قبل، صفحة المساعدة تسير بك عبر الإعدادات والمساعدة، ثم Gems، أولاً. أعطه اسمًا وتعليمات. تحت Knowledge، Add files يمكنه تحميل من الجهاز أو Drive أو دفتر NotebookLM. ملفات Drive يحتاج Keep Activity على و Workspace متصل بـ Gemini Apps. ملف Drive يُقرأ من نسخة حالية، لذا تعديل لاحق يظهر في Gem. احفظ. Gem تنشئه على الويب أيضًا يظهر في تطبيق الهاتف المحمول وفي لوحة Workspace الجانبية.

لا يمكن استخدام Gems مع Gemini Live. Gem Learning coach لا يغطي تعليم اللغة. ابتداءً من نوفمبر 2026، Gems على حسابات Google الشخصية تنتقل إلى skills. Disable knowledge citations يوقف الاقتباسات لملفات Gem وللملفات المرفوعة في هذه الدردشة.

Deep Research

على الكمبيوتر، افتح gemini.google.com، استخدم Add Files، ثم Deep Research. يمكنك إرفاق ملفات نفس الطريقة كـ prompt عادي. Sources هو تحكم منفصل. Google Search مشمول ما لم تمسحه. Gmail و Drive والخدمات الأخرى من Google تظهر عندما يكون تطبيق Workspace متصلاً. يمكنك إضافة دفاتر NotebookLM. اكتب السؤال، أرسل، و Gemini يكتب خطة. Edit plan إذا كان النطاق خاطئ، ثم Start research. افتح التقرير عندما يكون جاهزًا.

التقرير عادة يستغرق حوالي 5 إلى 10 دقائق، أطول عندما يكون السؤال أثقل. يمكنك مغادرة الدردشة. تطبيق الويب يعلم الخيط عندما ينتهي. تطبيق الهاتف المحمول يمكنه إخطارك. خطة Google AI Ultra قد تضيف مخططات وأوسع وأجهزة محاكاة. هذه الورقة لا تسرد أسعار Ultra.

Canvas

Add Files، ثم Canvas، ثم prompt يسمي الصيغة (doc أو slides أو app أو code). يمكنك إرفاق ملف أو صورة أولاً. التحريرات حفظ تلقائيًا. يمكنك تحويل النتيجة إلى Audio Overview أو اختبار. Code و Show console و Show recent changes تجلس في أعلى اللوحة. Select and ask يسلط على منطقة. Add Gemini features، للمستخدمين المسجلين 18 أو أكبر، يضع توليد نص أو صورة داخل تطبيق Canvas.

الملفات والصور والكود

Add files، ثم Upload Files. مجلد كود تحت More Uploads، Import Code، Upload folder. مستودع GitHub نفس مسار Import Code، باستخدام عنوان URL الـ repo أو branch. Drive هو Add from Drive، بنفس قواعد النشاط والاتصال Workspace كـ Gems. دفاتر تحت More Uploads.

الحدود من صفحة المساعدة تلك، اعتبارًا من أكتوبر 2026:

إذا فشل التحليل، حمّل الملف مرة أخرى. عادات Prompt التي تنقل من منتجات الدردشة موجودة في ورقة ChatGPT prompting. أداة بحث ثانية هي Perplexity للبحث التقني.

لم تكن هناك قائمة Gemini app محددة باسم Extensions على صفحات المساعدة المقروءة في أكتوبر 2026. Canvas هو مكان موثق لإنشاء تطبيق. امتدادات الطرفية تحت Gemini CLI أدناه.

Gemini في Google Workspace

افتح Ask Gemini، عادة في الأعلى يمين. في Docs، بدّل بين لوحة جانبية وشريط سفلي. اختر prompt مقترح أو اكتب واحد. في Gmail، نفس التحكم يصيغ أو يعدل البريد. تقول مساعدة Docs تحتاج خطة Workspace مؤهلة أو Google AI، ودعم اللغة يختلف. تحديث أو إغلاق الوثيقة يمسح تاريخ لوحة جانب Docs. أدرج النصوص التي تحتاج للاحتفاظ.

قائمة ميزات Workspace تضع لوحة جانبية في Gmail و Docs و Sheets و Slides و Drive و Chat، وتسمي أيضًا Help me write و Meet notes. الإصدار الخاص بك قد لا يشمل كل صف. إذا كان Ask Gemini في Chat مفعل، صفحة التعلم تقول لوحة جانبية محذوفة. Gems من تطبيق Gemini تظهر في لوحة جانبية Workspace.

بدء سريع لـ Gemini API

مستندات API تقول Interactions API كانت الافتراضي منذ يونيو 2026. generateContent لا يزال يعمل ويعلم موروث. استخدم Interactions لنص جديد. SDK الرسمي هو google-genai (General Availability اعتبارًا من مايو 2025). حزمة google-generativeai الأقدم غير مُحتفظ بها. صفحة المكتبات تقول المكتبات الموروثة توقفت اعتبارًا من 30 نوفمبر 2025.

أنشئ مفتاح في Google AI Studio. يحصل المستخدمون الجدد على مشروع ومفتاح. خلاف ذلك استخدم Create API key على صفحة مفاتيح API. دليل البدء يخبرك بـ export:

pip install -U google-genai
export GEMINI_API_KEY="YOUR_API_KEY"

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="List three checks before you restart a production Deployment. Keep each check to one sentence.",
)
print(interaction.output_text)

Client() بدون وسيطات يقرأ GEMINI_API_KEY. عينة البدء تستخدم gemini-3.8-flash. عينة الصفحة الرئيسية API تستخدم gemini-4-argon لشرح قصير. كلا معرفات على صفحة النماذج. حزمة JavaScript هي @google/genai.

دليل البدء يقول طبقة مدفوعة ترفع حدود النسبة وتحتاج Cloud Billing. اعتبارًا من تلك الصفحة في أكتوبر 2026، الحد الأدنى المدفوع الذي يسميه هو 5 دولار، أو نفس المبلغ بعملتك. الاستخدام تحت Dashboard، ثم Usage، في AI Studio. هذه الورقة لا تنسخ بقية قائمة الأسعار.

Agents و tool calling وwkiل مدار هي أسطح API منفصلة على موقع المستندات نفسه. كيف يختلف وكيل عن استدعاء interactions.create واحد في what is agentic AI. توصيل أدوات عبر Model Context Protocol في MCP servers explained. وكيل كود طرفية من بائع آخر هو Claude Code cheat sheet.

تشكيلة النموذج اعتبارًا من أكتوبر 2026

صفحة النماذج آخر تحديث 22 أكتوبر 2026. معرفات مستقرة هي التي تثبتها. يمكن أن تُفوّر preview وتُستبدل برسالة تحذيرية أسبوعين على الأقل. اسم alias latest يمكن أن يتغير تحتك. معرف تجريبي ليس افتراضي إنتاج.

أيضًا على هذه الصفحة، والجدير بـ pinning من الصفحة نفسها الأسبوع الذي تشحن: gemini-3.6-flash، gemini-3.1-flash-lite، نماذج صور Nano Banana 2.1 (gemini-nano-banana-2.1)، Nano Banana 2 (gemini-3.1-flash-image)، Nano Banana 2 Lite (gemini-3.1-flash-lite-image)، Nano Banana Pro (gemini-3-pro-image)، ونموذج فيديو Gemini Omni Flash (gemini-omni-1.1-flash). Gemini 2.5 Pro و Flash و Flash-Lite (gemini-2.5-pro، gemini-2.5-flash، gemini-2.5-flash-lite) تبقى لحسابات استخدمتها بالفعل. لا تُستبدل. المشاريع الجديدة يجب أن تستخدم 3.5 Flash-Lite أو 3.8 Flash. عدة معرفات 2.0 علمت shutdown. لا تحيي من gist قديم.

Gemini CLI

README في google-gemini/gemini-cli لا يزال يسميه وكيل طرفية مفتوح المصدر. أيضًا يقول، في ملاحظة في الأعلى، أنه في 18 يونيو 2026 تم استبدال Gemini CLI بـ Antigravity CLI لمستخدمي طبقة غير مدفوع والإصدار الواحد من Google، وأن Gemini CLI لم يُحسّن لـ Gemini 4 Argon. ثبّته فقط إذا كانت هذه الملاحظة تطابق حسابك.

npx @google/gemini-cli
npm install -g @google/gemini-cli
brew install gemini-cli

قناة مستقرة: npm install -g @google/gemini-cli@latest. Preview: @preview. Nightly: @nightly.

خيارات المصادقة التي يسردها README:

gemini
gemini -m gemini-2.5-flash
gemini -p "Summarize the failing test in this repo" --output-format json
gemini --include-directories ../lib,../docs

عينة -m من README هي gemini-2.5-flash. فضّل gemini-3.8-flash عندما يقبله CLI. --output-format json للنصوص البرمجية. --output-format stream-json أحداث محددة بخط جديد. خوادم MCP تذهب في ~/.gemini/settings.json. gemini extensions install يأخذ عنوان URL GitHub أو مسار محلي. حصص Free-tier لا تُنسخ هنا. أرسل README مستخدمي غير مدفوع إلى Antigravity بدلاً من سرد رقم.

أنماط ستعيد استخدامها

• تطبيق Python جديد: google-genai، Interactions، gemini-3.8-flash أو gemini-4-argon، مفتاح فقط في البيئة.
• prompt فريق قابل لإعادة الاستخدام: Gem بالتعليمات وملف Drive، حتى نقل November 2026 skills على الحسابات الشخصية.
• “اقرأ كل شيء واكتب تقرير”: Deep Research، ثم عدّل الخطة قبل Start research.
• أداة ملف واحد أو وثيقة قصيرة: Canvas، ثم تصدير أو نسخ النتيجة من الجانب حتى لا يمكن لـ refresh أكل تاريخ لوحة جانب Docs.
• مسودة Workspace: Ask Gemini في Gmail أو Docs، ثم أدرج النصوص. لا تترك النسخة الوحيدة في لوحة جانبية.
• بحث يجب أن تأشر: Deep Research أو Perplexity، ثم افتح الروابط.
• حلقة طرفية على repo: Gemini CLI أو Antigravity CLI، حسب ملاحظة 18 يونيو 2026 في README. أدوات MCP هي نقطة الامتداد. انظر MCP servers explained.
• pin الإنتاج: معرف نموذج مستقر من الجدول أعلاه، وليس gemini-flash-latest.

الأسئلة الشائعة

كيف أستدعي Gemini API من Python في مشروع جديد؟

ركب google-genai، أنشئ مفتاح API في Google AI Studio، وصدّره كـ GEMINI_API_KEY. دليل البدء يستخدم Interactions API: genai.Client() ثم client.interactions.create برقم نموذج وسلسلة إدخال. اعتبارًا من يونيو 2026، يسمي هذا الدليل Interactions الافتراضي. generateContent هي السطح الموروث.

أي نموذج Gemini يجب أن يستخدمه التطبيق الجديد؟

صفحة النماذج، آخر تحديث في 22 أكتوبر 2026، تشير العمل الجديد إلى النماذج الحالية مثل gemini-3.8-flash أو gemini-4-argon. يقول نماذج Gemini 2.5 تبقى متاحة للأشخاص الذين استخدموها بالفعل، ويخبر المشاريع الجديدة باستخدام 3.5 Flash-Lite أو 3.8 Flash بدلاً من ذلك. اشدد معرف مستقر. لا تشحن على آخر اسم مستعار ما لم تقبل تبديل النموذج الصامت.

ما الفرق بين Gem و Deep Research؟

Gem هو اسم محفوظ وتعليمات وملفات معرفة اختيارية تعيد استخدامها من قائمة Gems. Deep Research يبني خطة، ثم تقرير من المصادر التي تختارها، بما في ذلك Google Search بشكل افتراضي. صفحة مساعدة Gems تقول أنه بدءًا من نوفمبر 2026، Gems على حسابات Google الشخصية تنتقل إلى skills.

هل Gemini CLI لا يزال أداة الطرفية للتثبيت؟

ملف تعريف Gemini CLI README لا يزال يوثق npm install -g @google/gemini-cli و GEMINI_API_KEY من AI Studio. نفس README يقول أنه في 18 يونيو 2026، تم استبدال Gemini CLI بـ Antigravity CLI لمستخدمي طبقة غير مدفوع والإصدار الواحد من Google، وأن Gemini CLI لم يتم تحسينه لـ Gemini 4 Argon. اقرأ هذه الملاحظة قبل توحيد هذا.