منابع Firebase را به Project
Google Cloud Platform (GCP) مشخص شده اضافه می کند.
از آنجایی که FirebaseProject
در واقع یک Project
GCP نیز هست، یک FirebaseProject
دارای شناسههای زیرین GCP است ( projectNumber
و projectId
). این امکان تعامل آسان با API های Google را فراهم می کند.
نتیجه این تماس یک Operation
است. Operation
را نظرسنجی کنید تا فرآیند تهیه را با فراخوانی operations.get
پیگیری کنید تا زمانی که done
true
باشد. هنگامی که done
true
باشد، Operation
یا موفق شده یا شکست خورده است. اگر Operation
موفقیت آمیز باشد، response
آن به FirebaseProject
تنظیم می شود. اگر Operation
ناموفق باشد، error
آن روی google.rpc.Status
تنظیم می شود. Operation
پس از اتمام به طور خودکار حذف می شود، بنابراین نیازی به فراخوانی operations.delete
نیست.
این روش هیچ اطلاعات حساب صورتحساب Project
GCP زیربنایی را تغییر نمیدهد.
برای فراخوانی projects.addFirebase
، یک عضو پروژه یا حساب سرویس باید مجوزهای زیر را داشته باشد (نقش IAM ویرایشگر و مالک شامل این مجوزها است): firebase.projects.update
، resourcemanager.projects.get
، serviceusage.services.enable
، و serviceusage.services.get
.
درخواست HTTP
POST https://firebase.googleapis.com/v1beta1/{project=projects/*}:addFirebase
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
project | نام منبع برای جزئیات بیشتر در مورد مقادیر PROJECT_IDENTIFIER به قسمت پس از فراخوانی |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "locationId": string } |
زمینه های | |
---|---|
locationId | منسوخ. در عوض، برای تنظیم موقعیت مکانی منبع GCP پیشفرض پروژه، پس از افزودن منابع Firebase به شناسه مکان پیشفرض منبع GCP پروژه. مکان باید یکی از مکانهای موجود منبع GCP باشد. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation
است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/cloud-platform
-
https://www.googleapis.com/auth/firebase
برای اطلاعات بیشتر، به نمای کلی احراز هویت مراجعه کنید.