Method: projects.defaultLocation.finalize

تضبط هذه السياسة موقع مورد Google Cloud Platform (GCP) التلقائي في FirebaseProject المحدَّد.

تنشئ هذه الطريقة تطبيق App Engine باستخدام حزمة Cloud Storage التلقائية متوفّرة في locationId المحدَّد. ويجب أن يكون هذا الموقع الجغرافي أحد مواقع موارد GCP المتاحة.

بعد الانتهاء من الموقع التلقائي لمورد Google Cloud Platform، أو إذا سبق ضبطه، لا يمكن تغييره. قد يكون الموقع التلقائي لمورد Google Cloud Platform FirebaseProject المحدد قد تم ضبطه من قبل لأن Project GCP الأساسي سبق أن تم تطبيق App Engine عليه أو أن defaultLocation.finalize تم استدعاءه سابقًا بواسطة locationId محدد. وفي حال إرسال أي طلبات جديدة إلى defaultLocation.finalize باستخدام locationId مختلف محدّد، ستظهر رسالة الخطأ 409.

نتيجة هذه المكالمة هي Operation، يمكن استخدامها لتتبُّع عملية توفير المتطلبات اللازمة. النوع response من Operation هو google.protobuf.Empty.

يمكن البحث عن Operation من خلال name باستخدام operations.get حتى قيمة done صحيحة. عندما تكون القيمة done صحيحة، تكون قيمة Operation إما ناجحة أو لم تنجح. إذا نجحت السمة Operation، سيتم ضبط response على google.protobuf.Empty. إذا فشلت Operation، سيتمّ ضبط error على google.rpc.Status. يتم حذف Operation تلقائيًا بعد الانتهاء، لذلك لا داعي للاتصال بـ operations.delete.

ويجب إدراج جميع الحقول المدرَجة في نص الطلب.

للاتصال بـ defaultLocation.finalize، يجب أن يكون العضو مالكًا للمشروع.

طلب HTTP

POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}/defaultLocation:finalize

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

اسم مورد FirebaseProject الذي سيتم ضبط الموقع التلقائي لمورد Google Cloud له بالتنسيق:

projects/PROJECT_IDENTIFIER

راجِع الحقل FirebaseProject name للحصول على تفاصيل حول قيم PROJECT_IDENTIFIER.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "locationId": string
}
الحقول
locationId

string

رقم تعريف الموقع الجغرافي التلقائي لموارد Google Cloud Platform للمشروع. يجب أن يكون الموقع الجغرافي أحد مواقع موارد GCP المتاحة.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.