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

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

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

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

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

المنتج	الموقع الجغرافي التلقائي	معلومات إضافية
Google Analytics	لا يتوفّر موقع جغرافي تلقائي. يجب ضبط هذا الموقع الجغرافي.	هذا الموقع الجغرافي هو الموقع الجغرافي لإعداد تقارير Analytics^2، والذي يمثّل بلد مؤسستك أو منطقتها. ويحدِّد الموقع الجغرافي Analytics لإعداد التقارير العملة المستخدَمة في إعداد تقارير الأرباح.
Firebase App Hosting	لا يتوفّر موقع جغرافي تلقائي. يجب ضبط هذا الموقع الجغرافي لكل نظام أساسي.	هذا هو الموقع الجغرافي الذي يتم فيه إنشاء كل موارد الخلفية من خلال عملية App Hosting النشر. يمكن أن يكون لكل نظام أساسي خلفي موقع مختلف.
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 > إعداد التقارير.
App Hosting	عند إنشاء خلفية App Hosting، سيُطلب منك اختيار موقع جغرافي. يمكنك استخدام وحدة تحكّم Firebase أو واجهة برمجة التطبيقات REST API أو Firebase CLI لإنشاء خلفية.	App Hosting موقع جغرافي
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 للاطّلاع على قائمة نُسخ قاعدة البيانات وأماكنها الجغرافية.
App Hosting	في وحدة تحكّم Firebase، انتقِل إلى صفحة App Hosting للاطّلاع على قائمة الخلفيات ومواقعها الجغرافية. لعرض الموقع الجغرافي لخلفية معيّنة، يمكنك استخدام الأمر Firebase CLI firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID
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، لن يؤدي Provisioning (توفير) 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. بالإضافة إلى ذلك، في حال إعداد وظائف مجدوَلة من الجيل الأول قبل توفير موارد أخرى تشارك إعداد الموقع الجغرافي هذا، يمكنك عندئذٍ تحديد موقعها الجغرافي أيضًا.

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

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