آشنایی با کلیدهای میانای برنامهسازی کاربردی برای Firebase و مدیریت آنها
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
کلید میانای برنامهسازی کاربردی رشتهای یکتا است که برای مسیریابی درخواستها به پروژه Firebase شما هنگام تعامل با Firebase و سرویسهای Google استفاده میشود. این صفحه اطلاعات پایه درباره کلیدهای میانای برنامهسازی کاربردی و همچنین روالهای مطلوب برای استفاده و مدیریت کلیدهای میانای برنامهسازی کاربردی با برنامههای Firebase را شرح میدهد.
اگر ایمیلی از Google Cloud درباره «کلید Google API با دسترسی عمومی برای پروژه Google Cloud» دریافت کردهاید و کلید API فهرستشده در ایمیل کلید Firebase API شما است، مطمئن شوید که کلید API الزامات زیر را برآورده میکند تا بتوانید آن را بهطور ایمن در کد یا فایلهای پیکربندی خود قرار دهید. میتوانید موارد زیر را در صفحه APIs & Services (میاناهای برنامهسازی کاربردی و سرویسها) >
Credentials (اطلاعات کاربری)
در کنسول Google Cloud درستیسنجی کنید.
این کلید میانای برنامهسازی کاربردی است که برای برنامه Firebase و فقط برای
سرویسهای Firebase استفاده میکنید. این کلیدها معمولاً
Browser key (auto created by Firebase) یا
Android key (auto created by Firebase) یا
iOS key (auto created by Firebase) نامیده میشوند.
هیچ میانای برنامهسازی کاربردی دیگری در فهرست مجاز «محدودیتهای میانای برنامهسازی کاربردی» آن وجود نداشته باشد. بهطور خاص، فهرست نبایدGenerative Language API داشته باشد.
همچنین، مطمئن شوید که از Firebase Security Rules و App Check طبق توصیه
برای محصولات Firebase که استفاده میکنید استفاده میکنید.
بقیه این صفحه اطلاعات دقیقی درباره کلیدهای API برای Firebase و همچنین فهرستی از پرسشگان درباره این کلیدها ارائه میدهد.
اطلاعات کلی درباره کلیدهای میانای برنامهسازی کاربردی و Firebase
کلیدهای میانای برنامهسازی کاربردی برای Firebase با کلیدهای میانای برنامهسازی کاربردی معمولی متفاوت است
برخلاف نحوه استفاده معمول از کلیدهای میانای برنامهسازی کاربردی، کلیدهای میانای برنامهسازی کاربردی برای سرویسهای Firebase
برای کنترل دسترسی به منابع پسبک استفاده نمیشوند؛ این کار فقط با
Firebase Security Rules (برای کنترل اینکه کدام کاربران نهایی میتوانند به منابع دسترسی داشته باشند) و
Firebase App Check (برای کنترل اینکه کدام برنامهها میتوانند به منابع دسترسی داشته باشند) انجام میشود.
معمولاً باید از کلیدهای API بهدقت محافظت کنید (برای مثال،
بااستفاده از سرویس گاوصندوق یا تنظیم کلیدها بهعنوان متغیرهای محیطی)؛ بااینحال،
کلیدهای API برای سرویسهای Firebase را میتوان در کد یا فایلهای پیکربندی
اعلام وضعیت گنجاند.
یک پروژه Firebase میتواند چندین کلید میانای برنامهسازی کاربردی داشته باشد، اما هر کلید میانای برنامهسازی کاربردی فقط میتواند با یک پروژه Firebase مرتبط باشد.
وقتی هریک از کارهای زیر را انجام دهید، Firebase بهطور خودکار کلیدهای میانای API برای پروژهتان ایجاد میکند:
ایجاد پروژه Firebase > Browser key بهطور خودکار ایجاد شد
ایجاد برنامه Firebase Apple > iOS key بهطور خودکار ایجاد شد
ایجاد برنامه Android در Firebase > Android key بهطور خودکار ایجاد شد
همچنین میتوانید کلیدهای میانای API خودتان را در
کنسول Google Cloud ایجاد کنید،
برای مثال برای توسعه یا اشکالزدایی. درباره اینکه چه زمانی ممکن است این مورد توصیه شود
در ادامه این صفحه بیشتر بدانید.
پیدا کردن کلیدهای میانای برنامهسازی کاربردی
میتوانید همه کلیدهای API پروژهتان را در صفحه
میاناهای برنامهسازی کاربردی و سرویسها >
اطلاعات کاربری
در کنسول Google Cloud مشاهده و مدیریت کنید.
برنامههای Firebase Apple — کلید میانای برنامهسازی کاربردی مطابقتدادهشده خودکار را در فایل پیکربندی Firebase، GoogleService-Info.plist، در فیلد API_KEY پیدا کنید.
برنامههای Android در Firebase — کلید میانای برنامهسازی کاربردی منطبقشده خودکار را در فایل پیکربندی Firebase، google-services.json، در فیلد current_key پیدا کنید.
برنامههای وب Firebase — کلید میانای برنامهسازی کاربردی منطبقشده خودکار را در شیء پیکربندی Firebase، در فیلد apiKey پیدا کنید.
استفاده از کلید میانای برنامهسازی کاربردی
کلیدهای میانای برنامهسازی کاربردی برای Firebase برای شناسایی پروژه Firebase شما هنگام
تعامل با Firebase یا سرویسهای Google استفاده میشوند. بهطور خاص، از آنها برای مرتبط کردن درخواستهای API با پروژهتان برای سهمیه و صورتحساب استفاده میشود. این ابزارها برای دسترسی به دادههای عمومی نیز مفید هستند.
برای اکثریت قریب به اتفاق توسعهدهندگان و موارد استفاده، شما مستقیماً با این کلیدهای میانای برنامهسازی کاربردی تعامل ندارید. درعوض، وقتی برنامهتان با Firebase API تماس میگیرد
که به کلید میانای برنامهسازی کاربردی ارائهشده توسط کارخواه وب یا تلفن همراه نیاز دارد، برنامهتان
بهطور خودکار بهدنبال کلید میانای برنامهسازی کاربردی در
پیکربندی Firebase برنامهتان میگردد. این
پیکربندی وقتی برنامهتان را به Firebase متصل کردید به پایگاه کد برنامهتان اضافه شد.
توجه داشته باشید که میتوانید کلید میانای برنامهسازی کاربردی برنامهتان را بااستفاده از سازوکار دیگری،
مثل گزینههای Firebase یا بااستفاده از متغیرهای محیطی، در برنامهتان ارائه دهید.
همچنین، برای برخیاز APIهای REST برای سرویسهای Firebase، ممکن است لازم باشد
مقدار کلید API را بهطور صریح بهعنوان پارامتر پُرسمان به فراخوانی ارسال کنید.
این مثال نشان میدهد که چگونه میتوانید بااستفاده از میانای برنامهسازی کاربردی Firebase Authentication درخواست ارسال کنید:
محدودیتهای مناسب را برای کلیدهای میانای برنامهسازی کاربردی مرور و اعمال کنید
برای همه کلیدهای میانای برنامهسازی کاربردی در پروژهتان، بسیار مهم است که مطمئن شوید
محدودیتها و حدود میانای برنامهسازی کاربردی مناسبی دارند، همانطور که در این بخش شرح داده شده است.
میاناهای برنامهسازی کاربردی را که بهطور خودکار به فهرست مجاز کلیدهای میانای برنامهسازی کاربردی Firebase شما اضافه شدهاند مرور کنید
وقتی Firebase کلید میانای API در پروژهتان ایجاد میکند، ما بهطور خودکار
«محدودیتهای میانای API»
به آن کلید اضافه میکنیم. میاناهای برنامهسازی کاربردی اضافهشده به این فهرست مجاز، میاناهای برنامهسازی کاربردی مرتبط با Firebase هستند که
کارخواه را ملزم میکنند کلید میانای برنامهسازی کاربردی را همراه با تماس ارائه دهد. توجه داشته باشید که اکثر
میاناهای برنامهسازی کاربردی موردنیاز برای استفاده از سرویسهای Firebase درواقع لازم نیست در
فهرست مجاز کلیدهای میانای برنامهسازی کاربردی شما باشند.
ازآنجاییکه Firebase میاناهای برنامهسازی کاربردی لازم را برای همه سرویسهای Firebase اضافه میکند،
فهرست مجاز برای کلید میانای برنامهسازی کاربردی ممکن است شامل میاناهای برنامهسازی کاربردی برای محصولاتی باشد که از آنها استفاده نمیکنید.
میتوانید APIها را از فهرست مجاز حذف کنید، اما باید بسیار مراقب باشید که
APIهای موردنیاز برای Firebase و سرویسهای Firebase را که استفاده میکنید حذف نکنید
(فهرست APIهای مرتبط با Firebase
را که باید در فهرست مجاز برای هر سرویس / محصول باشند ببینید). درغیراینصورت،
هنگام برقراری تماس با سرویسهای Firebase با خطا مواجه خواهید شد.
اگر از Authentication مبتنی بر گذرواژه استفاده میکنید، سهمیه را محدود کنید
اگر از Firebase Authentication مبتنی بر گذرواژه استفاده میکنید و کسی به کلید میانای برنامهسازی کاربردی شما دسترسی پیدا کند، نمیتواند به هیچکدام از پایگاههای داده پروژه Firebase یا دادههای Cloud Storage شما دسترسی پیدا کند تا زمانی که این دادهها توسط Firebase Security Rules محافظت میشوند. اما میتوانند از کلید میانای برنامهسازی کاربردی شما برای دسترسی به نقاط پایانی اصالتسنجی Firebase و ارسال درخواستهای اصالتسنجی به پروژهتان استفاده کنند.
برای کاهش احتمال سوءاستفاده از کلید میانای برنامهسازی کاربردی برای
حمله جستجوی فراگیر، میتوانید سهمیه پیشفرض
نقطههای پایانی identitytoolkit.googleapis.com را محدود کنید تا ترافیک عادی
موردانتظار برنامهتان را منعکس کند. توجه داشته باشید که اگر این سهمیه را محدود کنید و برنامهتان
بهطور ناگهانی کاربران بیشتری جذب کند، ممکن است تا زمانی که سهمیه را افزایش ندهید، خطاهای ورود به سیستم دریافت کنید.
میتوانید سهمیههای API پروژهتان را در
کنسول Google Cloud تغییر دهید.
برای هر سرویس غیرFirebase، از کلیدهای میانای برنامهسازی کاربردی (API) جداگانه و محدودشده استفاده کنید
اگرچه کلیدهای میانای برنامهسازی کاربردی که برای سرویسهای Firebase استفاده میشوند معمولاً نیازی به رفتار محرمانه ندارند، باید اقدامات احتیاطی بیشتری را درخصوص کلیدهای میانای برنامهسازی کاربردی که با دیگر میاناهای برنامهسازی کاربردی Google Cloud استفاده میکنید انجام دهید.
اگر از میانای برنامهسازی کاربردی Google Cloud (در هر پلاتفرمی) استفاده میکنید که برای سرویس/ محصول Firebase نیست، اکیداً توصیه میکنیم کلیدهای میانای برنامهسازی کاربردی محدودشده جداگانهای برای استفاده با آن میاناهای برنامهسازی کاربردی ایجاد کنید. اگر API برای سرویس قابلصورتحساب Google Cloud باشد، این موضوع بسیار مهم است. بهویژه، هرگز
Gemini Developer API را در فهرست مجاز برای کلید میانای برنامهسازی کاربردی با دسترسی عمومی
یا کلیدی که برای سرویسهای دیگر استفاده میشود قرار ندهید.
بااستفاده از کلیدهای میانای برنامهسازی کاربردی جداگانه و محدودشده برای میاناهای برنامهسازی کاربردی غیرFirebase، میتوانید درصورت لزوم کلیدها را بچرخانید یا جایگزین کنید و محدودیتهای بیشتری به کلیدهای میانای برنامهسازی کاربردی اضافه کنید بدون اینکه استفاده شما از سرویسهای Firebase مختل شود.
مشاهده دستورالعملهای ایجاد کلیدهای مختص میانای برنامهسازی کاربردی
این دستورالعملها نحوه ایجاد کلید میانای برنامهسازی کاربردی جداگانه و محدودشده را برای
میانای برنامهسازی کاربردی جعلی بهنام Super Service API شرح میدهد.
مرحله ۱: کلیدهای میانای برنامهسازی کاربردی موجودتان را پیکربندی کنید تا دسترسی به Super Service API را غیرمجاز کنید
در کنسول Google Cloud، به صفحه میاناهای برنامهسازی کاربردی و سرویسها >
اطلاعات کاربری بروید.
اگر درخواست شد، پروژهتان را انتخاب کنید.
برای هر کلید API موجود در فهرست، نمای ویرایش را باز کنید.
در بخش محدودیتهای API، محدود کردن کلید را انتخاب کنید، سپس همه APIهایی را که میخواهید کلید API به آنها دسترسی داشته باشد به فهرست اضافه کنید. مطمئن شوید
که میانای برنامهسازی کاربردیای را که برای آن کلید میانای برنامهسازی کاربردی جداگانه ایجاد میکنید
دربرنگیرد (در این مثال، Super Service API).
وقتی محدودیتهای میانای برنامهسازی کاربردی را برای کلید میانای برنامهسازی کاربردی پیکربندی میکنید، بهطور صریح
میاناهای برنامهسازی کاربردی را که کلید به آنها دسترسی دارد اعلام میکنید. **بهطور پیشفرض، وقتی در بخش محدودیتهای API گزینه کلید محدود نشود انتخاب شده باشد، از کلید API میتوان برای دسترسی به هر API که برای پروژه فعال شده است استفاده کرد.**
اکنون، کلیدهای میانای برنامهسازی کاربردی موجود شما اجازه دسترسی به Super Service API را نخواهند داد، اما
هر کلید همچنان برای هر میانای برنامهسازی کاربردی که به فهرست
محدودیتهای میانای برنامهسازی کاربردی آن اضافه کردهاید کار خواهد کرد.
مرحله ۲: ایجاد و استفاده از کلید میانای برنامهسازی کاربردی جدید برای دسترسی به Super Service API
به صفحه میاناهای برنامهسازی کاربردی و سرویسها >
اطلاعات کاربری برگردید.
مطمئن شوید پروژه Firebase شما همچنان انتخاب شده باشد.
روی ایجاد اطلاعات کاربری > کلید میانای API کلیک کنید. کلید میانای API جدید را یادداشت کنید، سپس
روی محدود کردن کلید کلیک کنید.
در بخش محدودیتهای API، محدود کردن کلید را انتخاب کنید، سپس Super Service API را فقط به فهرست اضافه کنید.
این کلید میانای برنامهسازی کاربردی جدید فقط به Super Service API دسترسی میدهد.
برنامه و سرویسهایتان را برای استفاده از کلید میانای برنامهسازی کاربردی جدید پیکربندی کنید.
استفاده از کلیدهای میانای برنامهسازی کاربردی مختص محیط
اگر پروژههای Firebase مختلفی را برای محیطهای مختلف، مانند مرحلهبندی و تولید، راهاندازی کردهاید، مهم است که هر نمونه برنامه با پروژه Firebase مربوطه خود تعامل داشته باشد. برای مثال، نمونه برنامه مرحلهبندی شما هرگز نباید
با پروژه Firebase تولید شما ارتباط برقرار کند. این یعنی برنامه مرحله آمادهسازی شما باید از کلیدهای میانای برنامهسازی کاربردی مرتبط با پروژه Firebase مرحله آمادهسازی شما استفاده کند.
برای کاهش مشکلات مربوط به ارتقای تغییرات کد از مرحله توسعه به مرحله آمادهسازی و سپس به مرحله تولید، بهجای گنجاندن کلیدهای میانای برنامهسازی کاربردی در خود کد، آنها را بهعنوان متغیرهای محیطی تنظیم کنید یا در فایل پیکربندی بگنجانید.
پرسشگان و عیبیابی
پرسشگان
آیا کلیدهای میانای API
برای سرویسهای Firebase بهطور پیشفرض محدود شدهاند؟
میاناهای برنامهسازی کاربردی اضافهشده به این فهرست مجاز میاناهایی هستند که توسط سرویسهای Firebase از کد مشتری فراخوانی میشوند و برای شناسایی پروژه یا برنامه Firebase شما به کلیدهای میانای برنامهسازی کاربردی نیاز دارند. توجه داشته باشید که اکثر میاناهای برنامهسازی کاربردی موردنیاز برای استفاده از سرویسهای Firebase درواقع نیازی به قرار گرفتن در فهرست مجاز کلیدهای میانای برنامهسازی کاربردی شما ندارند.
ازآنجاییکه Firebase میاناهای برنامهسازی کاربردی لازم را برای همه سرویسهای Firebase اضافه میکند،
فهرست مجاز برای کلید میانای برنامهسازی کاربردی ممکن است شامل میاناهای برنامهسازی کاربردی برای محصولاتی باشد که از آنها استفاده نمیکنید. میتوانید
میاناهای برنامهسازی کاربردی را از فهرست مجاز بردارید، اما باید بسیار مراقب باشید که میاناهای برنامهسازی کاربردی موردنیاز برای Firebase و سرویسهای Firebase را که استفاده میکنید برندارید (فهرست میاناهای برنامهسازی کاربردی مرتبط با Firebase را که باید در فهرست مجاز برای هر سرویس/ محصول باشند ببینید). درغیراینصورت،
هنگام برقراری تماس با سرویسهای Firebase با خطا مواجه خواهید شد.
میتوانید همه کلیدهای API و «محدودیتهای API» آنها را در
میاناهای برنامهسازی کاربردی و سرویسها >
صفحه اطلاعات کاربری
کنسول Google Cloud مشاهده کنید.
به موارد زیر درباره نحوه اعمال این «محدودیتهای API» توسط Firebase توجه کنید:
از مه ۲۰۲۴، همه کلیدهای API جدید که بهطور خودکار توسط Firebase تأمین شدهاند، بهطور خودکار به فهرست APIهای مرتبط با Firebase محدود میشوند.
درطول ماه مه ۲۰۲۴، همه کلیدهای میانای برنامهسازی کاربردی موجود و نامحدود که Firebase قبلاً بهطور خودکار فراهم کرده بود به فهرست میاناهای برنامهسازی کاربردی مرتبط با Firebaseبهعلاوه هرکدام از میاناهای برنامهسازی کاربردی فعلاً فعالشده پروژه محدود میشوند.
هیچکدام از کلیدهای میانای API موجود و ازقبل محدودشده که Firebase قبلاً بهطور خودکار تأمین کرده بود تغییر نکردهاند.
کلیدهای میانای برنامهسازی کاربردی موجود که بهطور خودکار توسط Firebase تأمین نشدهاند
تغییر نکردهاند.
چگونه میتوانم تشخیص دهم که کدام کلید میانای برنامهسازی کاربردی
با Firebase App من مرتبط است؟
میتوانید از هریک از گزینههای زیر برای تعیین اینکه کدام کلید میانای API با برنامه Firebase شما مرتبط است استفاده کنید:
آیا میتوانم
دو کلید میانای برنامهسازی کاربردی فهرستشده برای یک «برنامه Firebase» در فایل/ شیء پیکربندی Firebase
خود داشته باشم؟
برنامههای Firebase Apple — هر برنامه فایل پیکربندی خودش را دارد و فقط میتواند یک کلید API فهرستشده داشته باشد.
برنامههای Firebase Android — همه برنامههای Android در پروژه Firebase در یک فایل پیکربندی فهرست شدهاند و هر برنامه فقط میتواند یک کلید میانای برنامهسازی کاربردی فهرستشده داشته باشد. بااینحال، هر برنامه در این فایل پیکربندی میتواند کلید متفاوتی داشته باشد.
برنامههای وب Firebase — هر برنامه شیء پیکربندی خودش را دارد و فقط میتواند یک کلید API فهرستشده داشته باشد.
اما میتوانید از چند کلید میانای API برای یک برنامه استفاده کنید. باید سازوکاری برای برنامهتان ارائه دهید تا به این کلیدهای میانای API دیگر دسترسی داشته باشد، مثلاً ازطریق متغیر محیطی. مکانیزم دسترسی به کلیدهای میانای برنامهسازی کاربردی دیگر نمیتواند به فهرست شدن آن کلیدهای میانای برنامهسازی کاربردی در فایل/ شیء پیکربندی Firebase شما وابسته باشد.
Firebase چگونه
میداند کدام کلید میانای برنامهسازی کاربردی را با برنامه مطابقت دهد (مثلاً در فایل/شیء
پیکربندی Firebase)؟
اگر Firebase هیچ کلید محدودشدهای را که مطابقت داشته باشد پیدا نکند،
iOS key را برای برنامههای Apple، Android key را برای برنامههای Android، و Browser key را برای برنامههای وب در فایل/ شیء پیکربندی فهرست میکند (با فرض اینکه این کلیدها وجود داشته باشند و هیچ «محدودیت برنامهای» که مانع از مطابقت آنها با آن برنامه شود نداشته باشند).
آیا میتوانم بهصورت دستی
کلید میانای API و فیلد را از فایل/ شیء پیکربندی Firebase حذف کنم؟
بله، میتوانید کلید میانای برنامهسازی کاربردی را بهصورت دستی از فایل/ شیء پیکربندی حذف کنید. بااینحال،
باید سازوکار دیگری برای دسترسی برنامهتان به کلید میانای برنامهسازی کاربردی ارائه دهید
(مثلاً ازطریق متغیر محیطی). درغیراینصورت، هرگونه تماس با سرویسهای Firebase
ناموفق خواهد بود.
آیا میتوانم بهصورت دستی
فایل/ شیء پیکربندی Firebase را با کلیدهای میانای برنامهسازی کاربردی متفاوت ویرایش کنم؟
بله، میتوانید فایل/ شیء پیکربندی را بهصورت دستی ویرایش کنید تا کلید میانای برنامهسازی کاربردی دیگری را به برنامه منسوب کنید.
آیا میتوانم کلید میانای برنامهسازی کاربردی را از یک پروژه Firebase به پروژه دیگری منتقل کنم؟
نه، کلید API فقط پروژه خاصی را شناسایی میکند و نمیتوان آن را به پروژه دیگری منتقل کرد.
اگر کلید میانای API فهرستشده در کنسول Google Cloud را حذف کنم چه اتفاقی میافتد؟
اگر کلید میانای API را که درحال استفاده توسط برنامهای است حذف کنید، فراخوانیهای میانای API از آن برنامه
ناموفق خواهد بود. ممکن است گزارشها، ایمیلها، یا خطاهایی دریافت کنید که نشان میدهد در تلاشید از کلید میانای برنامهسازی کاربردی نامعتبری استفاده کنید.
حذف کلید میانای برنامهسازی کاربردی دائمی است و نمیتوان آن را واگرد کرد.
کدام
میاناهای برنامهسازی کاربردی در فهرست مجاز «محدودیتهای میانای برنامهسازی کاربردی» برای کلید میانای برنامهسازی کاربردی Firebase لازم است؟
برای کلید Firebase API، تنها APIهایی که باید در فهرست مجاز «محدودیتهای API» کلید باشند، APIهایی هستند که از مشتری میخواهند یک کلید API همراه با تماس ارائه دهد. توجه داشته باشید که تعداد بسیار کمی از میاناهای برنامهسازی کاربردی مرتبط با Firebase این
الزام را دارند. اکثر میاناهای برنامهسازی کاربردی مرتبط با Firebase که در پروژهتان فعال شدهاند لازم نیست
در فهرست مجاز «محدودیتهای میانای برنامهسازی کاربردی» کلید باشند.
از جدول زیر برای تعیین اینکه کدام میاناهای برنامهسازی کاربردی مرتبط با Firebase باید در فهرست مجاز «محدودیتهای میانای برنامهسازی کاربردی» برای کلید میانای برنامهسازی کاربردی Firebase گنجانده شوند استفاده کنید. بهخاطر داشته باشید که
کلیدهای Firebase API فقط باید برای سرویسهای Firebase استفاده شوند. درباره ایجاد
کلیدهای API محدودشده و جداگانه برای انواع خاصی از API
بیشتر بدانید.
میتوانید کلیدهای میانای برنامهسازی کاربردی پروژهتان را در صفحه میاناهای برنامهسازی کاربردی و سرویسها >
اطلاعات کاربری
در کنسول Google Cloud مشاهده و مدیریت کنید.
* فقط درصورتی لازم است که از کلید Firebase API با ابزارهای طرف سوم یا دسترسی مستقیم REST به سرویس/ محصول Firebase استفاده میکنید.
** برای نسخههای قبلی کیت توسعه نرمافزار محصول الزامی است. اگر از
جدیدترین نسخه کیت توسعه نرمافزار استفاده میکنید، لازم نیست میانای برنامهسازی کاربردی در فهرست مجاز
کلید باشد.
عیبیابی
چگونه
خطای API_KEY_SERVICE_BLOCKED یا «ممنوع ۴۰۳» را که میگوید
درخواستهای ارسالشده به این API مسدود شده است برطرف کنم؟
اگر خطای API_KEY_SERVICE_BLOCKED یا خطایی شبیه به خطای زیر دریافت میکنید، راهنماییهای موجود در این پرسشگان را دنبال کنید:
Forbidden: 403 POST https://example-service.googleapis.com/method: Requests to this API example-service.googleapis.com method google.example-service.rest.method are blocked.
احتمالاً کلید میانای برنامهسازی کاربردی که برنامهتان برای فراخوانی میانای برنامهسازی کاربردی استفاده میکند،
«محدودیتهای میانای برنامهسازی کاربردی»
بر آن اعمال شده است و فهرست مجاز کلید شامل آن میانای برنامهسازی کاربردی نیست.
اگر هنگام تلاش برای استفاده از سرویس غیرFirebase این خطا را دریافت میکنید،
اکیداً توصیه میکنیم کلید API جدیدی بهطور خاص برای آن سرویس و
API ایجاد کنید. کلیدهای Firebase API باید فقط برای محصولات / سرویسهای Firebase استفاده شوند.
درباره ایجاد
کلیدهای API محدود و جداگانه برای انواع خاصی از API بیشتر بدانید.
چگونه این خطا را
برطرف کنم؟ «شناسه سنجش این برنامه Firebase از سرور واکشی نشد.»
احتمالاً کلید میانای API که برنامه وب شما استفاده میکند
«محدودیتهای API»
بر آن اعمال شده است. اگر اینطور است، مطمئن شوید Firebase Management API
در فهرست میاناهای برنامهسازی کاربردی مجاز باشد.
ایمیل یا خطایی دریافت کردم که میگوید
کلید میانای API من نامعتبر است. چه اتفاقی افتاده است و چگونه میتوانم این مشکل را برطرف کنم؟
در اینجا چند مورد از رایجترین دلایل نامعتبر بودن کلیدهای میانای برنامهسازی کاربردی (API) آورده شده است:
«محدودیتهای کلید میانای برنامهسازی کاربردی» بر کلید میانای برنامهسازی کاربردی اعمال شده است که باعث میشود با برنامهای که قصد استفاده از کلید را دارد مطابقت نداشته باشد («محدودیتهای برنامه») یا برای میانای برنامهسازی کاربردی که فراخوانی میشود قابلاستفاده نباشد («محدودیتهای میانای برنامهسازی کاربردی»).
کلید میانای برنامهسازی کاربردی از پروژه در کنسول Google Cloud حذف شد.
کلید میانای API برای «شناسه پروژه» فهرستشده در فایل/ شیء پیکربندی Firebase برنامه ایجاد نشده است.