التعرّف على المواقع الجغرافية للمنتجات والموارد في مشروعك

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

يُرجى العلم أنّ بعض منتجات Firebase وموارده لا تتيح اختيار الموقع الجغرافي. يمكنك أيضًا اختياريًا ضبط قيود على المواقع الجغرافية على مستوى المؤسسة للمنتجات والموارد التي تتيح اختيار الموقع الجغرافي.

المنتجات أو الموارد التي تتطلّب ضبط الموقع الجغرافي

تتطلّب العديد من المنتجات أو المراجع ضبط الموقع الجغرافي.

المنتج	الموقع الجغرافي التلقائي	معلومات إضافية
Google Analytics	ما مِن موقع جغرافي تلقائي. يجب ضبط هذا الموقع الجغرافي.	هذا الموقع الجغرافي هو الموقع الجغرافي لإعداد تقارير Analytics^2، والذي يمثّل بلد مؤسستك أو منطقتها. وبالتالي، يحدّد الموقع الجغرافي لإعداد التقارير في Analytics العملة المستخدمة في تقارير الأرباح.
Data Connect	لا يتوفّر موقع جغرافي تلقائي. يجب ضبط الموقع الجغرافي لكل مثيل.	يمكن أن تكون كلّ نسخة في موقع جغرافي مختلف.
Cloud Firestore ^1	لا يتوفّر موقع جغرافي تلقائي. يجب ضبط الموقع الجغرافي لكل مثيل.	يمكن أن تكون كلّ نسخة في موقع جغرافي مختلف.
Realtime Database	ما مِن موقع جغرافي تلقائي. يجب ضبط الموقع الجغرافي لكل مثيل.	يمكن أن تكون كلّ نسخة في موقع جغرافي مختلف.
Cloud Storage for Firebase ^1	لا يتوفّر موقع جغرافي تلقائي. عليك ضبط الموقع الجغرافي لكل مجموعة.	يمكن أن يكون لكل حزمة موقع مختلف.
Cloud Functions for Firebase ^1	إذا لم يتم ضبط الموقع الجغرافي، ستكون المنطقة التلقائية هي us-central1.	يمكن أن تكون كل دالة في موقع مختلف.
Vertex AI in Firebase	إذا لم يتم ضبط الموقع الجغرافي، تكون المنطقة التلقائية هي us-central1.	هذا الموقع هو المكان الذي يتم فيه تشغيل خدمة Vertex AI وحيث يمكنك الوصول إلى النموذج.

¹ استنادًا إلى وقت بدء استخدام هذه المنتجات في مشروعك، قد تكون هناك تبعيات مرتبطة بالموقع الجغرافي بين هذه المنتجات. قد تتم الإشارة إلى هذه التبعية باسم "الموقع الجغرافي لموارد Google Cloud التلقائية". تعرَّف على المزيد من المعلومات حول تبعية الموقع الجغرافي هذه.

² لا يؤثّر موقع الإبلاغ عن Analytics في مكان معالجة Google و تخزينها لبيانات العملاء في Firebase.

تحديد موقع جغرافي لمنتج أو موارده

يمكنك ضبط الموقع الجغرافي على مستوى المنتج في بعض المنتجات. ومع ذلك، في معظم المنتجات، يمكنك ضبط الموقع الجغرافي على مستوى المورد (على سبيل المثال، لكل ملف شخصي Cloud Storage أو كل دالة).

المنتج	حالات ضبط الموقع الجغرافي وكيفية ضبطه	المواقع الجغرافية المتاحة
Google Analytics	عند تفعيل Google Analytics في مشروع Firebase ضمن وحدة تحكّم Firebase، سيُطلب منك اختيار موقع جغرافي لإعداد التقارير في "إحصاءات Google". عليك اختيار بلد أو منطقة تمثّل الموقع الجغرافي لمؤسستك. إذا كنت مالكًا أو محرِّرًا للمشروع، يمكنك لاحقًا تعديل المنطقة الزمنية والعملة للموقع الجغرافي لإعداد تقارير "إحصاءات Google". انتقِل إلى إعدادات Google Analytics، ثم انتقِل إلى اللوحة إعداد التقارير.	اطّلِع على القائمة في pane إعدادات Google Analytics > إعداد التقارير .
Data Connect	عند توفير مثيل خدمة Data Connect، يتم ضبط مواقعه الجغرافية. ويمكنك أيضًا ضبط الموقع الجغرافي لمثيل Google Cloud SQL المرتبط. يمكنك استخدام وحدة تحكّم Firebase أو Firebase CLI لتوفير مثيل.	خدمة Data Connect وCloud SQL موقع جغرافي للمثيل
Cloud Firestore ^1	عند توفير مثيل قاعدة بيانات Cloud Firestore، يمكنك ضبط موقعه. يمكنك استخدام وحدة تحكّم Firebase أو واجهة برمجة التطبيقات REST API أو Firebase CLI أو Terraform لتوفير مثيل.	Cloud Firestore موقع جغرافي
Realtime Database	عند توفير مثيل Realtime Database، يمكنك تحديد موقعه الجغرافي. يمكنك استخدام وحدة التحكّم Firebase أو REST API أو Firebase CLI أو Terraform لتوفير مثيل.	Realtime Database موقع جغرافي
Cloud Storage for Firebase ^1	عند إدارة حزمة Cloud Storage، يمكنك ضبط موقعها. يمكنك استخدام وحدة التحكّم Firebase أو REST API أو Terraform لتوفير حزمة.	Cloud Storage for Firebase موقع جغرافي
Cloud Functions for Firebase ^1	عند كتابة دالة، يمكنك اختياريًا تعيين منطقتها. إذا لم تحدِّد موقعًا جغرافيًا، ستكون المنطقة التلقائية هي us-central1.	Cloud Functions for Firebase موقع جغرافي
Vertex AI in Firebase	عند بدء خدمة Vertex AI والنموذج التوليدي في القاعدة البرمجية، يمكنك اختياريًا تحديد موقع جغرافي. إذا لم تحدِّد موقعًا جغرافيًا، ستكون المنطقة التلقائية هي us-central1.	Vertex AI in Firebase موقع جغرافي

¹ استنادًا إلى وقت بدء استخدام هذه المنتجات في مشروعك، قد تكون هناك تبعيات مرتبطة بالموقع الجغرافي بين هذه المنتجات. قد تتم الإشارة إلى هذه التبعية باسم "الموقع الجغرافي لموارد Google Cloud التلقائية". اطّلِع على مزيد من المعلومات عن الاعتماد على الموقع الجغرافي.

عرض إعدادات الموقع الجغرافي

المنتج	مكان عرض إعدادات الموقع الجغرافي
Google Analytics	في وحدة تحكّم Firebase، انتقِل إلى الإعدادات إعدادات المشروع > عمليات الدمج > Google Analytics. انقر على رقم الحساب لفتح حسابك على Google Analytics، ثم انتقِل إلى لوحة المشرف للاطّلاع على معلومات الموقع الجغرافي لحسابك.
Data Connect	في وحدة تحكّم Firebase، انتقِل إلى صفحة Data Connect لعرض قائمة مثيلات قاعدة البيانات ومواقعها الجغرافية.
Cloud Firestore	في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب Cloud Firestore البيانات للاطّلاع على قائمة نُسخ قاعدة البيانات ومواقعها الجغرافية.
Realtime Database	في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب Realtime Database البيانات لعرض قائمة بمثيلات قاعدة البيانات ومواقعها الجغرافية.
Cloud Storage for Firebase	في وحدة تحكّم Firebase، انتقِل إلى Cloud Storage علامة التبويب الملفات للاطّلاع على قائمة حِزمك ومواقعها الجغرافية.
Cloud Functions for Firebase	الدوال المُجدوَلة: في وحدة تحكّم Google Cloud، انتقِل إلى Cloud Scheduler للاطّلاع على قائمة المواضيع لكلّ مهمة ودالة. الموقع الجغرافي هو الجزء الأخير في اسم الموضوع. الدوالّ غير المُجدوَلة: ابحث عن مَعلمة region في رمز الدالة المصدر. إذا لم يتم تحديد منطقة، سيكون الموقع الجغرافي التلقائي هو us-central1.
Vertex AI in Firebase	في قاعدة الرموز البرمجية، ابحث عن إعداد خدمة Vertex AI والنموذج التوليدي. إذا لم يتم تحديد موقع جغرافي، يكون الموقع الجغرافي التلقائي هو us-central1.

احتمالات تابعة للموقع الجغرافي بسبب "موقع موارد Google Cloud التلقائية"

"الموقع الجغرافي لموارد Google Cloud التلقائية" هو إعداد الموقع الجغرافي لأي موارد مشروع مرتبطة بخدمة Google App Engine، بما في ذلك ما يلي:

• مثيل قاعدة بيانات Cloud Firestore التلقائي
• حزمة Cloud Storage التلقائية لبرنامج Firebase بتنسيق الاسم *.appspot.com
• Google Cloud Scheduler المستخدَمة تحديدًا مع الدوالّ المُجدوَلة من الجيل الأول

ملاحظة: لا تشترك أي من الموارد الأخرى في مشروعك في هذا الاعتماد على الموقع الجغرافي، بما في ذلك ما يلي: نُسخ "قاعدة بيانات الوقت الفعلي"، ونُسخ Cloud Firestore غير التلقائية، ومستودعات Cloud Storage غير التلقائية، ومستودعات Cloud Storage التلقائية بتنسيق الاسم *.firebasestorage.app، والدوالّ غير المُجدوَلة، والدوالّ المُجدوَلة من الجيل الثاني.

يُعدّ "الموقع الجغرافي لموارد Google Cloud التلقائية" إعدادًا غير قابل للتغيير. بالإضافة إلى ذلك، عند ضبط الموقع الجغرافي لأحد الموارد المرتبطة، يمكنك تحديد الموقع الجغرافي لكل منها بشكل غير مباشر بسبب ارتباطها المشترك بـ App Engine.

مع ذلك، مع إدخال العديد من التغييرات على منظومة Firebase المتكاملة ومنظومة Google Cloud المتكاملة على مدار الأعوام، تغيّرت آليات ربط الموارد بمنصة App Engine. من الجدير بالذكر أنّه اعتبارًا من 30 تشرين الأول (أكتوبر) 2024، ستتضمّن جميع Cloud Storage التلقائية التي تم توفيرها حديثًا لمجموعات Firebase تنسيق الاسم *.firebasestorage.app، ولن تكون مرتبطة بـ App Engine.

نقطة رئيسية: اعتبارًا من 30 تشرين الأول (أكتوبر) 2024، لن يؤدي توفير حزمة "Cloud Storage" لبرنامج Firebase التلقائية إلى ضبط "الموقع الجغرافي لموارد Google Cloud التلقائية" (مثل الموقع الجغرافي لمثيل Cloud Firestore التلقائي للمشروع). بالإضافة إلى ذلك، لم تعُد إدارة حسابات المثيل Cloud Firestore التلقائي تضبط الموقع الجغرافي لحزمة Cloud Storage تلقائية جديدة في Firebase (بتنسيق الاسم *.firebasestorage.app).

في ما يلي تفاصيل التغييرات في تبعيات الموقع الجغرافي المحتملة:

• اعتبارًا من 30 تشرين الأول (أكتوبر) 2024، إذا لم يتم توفير المتطلبات اللازمة لمثيل Cloud Firestore التلقائي والحزمة التلقائية "Cloud Storage لبرنامج Firebase" بعد:

  • يؤدي توفير المتطلبات اللازمة للمثيل التلقائي Cloud Firestore إلى ضبط الموقع الجغرافي لأي تطبيق App Engine مستقبلي تتم إدارته في المشروع. ومع ذلك، لا يحدّد هذا الإجراء موقع حزمة Cloud Storage القادمة التلقائية.

  • لم يعُد توفير حزمة Cloud Storage التلقائية يوفر تطبيق App Engine. وبالتالي، لا يحدّد موقع حزمة Cloud Storage التلقائية الموقع الجغرافي لمثيل Cloud Firestore التلقائي في المستقبل.

• اعتبارًا من 30 تشرين الأول (أكتوبر) 2024، في حال تم توفير مثيل Cloud Firestore التلقائي، ولكن لم يتم توفير Cloud Storage التلقائي لحزمة Firebase:

  • لا يحدد مثيل Cloud Firestore التلقائي الحالي موقع حزمة Cloud Storage التلقائية المستقبلية (*.firebasestorage.app).

• اعتبارًا من 30 تشرين الأول (أكتوبر) 2024، إذا كان قد تم سابقًا توفير 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 بأحدهم ا الآخر. بالإضافة إلى ذلك، في حال إعداد وظائف مجدوَلة من الجيل الأول قبل توفير موارد أخرى تشارك إعداد الموقع الجغرافي هذا، يمكنك عندئذٍ تحديد موقعها الجغرافي أيضًا.

الخطوات التالية

• لمزيد من المعلومات عن إنشاء التطبيقات لتلبية متطلبات وقت الاستجابة ومدى التوفّر والثبات، يُرجى الرجوع إلى المواقع الجغرافية والمناطق.