درباره مکان‌های محصولات و منابع در پروژه‌تان بیشتر بدانید

محصولات یا منابعی که به تنظیم مکان نیاز دارند

چندین محصول یا منبع به تنظیم مکان نیاز دارند.

محصول مکان پیش‌فرض اطلاعات تکمیلی
Firebase AI Logic
  • برای Gemini Developer API: انتخاب مکان ممکن نیست؛ همیشه جهانی است.
  • برای Agent Platform Gemini API (formerly Vertex AI): اگر مکان تنظیم نشده باشد، منطقه پیش‌فرض us-central1 است.
این مکان جایی است که به مدل دسترسی پیدا می‌کنید.
Google Analytics مکان پیش‌فرضی وجود ندارد.
باید این مکان را تنظیم کنید. 		این مکان، مکان گزارش‌دهی Analytics۲ است که نشان‌دهنده کشور یا منطقه سازمان شما است. Analytics شما مکان گزارش‌دهی، به‌نوبه خود، واحد پول را برای گزارش‌دهی درآمد تنظیم می‌کند.
Firebase App Hosting مکان پیش‌فرضی وجود ندارد.
باید این مکان را برای هر باطن تنظیم کنید. 		این مکان جایی است که استقرار App Hosting هریک از منابع پسین شما را ایجاد می‌کند.
هر باطن می‌تواند در مکان متفاوتی باشد.
Firebase SQL Connect مکان پیش‌فرضی وجود ندارد.
باید مکان را برای هر نمونه تنظیم کنید. 		هر نمونه می‌تواند در مکان متفاوتی باشد.
Cloud Firestore ۱ مکان پیش‌فرضی وجود ندارد.
باید مکان را برای هر نمونه تنظیم کنید. 		هر نمونه می‌تواند در مکان متفاوتی باشد.
Firebase Realtime Database مکان پیش‌فرضی وجود ندارد.
باید مکان را برای هر نمونه تنظیم کنید. 		هر نمونه می‌تواند در مکان متفاوتی باشد.
Cloud Storage for Firebase ۱ مکان پیش‌فرضی وجود ندارد.
باید مکان را برای هر دسته تنظیم کنید. 		هر سطل می‌تواند در مکان متفاوتی باشد.
Cloud Functions for Firebase ۱ اگر مکان تنظیم نشده باشد، منطقه پیش‌فرض us-central1 است. هر تابع می‌تواند در مکان متفاوتی باشد.

۱ بسته به اینکه چه زمانی برای اولین‌بار استفاده از این محصولات را در پروژه‌تان شروع کرده‌اید، ممکن است وابستگی‌های مکانی بین این محصولات وجود داشته باشد. ممکن است ببینید که به این وابستگی با عنوان «مکان منابع پیش‌فرض Google Cloud» اشاره شده است. درباره این وابستگی مکانی بیشتر بدانید.

۲ مکان گزارش‌دهی Analytics شما بر جایی که Google ممکن است داده‌های مشتری برای Firebase را پردازش و ذخیره کند تأثیری ندارد.

تنظیم مکان برای محصول یا منابع آن

برای چند محصول، مکان را در سطح محصول تنظیم می‌کنید. بااین‌حال، برای اکثر محصولات، مکان را در سطح منبع تنظیم می‌کنید (برای مثال، برای هر دسته Cloud Storage یا هر تابع).

محصول زمان و نحوه تنظیم مکان مکان‌های دردسترس
Firebase AI Logic
  • برای Gemini Developer API: انتخاب مکان ممکن نیست؛ همیشه جهانی است.
  • برای Agent Platform Gemini API (formerly Vertex AI): وقتی Agent Platformسرویس پس‌بک را در پایگاه کد خود مقداردهی اولیه می‌کنید، می‌توانید به‌طور اختیاری مکانی را برای دسترسی به مدل مشخص کنید.
    اگر مکانی را مشخص نکنید، منطقه پیش‌فرض us-central1 است.
Firebase AI Logic مکان
Google Analytics وقتی Google Analytics را در پروژه Firebase خود در کنسول Firebase فعال می‌کنید، از شما خواسته می‌شود مکان گزارش Analytics را انتخاب کنید. باید کشور یا منطقه‌ای را انتخاب کنید که نشان‌دهنده مکان سازمانتان باشد.

اگر «مالک» یا «ویرایشگر» پروژه هستید، می‌توانید بعداً منطقه زمانی و واحد پول را برای مکان گزارش‌دهی Analytics ویرایش کنید؛ به تنظیمات Google Analytics بروید، سپس به بخش گزارش‌دهی بروید.

فهرست را در تنظیمات Google Analytics > قاب گزارش تخلف ببینید.
Firebase App Hosting وقتی باطن App Hosting ایجاد می‌کنید، از شما خواسته می‌شود مکانی را انتخاب کنید. می‌توانید از کنسول Firebase، REST API، یا Firebase CLI برای ایجاد پس‌بخش استفاده کنید. App Hosting مکان
Firebase SQL Connect وقتی نمونه سرویس SQL Connect را تدارک می‌بینید، مکان‌های آن را تنظیم می‌کنید. همچنین مکان نمونه Google Cloud SQL مرتبط را تنظیم می‌کنید.
می‌توانید از کنسول Firebase یا میانای خط فرمان Firebase برای تدارک دیدن نمونه استفاده کنید. 		SQL Connect سرویس و Cloud SQL مکان نمونه
Cloud Firestore ۱ وقتی نمونه پایگاه داده Cloud Firestore را تدارک می‌بینید، مکان آن را تنظیم می‌کنید. می‌توانید از کنسول Firebase، میانای برنامه‌سازی کاربردی REST،‏ Firebase CLI، یا Terraform برای تدارک نمونه استفاده کنید. Cloud Firestore مکان
Firebase Realtime Database وقتی نمونه Realtime Database را تدارک می‌بینید، مکان آن را تنظیم می‌کنید.
می‌توانید از کنسول Firebase، میانای برنامه‌سازی کاربردی REST،‏ Firebase CLI، یا Terraform برای تدارک نمونه استفاده کنید. 		Realtime Database مکان
Cloud Storage for Firebase ۱ وقتی مخزن Cloud Storage را تأمین می‌کنید، مکان آن را تنظیم می‌کنید.
می‌توانید از کنسول Firebase، REST API، یا Terraform برای تدارک سبد استفاده کنید. 		Cloud Storage for Firebase مکان
Cloud Functions for Firebase ۱ وقتی تابعی می‌نویسید، می‌توانید به‌طور اختیاری منطقه آن را تنظیم کنید.

اگر مکانی را مشخص نکنید، منطقه پیش‌فرض us-central1 است.

Cloud Functions for Firebase مکان

۱ بسته به اینکه چه زمانی برای اولین‌بار استفاده از این محصولات را در پروژه‌تان شروع کرده‌اید، ممکن است وابستگی‌های مکانی بین این محصولات وجود داشته باشد. ممکن است ببینید که به این وابستگی با عنوان «مکان منابع پیش‌فرض Google Cloud» اشاره شده است. درباره این وابستگی مکانی بیشتر بدانید.

مشاهده تنظیمات مکان

محصول کجا تنظیم مکان را مشاهده کنید
Firebase AI Logic
  • برای Gemini Developer API: انتخاب مکان ممکن نیست؛ همیشه جهانی است.
  • برای Agent Platform Gemini API (formerly Vertex AI): در پایگاه کدتان، به‌دنبال مقداردهی اولیه سرویس پس‌بخش Agent Platform بگردید. اگر مکانی مشخص نشده باشد، مکان پیش‌فرض us-central1 است.
Google Analytics در کنسول Firebase، به تنظیمات تنظیمات پروژه > ادغام‌ها > Google Analytics بروید. روی شماره حساب کلیک کنید تا حساب Google Analytics شما باز شود، سپس به پانل سرپرست بروید تا اطلاعات مکان حسابتان را پیدا کنید.
Firebase App Hosting
  • در کنسول Firebase، به صفحه App Hosting بروید تا فهرست پس‌زمینه‌ها و مکان‌های آن‌ها را مشاهده کنید.
  • برای مشاهده مکان یک پسای خاص، می‌توانید از فرمان CLI Firebase firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID استفاده کنید
Firebase SQL Connect در کنسول Firebase، به صفحه SQL Connect بروید تا فهرست نمونه‌های پایگاه داده و مکان‌های آن‌ها را مشاهده کنید.
Cloud Firestore در کنسول Firebase، به Cloud Firestore برگه داده بروید تا فهرست نمونه‌های پایگاه داده و مکان‌های آن‌ها را مشاهده کنید.
Firebase Realtime Database در کنسول Firebase، به Realtime Database برگه داده بروید تا فهرست نمونه‌های پایگاه داده و مکان‌های آن‌ها را مشاهده کنید.
Cloud Storage for Firebase در کنسول Firebase، به برگه Cloud Storage فایل‌ها بروید تا فهرست دسته‌ها و مکان‌های آن‌ها را مشاهده کنید.
Cloud Functions for Firebase
  • توابع زمان‌بندی‌شده: در کنسول Google Cloud، به Cloud Scheduler بروید تا فهرست موضوعات هر شغل و تابع را مشاهده کنید. مکان، آخرین بخش در نام موضوع است.
  • توابع زمان‌بندی‌نشده: در کد منبع تابع، به‌دنبال پارامتر region بگردید. اگر منطقه‌ای مشخص نشده باشد، مکان پیش‌فرض us-central1 است.

وابستگی‌های احتمالی مکان به‌دلیل «مکان برای منابع پیش‌فرض Google Cloud»

«مکان منابع پیش‌فرض Google Cloud» تنظیم مکان برای هر منبع پروژه مرتبط با Google App Engine است، ازجمله موارد زیر:

  • نمونه پایگاه داده پیش‌فرض Cloud Firestore
  • Cloud Storage پیش‌فرض برای دسته Firebase با قالب نام *.appspot.com
  • Google Cloud Scheduler به‌طور خاص با توابع زمان‌بندی‌شده نسل اول استفاده می‌شود

این «مکان برای منابع پیش‌فرض Google Cloud» تنظیمی تغییرناپذیر است. همچنین، وقتی مکان را برای یکی از منابع مرتبط تنظیم می‌کنید، به‌طور غیرمستقیم مکان را برای همه آن‌ها به‌دلیل ارتباط مشترکشان با App Engine تنظیم می‌کنید.

بااین‌حال، با تغییرات زیادی که در طول سال‌ها در Firebase و بوم‌سازگان Google Cloud ایجاد شده است، ارتباط منابع با App Engine درحال تغییر بوده است. به‌ویژه، از ۳۰ اکتبر ۲۰۲۴، همه Cloud Storage پیش‌فرض جدیداً ارائه‌شده برای دسته‌های Firebase قالب نام *.firebasestorage.app دارند و با App Engine مرتبط نیستند.

جزئیات تغییرات در وابستگی‌های احتمالی مکان در اینجا آمده است:

  • از ۳۰ اکتبر ۲۰۲۴، اگر نمونه پیش‌فرض Cloud Firestore و Cloud Storage پیش‌فرض برای سطل Firebase هنوز آماده‌سازی نشده باشد:

    • تأمین نمونه پیش‌فرض Cloud Firestore، مکان را برای هر برنامه App Engine که در آینده در پروژه تأمین شود تنظیم می‌کند. بااین‌حال، مکان دسته پیش‌فرض Cloud Storage آینده را تعیین نمی‌کند.

    • آماده‌سازی دسته پیش‌فرض Cloud Storage دیگر App Engine برنامه‌ای را آماده‌سازی نمی‌کند. بنابراین، مکان دسته پیش‌فرض Cloud Storage مکان نمونه پیش‌فرض Cloud Firestore آینده را تعیین نمی‌کند.

  • از ۳۰ اکتبر ۲۰۲۴، اگر نمونه پیش‌فرض Cloud Firestore قبلاً تأمین شده باشد، اما Cloud Storage پیش‌فرض برای دسته Firebase تأمین نشده باشد:

    • نمونه پیش‌فرض Cloud Firestore موجود، مکان دسته پیش‌فرض Cloud Storage آینده را تعیین نمی‌کند (*.firebasestorage.app).

  • از ۳۰ اکتبر ۲۰۲۴، اگر Cloud Storage پیش‌فرض برای سطل Firebase قبلاً تأمین شده باشد (به‌طور خاص، سطل *.appspot.com)، اما نمونه Cloud Firestore پیش‌فرض تأمین نشده باشد:

    • وقتی دسته پیش‌فرض Cloud Storage (*.appspot.com) تأمین شد، برنامه App Engine نیز تأمین شد، و بنابراین مکان نمونه پیش‌فرض آینده Cloud Firestore در آن زمان تنظیم شد. حتی اگر دسته *.appspot.com را حذف کنید، نمی‌توانید برنامه App Engine را حذف کنید، بنابراین تنظیم مکان نمونه پیش‌فرض آینده Cloud Firestore ازقبل تنظیم شده است.

اگر از توابع زمان‌بندی‌شده نسل اول استفاده کرده‌اید، مکان آن‌ها روی مکان منابع پیش‌فرض Google Cloud تنظیم شده است. دلیلش این است که Cloud Scheduler و App Engine قبلاً با یکدیگر ارتباط داشته‌اند. همچنین، اگر توابع زمان‌بندی‌شده نسل اول را قبل‌از تأمین منابع دیگری که این تنظیم مکان را هم‌رسانی کرده‌اند راه‌اندازی کرده باشید، مکان آن‌ها را نیز تنظیم کرده‌اید.

مراحل بعدی

  • برای اطلاعات بیشتر درباره ساخت برنامه‌هایی که الزامات تأخیر، دردسترس بودن، و ماندگاری شما را برآورده می‌کنند، به جغرافیا و مناطق مراجعه کنید.