Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

תחילת השימוש ב-Firebase עם פרויקט קיים ב-Google Cloud

פרויקט Firebase הוא פרויקט Google Cloud שמופעלים בו כמה שירותים והגדרות נוספים שספציפיים ל-Firebase. הפעולה הזו נקראת בדרך כלל 'הוספת Firebase' לפרויקט Google Cloud. בדף הזה מוסבר איך מוסיפים את Firebase, ומופיעות בו שאלות נפוצות.

כשמוסיפים את Firebase לGoogle Cloudפרויקט, מערכת Firebase מפעילה באופן אוטומטי כמה ממשקי API ויוצרת חשבונות שירות כדי לפשט את השימוש בכל השירותים והממשקים של Firebase. בנוסף, Firebase מוסיף את התווית firebase:enabled לפרויקט בדף Labels במסוף Google Cloud, בקטע IAM & Admin. מידע נוסף על מה שקורה כשמוסיפים את Firebase

הקשר בין פרויקט Firebase לפרויקט Google Cloud

מכיוון שפרויקט Firebase הוא פרויקט Google Cloud:

אתם יכולים לגשת לפרויקט ולבצע בו פעולות בFirebase מסוף וגם במסוףGoogle Cloud וב Google APIs Console.
אפשר ליצור אינטראקציה עם הפרויקט באמצעות Firebase CLI,‏ gcloud CLI וכל משאב Terraform מ-Google.
אתם יכולים להשתמש במוצרים ובממשקי API גם מ-Firebase וגם מ-Google Cloud בפרויקט.
ההרשאות והתפקידים ב-IAM בפרויקט משותפים בין Firebase לבין Google Cloud. כל גישה שיש למשתמש בפרויקט (כלומר, לגורם ראשי) לפרויקט Google Cloud תחול גם על פרויקט Firebase (ולהפך).
החיוב על הפרויקט משותף בין Firebase לבין Google Cloud. אם החיוב מופעל בפרויקט Google Cloud, הפרויקט ב-Firebase יהיה בתוכנית Blaze בתשלום לפי שימוש של Firebase.
מזהים ייחודיים של הפרויקט (כמו מספר הפרויקט ומזהה הפרויקט) משותפים ל-Firebase ול-Google Cloud.
כל היררכיית משאבים שחלה על פרויקט Google Cloud (לדוגמה, ארגון, תיקיות וכו') תחול גם על פרויקט Firebase.
מחיקת הפרויקט תגרום למחיקה שלו ב-Firebase וב-Google Cloud.
מחיקה או שינוי של משאב או נתונים בפרויקט חלים על Firebase ועל Google Cloud.

איך מוסיפים את Firebase לפרויקט Google Cloud קיים

אפשר 'להוסיף Firebase' לפרויקט Google Cloud קיים באמצעות אחת מהאפשרויות הבאות. חשוב לוודא שיש לכם את ההרשאות הנדרשות להוספת Firebase לGoogle Cloud הפרויקט.

חשוב לדעת שאחרי שמוסיפים את Firebase לפרויקט קיים Google Cloud, אי אפשר לבטל את הפעולה הזו (כלומר, אי אפשר להסיר את Firebase מהפרויקט Google Cloud). מידע נוסף זמין בשאלות הנפוצות.

מסוף Firebase

נכנסים למסוף Firebase באמצעות החשבון שדרכו יש לכם גישה לפרויקט Google Cloud הקיים.
לוחצים על הלחצן כדי ליצור פרויקט חדש ב-Firebase.
בחלק התחתון של הדף, לוחצים על הוספת Firebase לפרויקט ב-Google Cloud.
בשדה הטקסט, מתחילים להזין את שם הפרויקט של הפרויקט הקיים, ואז בוחרים את הפרויקט מהרשימה שמוצגת.
לוחצים על פתיחת פרויקט.
אם תתבקשו, תצטרכו לאשר את התנאים וההגבלות של Firebase.
פועלים לפי ההוראות שמופיעות במסך כדי להוסיף את Firebase ולהגדיר פרויקט Firebase.

שימו לב: הפעלת הסיוע מבוסס-AI במסוף Firebase וב-Google Analytics היא אופציונלית.

Firebase CLI

אם עדיין לא עשיתם זאת, מתקינים את Firebase CLI.
מתחברים עם אותו חשבון Google שדרכו יש לכם גישה לפרויקט Google Cloud הקיים.
מריצים את הפקודה הבאה:
```
firebase projects:addfirebase
```
כשמופיעה בקשה, בוחרים את פרויקט Google Cloud הקיים מהרשימה שמוצגת.

‫API בארכיטקטורת REST

מפעילים את Firebase Management API בפרויקט הקיים ב-Google Cloud.
יוצרים אסימון גישה ל-API.
מפעילים את שירותי Firebase בפרויקט על ידי קריאה ל-projects.addFirebase.

שימו לב: כדי לבצע את השיחה הזו, תצטרכו את שם המשאב של הפרויקט.

הוראות מפורטות זמינות במאמר הוספת שירותי Firebase לפרויקט במדריך Firebase: 'הגדרה וניהול של פרויקט Firebase באמצעות Management API בארכיטקטורת REST'. חשוב לפעול לפי כל ההוראות בקטע לפני שמתחילים במדריך הזה.

Terraform

מפעילים את Firebase Management API ‏ (firebase.googleapis.com) בפרויקט הקיים Google Cloud.
מפעילים את שירותי Firebase בפרויקט באמצעות המשאב google_firebase_project.

מידע מפורט על שימוש ב-Firebase וב-Terraform זמין במאמר תחילת העבודה עם Terraform ו-Firebase.

שאלות נפוצות ופתרון בעיות

האם צריך לאשר את התנאים וההגבלות של Firebase כדי להתחיל להשתמש ב-Firebase?

כדי לגשת לכל היכולות של Firebase בGoogle Cloudפרויקט ולהשתמש בהן, צריך לאשר את התנאים וההגבלות של Firebase. כדי "להוסיף את Firebase" לפרויקט Google Cloud קיים, צריך גם לאשר את התנאים וההגבלות של Firebase.

צריך לאשר את התנאים של Firebase רק פעם אחת עבור חשבון Google, לא משנה לכמה פרויקטים יש לכם גישה. כשמאשרים את התנאים, האישור הוא רק לחשבון Google שלכם. האישור לא מתבצע ברמת הפרויקט עבור כל חברי הפרויקט.

אפשר לאשר את התנאים וההגבלות של Firebase דרך מסוף Firebase באחת מהדרכים הבאות. כשמוצגת בקשה, מאשרים את התנאים.

יוצרים פרויקט חדש ב-Firebase באמצעות מסוף Firebase.
פותחים פרויקט קיים ב-Firebase במסוף Firebase (לדוגמה, אם מישהו הזמין אתכם להצטרף לפרויקט כחברים, כלומר כסובייקטים).
פותחים פרויקט קיים Google Cloud במסוף Firebase ומוסיפים לו את Firebase.

אילו הרשאות נדרשות כדי 'להוסיף את Firebase'?

כדי "להוסיף את Firebase" לפרויקט קיים Google Cloud, חבר בפרויקט (כלומר, חשבון ראשי) צריך לקבל את הרשאות ה-IAM הבאות:

firebase.projects.update
resourcemanager.projects.get
serviceusage.services.enable
serviceusage.services.get

כברירת מחדל, התפקידים 'עריכה' ו'בעלים' ב-IAM כוללים את ההרשאות האלה.

למה לא ניתן לטעון במסוף Firebase רשימה של פרויקטים קיימים ב-Google Cloud?

השאלות הנפוצות האלה רלוונטיות בעיקר אם אתם מנסים 'להוסיף את Firebase' לפרויקט Google Cloud קיים באמצעות מסוף Firebase ויש לכם גישה לאלפי פרויקטים של Google Cloud.

מסוף Firebase לא מיועד לטעינה של אלפי פרויקטים של Google Cloud. במקום זאת, מומלץ להשתמש ב-CLI של Firebase, ב-API בארכיטקטורת REST או ב-Terraform כדי להוסיף את Firebase לפרויקט Google Cloud הקיים.

כדאי גם לעיין בשאלות הנפוצות 'למה הפרויקט שלי ב-Firebase לא מופיע ברשימת הפרויקטים ב-Firebase?'

האם מספיק להוסיף את התווית `firebase:enabled` כדי להוסיף את Firebase?

לכל פרויקט ב-Firebase יש תווית firebase:enabled בדף Labels (תוויות) בקטע IAM & Admin (ניהול הרשאות גישה ואדמין) במסוף Google Cloud.

עם זאת, הוספה ידנית של התווית firebase:enabled לרשימת תוויות הפרויקט לא מאפשרת להשתמש בהגדרות ובשירותים ספציפיים ל-Firebase בפרויקט Google Cloud. כדי לעשות את זה, צריך להוסיף את Firebase באמצעות מסוף Firebase (או, לתרחישי שימוש מתקדמים, באמצעות Firebase CLI,‏ Firebase Management API בארכיטקטורת REST או Terraform).Firebase

מה קורה כשמוסיפים את Firebase לפרויקט קיים של Google Cloud?

פרויקט Firebase הוא פרויקט Google Cloud שמופעלים בו כמה שירותים והגדרות נוספים שספציפיים ל-Firebase. לכן, כשאתם מוסיפים את Firebase לפרויקט קיים ב-Google Cloud, מערכת Firebase מבצעת את הפעולות הבאות כדי לפשט את השימוש בכל שירותי וממשקי Firebase:

התווית firebase:enabled מתווספת בדף Labels במסוף Google Cloud ‏IAM & Admin >‏.
יוצר מפתח API מסוג 'דפדפן' ומגביל אותו אוטומטית לממשקי API שקשורים ל-Firebase.
יוצר את חשבונות השירות הבאים:
- service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
- firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com
הפעלת ממשקי ה-API הבאים:
- App Engine Admin API
- Cloud Pub/Sub API
- Cloud Resource Manager API
- Cloud Runtime Configuration API
- Cloud Testing API
- Firebase Cloud Messaging API
- Firebase Dynamic Links API
- Firebase Hosting API
- Firebase Installations API
- Firebase Management API
- Firebase Remote Config API
- Firebase Remote Config Realtime API
- Firebase Rules API
- Identity Toolkit API
- Token Service API

האם אפשר 'להסיר את Firebase' מפרויקט?

אחרי שמוסיפים את Firebase לפרויקט Google Cloud קיים, אי אפשר לבטל את הפעולה הזו (כלומר, אי אפשר להסיר את Firebase מהפרויקט Google Cloud באופן מלא).

התהליך של 'הוספת Firebase' מפעיל ממשקי API ושירותי קצה עורפי שאפשר להשתמש בהם עבור Google Cloudתכונות אחרות. השבתה של כל השירותים המופעלים האלה עלולה לגרום לתוצאות לא צפויות ולא רצויות בגלל תלות בין השירותים.

עם זאת, אם תרצו, תוכלו להשבית ידנית את כל ממשקי ה-API ולמחוק את התווית, את מפתח ה-API ואת חשבונות השירות שהופעלו ונוצרו באופן אוטומטי כש "הוספתם את Firebase".

האם אפשר לחסום את האפשרות 'הוספת Firebase' לפרויקט Google Cloud קיים?

אי אפשר למנוע את האפשרות של 'הוספת Firebase' לפרויקט Google Cloud קיים, אבל אפשר לבצע את הפעולות הבאות:

הגבלת חברי הפרויקט (כלומר, ישויות מורשות) שיש להם הרשאת IAM‏ firebase.projects.update, שנדרשת כדי "להוסיף את Firebase".

השלבים הבאים

במאמרים הבאים תוכלו לקרוא מידע נוסף על פרויקטים ב-Firebase:
- הסבר על פרויקטים ב-Firebase – סקירות קצרות של כמה מושגים חשובים לגבי פרויקטים ב-Firebase, כולל הקשר שלהם ל-Google Cloud וההיררכיה הבסיסית של פרויקט, האפליקציות והמשאבים שלו.
- שיטות מומלצות כלליות להגדרת פרויקטים ב-Firebase – כוללות שיטות מומלצות כלליות וברמה גבוהה להגדרת פרויקטים ב-Firebase ולרישום האפליקציות בפרויקט, כדי שיהיה לכם תהליך פיתוח ברור שמשתמש בסביבות שונות.
כדי להתחיל להשתמש ב-Firebase באפליקציות לנייד ובאפליקציות לאינטרנט, צריך לרשום את האפליקציות בפרויקט Firebase ולקשר אותן ל-Firebase:‏ iOS+‎ |‏ Android |‏ Web |‏ Flutter |‏ Unity |‏ C++‎.