رفتن به متن مستندات
✦ایران جمینایمستندات فارسی Gemini
۲۶۸ صفحهٔ کامل فارسینسخهٔ فارسی ذخیره‌شده · دریافت 2026-09-29 · ۱۳ پیوند نامعتبر در منبع
پوشش مجموعه

عدم نیاز به نگهداری داده‌ها در رابط برنامه‌نویسی کاربردی توسعه‌دهندگان Gemini

آخرین به‌روزرسانی منبع: 2026-09-16منبع Google

این متن دربارهٔ API رسمی Google است. نمونه‌کدها و آدرس‌ها بدون تغییر فنی حفظ شده‌اند؛ همهٔ امکانات Google الزاماً در API پل ایران‌جمینای ارائه نمی‌شوند. برای اتصال به پل، راهنمای «مستندات اتصال» فضای کاری را ببینید.

این صفحه جزئیات چیزی را شرح می‌دهد که معمولاً در رابط برنامه‌نویسی کاربردی توسعه‌دهندگان Gemini به عنوان «نگهداری صفر داده» از آن یاد می‌شود.

محدودیت آموزش

همانطور که در شرایط خدمات Gemini API ذکر شده است، وقتی از سرویس‌های پولی استفاده می‌کنید، گوگل از درخواست‌های شما (از جمله دستورالعمل‌های سیستمی مرتبط، محتوای ذخیره‌شده و فایل‌هایی مانند تصاویر، ویدیوها یا اسناد) یا پاسخ‌های شما برای بهبود محصولات ما استفاده نمی‌کند. سرویس‌های پولی در اینجا تعریف شده‌اند.

حفظ داده‌های مشتری و دستیابی به صفر درصد حفظ داده‌ها

داده‌های مشتری معمولاً در سناریوها و شرایط زیر برای مدت زمان محدودی نگهداری می‌شوند. برای دستیابی به عدم نیاز به نگهداری داده‌ها، مشتریان باید اقدامات خاصی را انجام دهند یا از ویژگی‌های خاصی در هر یک از این حوزه‌ها اجتناب کنند:

  • ثبت سریع برای نظارت بر سوءاستفاده : همانطور که در شرایط خدمات اضافی Gemini API ذکر شده است، برای سرویس‌های پولی، گوگل اعلان‌ها و پاسخ‌ها را برای مدت زمان محدودی صرفاً برای تشخیص نقض خط‌مشی استفاده ممنوع ثبت می‌کند. اگر حجم کاری شما نیاز به تضمین عدم نگهداری داده‌ها یا توافق‌نامه‌های پردازش داده‌های سازمانی دارد، از Vertex AI استفاده کنید. برای جزئیات بیشتر، به Gemini Enterprise Agent Platform و عدم نگهداری داده‌ها مراجعه کنید.

  • اتصال به زمین با جستجوی گوگل : همانطور که در شرایط خدمات اضافی Gemini API ذکر شده است، گوگل اعلان‌ها، اطلاعات زمینه‌ای و خروجی تولید شده را به مدت سی (30) روز برای ایجاد نتایج اتصال به زمین و پیشنهادات جستجو ذخیره می‌کند. این اطلاعات ذخیره شده ممکن است برای اشکال‌زدایی و آزمایش سیستم‌هایی که از اتصال به زمین پشتیبانی می‌کنند، استفاده شود. در صورت استفاده از اتصال به زمین با جستجوی گوگل، هیچ راهی برای غیرفعال کردن ذخیره این اطلاعات وجود ندارد.

  • اتصال به زمین با نقشه‌های گوگل : همانطور که در شرایط خدمات اضافی Gemini API ذکر شده است، گوگل اعلان‌ها، اطلاعات زمینه‌ای و خروجی تولید شده را به مدت سی (30) روز برای ایجاد نتایج اتصال به زمین ذخیره می‌کند. این اطلاعات ذخیره شده فقط می‌تواند برای مهندسی قابلیت اطمینان، مانند اشکال‌زدایی در صورت بروز مشکلات سرویس، استفاده شود. در صورت استفاده از اتصال به زمین با نقشه‌های گوگل، هیچ راهی برای غیرفعال کردن ذخیره این اطلاعات وجود ندارد.

  • API تعاملات : API تعاملات، وضعیت فعال یک مکالمه را مدیریت می‌کند تا چرخش‌های چندگانه را فعال کند. به طور پیش‌فرض، API تعاملات، ذخیره‌سازی وضعیت را فعال می‌کند . برای اطمینان از عدم وجود ردپای داده، باید در درخواست‌های API خود، پارامتر store به طور صریح روی false تنظیم کنید تا از حفظ وضعیت پیش‌فرض خودداری کنید.

  • Live API : این API با قابلیت ذخیره وضعیت مکالمه، امکان اتصال مجدد در لحظه را با ذخیره وضعیت مکالمه فراهم می‌کند. برای دستیابی به عدم نیاز به نگهداری داده‌ها، SessionResumptionConfig را پیکربندی نکنید . اگر یک session handle ایجاد شود، وضعیت مکالمه (شامل متن، صدا و تصویر) تا 24 ساعت حفظ می‌شود.

  • ذخیره‌سازی API فایل : API فایل به کاربران امکان آپلود فایل‌های حجیم را می‌دهد. فایل‌ها تا زمانی که توسط کاربر حذف نشوند یا منقضی نشوند، در حالت سکون ذخیره می‌شوند. استفاده از API فایل مستقل از ثبت وقایع ZDR است؛ کاربران باید فایل‌ها را به صورت دستی حذف کنند تا از ردپای صفر داده اطمینان حاصل شود.

  • ذخیره‌سازی صریح متن : کاربران می‌توانند مجموعه داده‌های بزرگ (مثلاً ویدیوهای طولانی یا کتابخانه‌های اسناد) را با استفاده از فیلد cached_content به صورت دستی ذخیره کنند. در حالی که گزارش‌های این درخواست‌ها از سیاست‌های حذف ZDR پیروی می‌کنند، خود متن ذخیره شده با یک ttl یا expire_time تعریف شده توسط کاربر ذخیره می‌شود. برای دستیابی به ردپای مطلق صفر داده، از ویژگی cached_content استفاده نکنید.

  • ذخیره‌سازی ضمنی در حافظه : به طور پیش‌فرض، Gemini داده‌ها را در حافظه پنهان می‌کند تا تأخیر و هزینه را برای توسعه‌دهندگان کاهش دهد. این داده‌ها کاملاً در RAM (نه در حالت استراحت) هستند، در سطح پروژه ایزوله شده‌اند و دارای TTL 24 ساعته هستند. این امر، اصل حفظ صفر داده‌ها را نقض نمی‌کند.

قدم بعدی چیست؟

پوشش و وضعیت مجموعه

تمام صفحات HTML راهنماهای /gemini-api/docs و مرجع /api در نقشهٔ سایت رسمی Google، همراه پیوندهای داخلی مقالات؛ متن کامل فارسی و نمونه‌کدها. کتاب‌های آموزشی GitHub، گالری پرامپت، منابع خارجی، آرشیو قراردادهای حقوقی و رسانه‌های دارای مجوز جداگانه جزو بازنشر این مجموعه نیستند.

۲۶۸ صفحه از ۲۸۱ نشانی فهرست‌شده. نشانی‌های قدیمی ممکن است به محتوای یکسان هدایت شوند؛ تعداد بالا تعداد نشانی‌هاست، نه تعداد موضوعات یکتا. این مجموعه نسخهٔ ذخیره‌شده است و به‌روزرسانی زنده نیست.

۱۳ پیوند منبع که متن کامل آن قابل دریافت نیست