Bắt đầu sử dụng Firebase với một dự án Google Cloud hiện có

Dự án Firebase là một dự án Google Cloud đã bật một số cấu hình và dịch vụ bổ sung dành riêng cho Firebase. Đây thường được gọi là "thêm Firebase" vào một Google Cloud dự án. Trang này mô tả cách "thêm Firebase", cùng với một số câu hỏi thường gặp (FAQ).

Khi bạn thêm Firebase vào một dự án Google Cloud, Firebase sẽ tự động bật một số API và tạo tài khoản dịch vụ để đơn giản hoá việc sử dụng tất cả các dịch vụ và giao diện của Firebase. Firebase cũng thêm nhãn firebase:enabled vào dự án của bạn trong trang Nhãn của Google Cloud console. Tìm hiểu thêm thông tin chi tiết về những điều xảy ra khi bạn "thêm Firebase".

Mối quan hệ giữa dự án Firebase và dự án Google Cloud

Vì dự án Firebase là một dự án Google Cloud project:

• Bạn có thể truy cập và tương tác với dự án trong Firebase bảng điều khiển cũng như trong Google Cloud bảng điều khiển và Bảng điều khiển API của Google.

• Bạn có thể tương tác với dự án bằng Firebase CLI, the gcloud CLI, và mọi tài nguyên Terraform của Google.

• Bạn có thể sử dụng các sản phẩm và API của cả Firebase và Google Cloud trong dự án.

• Quyền và vai trò IAM cho dự án được chia sẻ trên Firebase và Google Cloud. Mọi quyền truy cập mà một thành viên dự án (tức là, một thực thể) có đối với dự án Google Cloud của bạn cũng sẽ áp dụng cho dự án Firebase (và ngược lại).

• Hoá đơn cho dự án được chia sẻ trên Firebase và Google Cloud. Nếu bạn bật tính năng thanh toán trên dự án Google Cloud, thì dự án Firebase của bạn sẽ sử dụng gói giá Blaze trả tiền theo mức dùng của Firebase.

• Các mã nhận dạng duy nhất cho dự án (như số dự án và mã dự án) được chia sẻ trên Firebase và Google Cloud.

• Mọi hệ phân cấp tài nguyên được áp dụng cho dự án Google Cloud (ví dụ: tổ chức, thư mục, v.v.) cũng sẽ áp dụng cho dự án Firebase.

• Việc xoá dự án sẽ xoá dự án đó trên Firebase và Google Cloud.

• Việc xoá hoặc sửa đổi tài nguyên hoặc dữ liệu trong dự án sẽ áp dụng trên Firebase và Google Cloud.

Cách thêm Firebase vào một dự án Google Cloud hiện có

Bạn có thể "thêm Firebase" vào một dự án Google Cloud hiện có bằng cách sử dụng bất kỳ lựa chọn sau đây. Hãy đảm bảo rằng bạn có các quyền cần thiết để thêm Firebase vào dự án Google Cloud.

Xin lưu ý rằng sau khi bạn "thêm Firebase" vào một dự án Google Cloud hiện có, bạn sẽ không thể hoàn tác thao tác này (tức là bạn không thể hoàn toàn "xoá Firebase" khỏi dự án Google Cloud). Tìm hiểu thêm trong phần Câu hỏi thường gặp này.

Lưu ý: Để truy cập và sử dụng tất cả các tính năng của Firebase trong một Google Cloud dự án, bạn cần chấp nhận Điều khoản dịch vụ của Firebase. Tìm hiểu thêm về yêu cầu đối với Điều khoản của Firebase trong phần Câu hỏi thường gặp này.

Sau đó, trên trang này, bạn có thể tìm thấy các câu hỏi thường gặp và cách khắc phục sự cố khác về việc "thêm Firebase" vào dự án Google Cloud.

Bảng điều khiển của Firebase

1. Đăng nhập vào bảng điều khiển bằng tài khoản cho phép bạn truy cập vào dự án hiện có.FirebaseGoogle Cloud

2. Nhấp vào nút để tạo một dự án Firebase mới.

3. Ở cuối trang, hãy nhấp vào Thêm Firebase vào dự án trên đám mây của Google.

4. Trong trường văn bản, hãy bắt đầu nhập tên dự án của dự án hiện có, sau đó chọn dự án trong danh sách hiển thị.

5. Nhấp vào Mở dự án.

6. Nếu được nhắc, hãy chấp nhận Điều khoản của Firebase.

7. Làm theo hướng dẫn trên màn hình để "thêm Firebase" và thiết lập một dự án Firebase.

   Xin lưu ý rằng bạn không bắt buộc phải bật tính năng trợ giúp AI trong bảng điều khiển Firebase và Google Analytics.

Firebase CLI

1. Nếu bạn chưa cài đặt, hãy cài đặt Firebase CLI.

2. Đăng nhập bằng cùng một Tài khoản Google cho phép bạn truy cập vào dự án Google Cloud hiện có.

3. Chạy lệnh sau:

   firebase projects:addfirebase

4. Khi được nhắc, hãy chọn dự án Google Cloud hiện có trong danh sách hiển thị.

Lưu ý: Nếu bạn gặp lỗi 403 PERMISSION_DENIED khi cố gắng "thêm Firebase" vào một dự án Google Cloud hiện có, thì có thể là do bạn không có các quyền cần thiết hoặc bạn chưa chấp nhận Điều khoản dịch vụ của Firebase.

API REST

1. Bật API Quản lý Firebase trong dự án hiện có Google Cloud.

2. Tạo mã truy cập API.

3. Bật các dịch vụ Firebase cho dự án bằng cách gọi projects.addFirebase.

   Xin lưu ý rằng bạn sẽ cần tên tài nguyên của dự án để thực hiện lệnh gọi này.

Để biết hướng dẫn chi tiết, hãy xem Thêm các dịch vụ Firebase vào dự án trong hướng dẫn về Firebase: "Thiết lập và quản lý dự án Firebase bằng API REST Quản lý". Hãy nhớ làm theo tất cả hướng dẫn trong phần Trước khi bắt đầu của hướng dẫn đó.

Lưu ý: Nếu bạn gặp lỗi 403 PERMISSION_DENIED khi cố gắng "thêm Firebase" vào một dự án Google Cloud hiện có, thì có thể là do bạn không có các quyền cần thiết hoặc bạn chưa chấp nhận Điều khoản dịch vụ của Firebase.

Terraform

1. Bật API Quản lý Firebase (firebase.googleapis.com) trong dự án hiện có Google Cloud.

2. Bật các dịch vụ Firebase cho dự án bằng tài nguyên google_firebase_project.

Để biết thông tin chi tiết về cách sử dụng Firebase và Terraform, hãy xem Bắt đầu sử dụng Terraform và Firebase.

Lưu ý: Nếu bạn gặp lỗi 403 PERMISSION_DENIED khi cố gắng "thêm Firebase" vào một dự án Google Cloud hiện có, thì có thể là do bạn không có các quyền cần thiết hoặc bạn chưa chấp nhận Điều khoản dịch vụ của Firebase.

Câu hỏi thường gặp và khắc phục sự cố

Có bắt buộc phải chấp nhận Điều khoản dịch vụ của Firebase để bắt đầu sử dụng Firebase không?

Để truy cập và sử dụng tất cả các tính năng của Firebase trong một Google Cloud dự án, bạn cần chấp nhận Điều khoản dịch vụ của Firebase. Bạn cũng cần chấp nhận Điều khoản của Firebase để "thêm Firebase" vào một dự án Google Cloud hiện có.

Bạn chỉ cần chấp nhận Điều khoản của Firebase một lần cho Tài khoản Google bất kể bạn có quyền truy cập vào bao nhiêu dự án. Khi chấp nhận các điều khoản, bạn chỉ chấp nhận cho Tài khoản Google của mình; việc chấp nhận không ở cấp dự án cho tất cả thành viên dự án.

Bạn có thể chấp nhận Điều khoản của Firebase thông qua Firebase bảng điều khiển bằng cách sử dụng bất kỳ lựa chọn nào sau đây. Khi được nhắc, hãy chấp nhận Điều khoản.

• Tạo một dự án Firebase mới bằng bảng điều khiển Firebase.

• Mở một dự án Firebase hiện có trong bảng điều khiển Firebase (ví dụ: ai đó đã mời bạn trở thành thành viên dự án (tức là một thực thể) trong dự án).

• Mở một Google Cloud hiện có trong bảng điều khiển Firebase và "thêm Firebase" vào dự án đó.

Lưu ý: Bạn không thể chấp nhận Điều khoản của Firebase bằng Firebase CLI, API REST hoặc Terraform. Bạn chỉ có thể thực hiện việc này bằng bảng điều khiển của Firebase.

Quan trọng: Nếu bạn ký vào một biến thể ngoại tuyến của Thoả thuận tổng thể của Google Cloud để sử dụng các dịch vụ Firebase được chỉ định bằng cùng một Tài khoản Google Cloud Platform, thì Điều khoản của Firebase sẽ không áp dụng cho việc bạn sử dụng các dịch vụ Firebase đó và các điều khoản ngoại tuyến sẽ điều chỉnh việc bạn sử dụng các dịch vụ Firebase đó.

Cần có những quyền nào để "thêm Firebase"?

Để "thêm Firebase" vào một dự án Google Cloud hiện có, một thành viên dự án (tức là một thực thể) phải có các quyền IAM sau đây:

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

Vai trò IAM của Người chỉnh sửa và Chủ sở hữu chứa các quyền này theo mặc định.

Tại sao bảng điều khiển của Firebase không tải được danh sách các dự án Google Cloud hiện có của tôi?

Câu hỏi thường gặp này thường áp dụng nhất nếu bạn đang cố gắng "thêm Firebase" vào một dự án Google Cloud hiện có bằng bảng điều khiển Firebase và bạn có quyền truy cập vào hàng nghìn dự án Google Cloud.

Bảng điều khiển của Firebase không được xây dựng để tải hàng nghìn dự án Google Cloud. Thay vào đó, bạn nên sử dụng Firebase CLI, API REST hoặc Terraform để "thêm Firebase" vào dự ánGoogle Cloud hiện có.

Ngoài ra, bạn có thể muốn xem lại câu hỏi thường gặp "Tại sao dự án Firebase của tôi không xuất hiện trong danh sách dự án Firebase?"

Việc thêm nhãn firebase:enabled có đủ để thêm Firebase không?

Tất cả dự án Firebase đều có nhãn firebase:enabledtrong trang Nhãn của Google Cloud console.

Tuy nhiên, việc chỉ thêm nhãn firebase:enabled vào danh sách nhãn dự án theo cách thủ công sẽ KHÔNG bật các cấu hình và dịch vụ dành riêng cho Firebase cho dự án Google Cloud của bạn. Để thực hiện việc đó, bạn cần thêm Firebase bằng bảng điều khiển của Firebase (hoặc, đối với các trường hợp sử dụng nâng cao, bằng Firebase CLI, API REST Quản lý Firebase hoặc Terraform).

Điều gì xảy ra khi bạn "thêm Firebase" vào một dự án Google Cloud hiện có?

Dự án Firebase là một dự án Google Cloud đã bật một số cấu hình và dịch vụ bổ sung dành riêng cho Firebase. Vì vậy, khi bạn "thêm Firebase" vào một dự án Google Cloud hiện có, Firebase sẽ thực hiện các hành động sau để đơn giản hoá việc sử dụng tất cả các dịch vụ và giao diện của Firebase:

• Thêm nhãn firebase:enabled trong trang Nhãn của Google Cloud console.

• Tạo khoá API "Trình duyệt" và tự động hạn chế khoá đó đối với các API liên quan đến Firebase.

• Tạo các tài khoản dịch vụ sau:

  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• Bật các API sau:

  • 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
  • API Quản lý Firebase
  • Firebase Remote Config API
  • Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

Tôi có thể "xoá Firebase" khỏi một dự án không?

Sau khi bạn "thêm Firebase" vào một dự án Google Cloud hiện có, bạn sẽ không thể hoàn tác thao tác này (tức là bạn không thể hoàn toàn "xoá Firebase" khỏi dự án Google Cloud).

Quá trình "thêm Firebase" cho phép các API và dịch vụ phụ trợ có thể được sử dụng cho các tính năng Google Cloud khác. Việc tắt tất cả các dịch vụ đã bật này có thể gây ra những hậu quả không mong muốn và không chủ ý do các phần phụ thuộc.

Tuy nhiên, nếu chọn, bạn có thể tắt tất cả các API theo cách thủ công và xoá nhãn, khoá API và tài khoản dịch vụ được tự động bật và tạo khi bạn "thêm Firebase".

Cảnh báo: Nếu bạn chọn tắt và xoá theo cách thủ công những gì đã xảy ra trong quá trình "thêm Firebase", hãy thực hiện một cách hết sức thận trọng. Bạn cần hoàn toàn chắc chắn rằng dự án Google Cloud và các ứng dụng liên kết với dự án không sử dụng bất kỳ nội dung nào liên quan đến những gì bạn đang tắt và xoá; nếu không, dự án hoặc ứng dụng của bạn có thể ngừng hoạt động hoặc hoạt động theo những cách không mong muốn.

Tôi có thể chặn việc "thêm Firebase" cho một dự án Google Cloud hiện có không?

Mặc dù bạn không thể thực sự chặn khả năng "thêm Firebase" vào một dự án Google Cloud hiện có, nhưng bạn có thể làm như sau:

Giới hạn các thành viên dự án (tức là các thực thể) có quyền IAM firebase.projects.update. Đây là quyền bắt buộc để "thêm Firebase".

Các bước tiếp theo

• Hãy xem các tài nguyên sau để tìm hiểu thêm về các dự án Firebase:

  • Tìm hiểu về các dự án Firebase — cung cấp thông tin tổng quan ngắn gọn về một số khái niệm quan trọng về các dự án Firebase, bao gồm cả mối quan hệ của các dự án này với Google Cloud và hệ phân cấp cơ bản của một dự án cũng như các ứng dụng và tài nguyên của dự án đó.

  • Các phương pháp hay nhất chung để thiết lập dự án Firebase — cung cấp các phương pháp hay nhất chung ở cấp cao để thiết lập dự án Firebase và đăng ký ứng dụng của bạn với một dự án để bạn có quy trình phát triển rõ ràng sử dụng các môi trường riêng biệt.

• Bắt đầu sử dụng Firebase trong các ứng dụng di động và web bằng cách đăng ký các ứng dụng với dự án Firebase và kết nối chúng với Firebase: iOS+ | Android | Web | Flutter | Unity | C++.