firebase-admin.app package

Khởi chạy SDK và ứng dụng Firebase.

Hàm

Chức năng Mô tả
applicationDefault(httpAgent) Trả về thông tin xác thực được tạo từ Thông tin xác thực mặc định của ứng dụng Google giúp cấp quyền quản trị đối với các dịch vụ trên Firebase. Thông tin đăng nhập này có thể được dùng trong lệnh gọi đến initializeApp().Thông tin xác thực mặc định của ứng dụng của Google có trên mọi cơ sở hạ tầng của Google, chẳng hạn như Google App Engine và Google Compute Engine.Hãy xem phần Khởi chạy SDK để biết thêm thông tin chi tiết.
certification(serviceAccountPathOrObject, httpAgent) Trả về thông tin xác thực được tạo từ tài khoản dịch vụ được cung cấp để cấp quyền quản trị vào các dịch vụ của Firebase. Thông tin đăng nhập này có thể được dùng trong lệnh gọi đến initializeApp().Hãy xem phần Khởi chạy SDK để biết thêm thông tin chi tiết.
deleteApp(ứng dụng) Hiển thị App này khi không sử dụng được và giải phóng tài nguyên của tất cả dịch vụ liên kết (mặc dù chức năng này *không* dọn dẹp bất kỳ tài nguyên phụ trợ nào). Khi chạy SDK cục bộ, phương thức này phải được gọi để đảm bảo việc kết thúc quy trình một cách linh hoạt.
getApp(tên ứng dụng)
getApps()
initializeApp(options, appName)
refreshToken(refreshTokenPathOrObject, httpAgent) Trả về thông tin xác thực được tạo từ mã làm mới được cung cấp để cấp quyền quản trị vào các dịch vụ của Firebase. Thông tin đăng nhập này có thể được dùng trong lệnh gọi đến initializeApp().Hãy xem phần Khởi chạy SDK để biết thêm thông tin chi tiết.

Giao diện

Giao diện Mô tả
Ứng dụng Ứng dụng Firebase lưu giữ thông tin khởi chạy của một tập hợp dịch vụ.
AppOptions Các tuỳ chọn có sẵn để chuyển đến initializeApp().
Thông tin xác thực Giao diện cung cấp mã truy cập Google OAuth2 được dùng để xác thực với các dịch vụ Firebase.Trong hầu hết các trường hợp, bạn sẽ không cần tự triển khai mà có thể sử dụng các phương thức triển khai mặc định do mô-đun firebase-admin/app cung cấp.
Lỗi FirebaseArrayIndex Loại tổng hợp bao gồm cả đối tượng FirebaseError và chỉ mục có thể dùng để lấy mục bị lỗi.
Lỗi Firebase FirebaseError là lớp con của đối tượng Error JavaScript chuẩn. Ngoài một chuỗi thông báo và dấu vết ngăn xếp, tệp này còn chứa một mã chuỗi.
GoogleOAuthAccessToken Giao diện cho mã truy cập Google OAuth 2.0.
Tài khoản dịch vụ

Biến

Biến Mô tả
SDK_VERSION

applicationDefault(httpAgent)

Trả về thông tin xác thực được tạo từ Thông tin xác thực mặc định của ứng dụng Google giúp cấp quyền quản trị đối với các dịch vụ trên Firebase. Thông tin đăng nhập này có thể được sử dụng trong lệnh gọi đến initializeApp().

Thông tin xác thực mặc định của ứng dụng trên Google có trên mọi cơ sở hạ tầng của Google, chẳng hạn như Google App Engine và Google Compute Engine.

Hãy xem bài viết Khởi chạy SDK để biết thêm thông tin chi tiết.

Chữ ký:

export declare function applicationDefault(httpAgent?: Agent): Credential;

Thông số

Thông số Loại Mô tả
httpNhân viên hỗ trợ Nhân viên hỗ trợ Sử dụng Tác nhân HTTP không bắt buộc khi truy xuất mã truy cập từ các máy chủ mã thông báo của Google.

Trường hợp trả lại hàng:

Thông tin xác thực

Thông tin đăng nhập được xác thực qua Thông tin xác thực mặc định của ứng dụng trên Google. Thông tin này có thể dùng để khởi chạy một ứng dụng.

Ví dụ

initializeApp({
  credential: applicationDefault(),
  databaseURL: "https://<DATABASE_NAME>.firebaseio.com"
});

Chứng chỉ(serviceAccountPathOrObject, httpAgent)

Trả về thông tin xác thực được tạo từ tài khoản dịch vụ được cung cấp để cấp quyền quản trị vào các dịch vụ của Firebase. Thông tin đăng nhập này có thể được sử dụng trong lệnh gọi đến initializeApp().

Hãy xem bài viết Khởi chạy SDK để biết thêm thông tin chi tiết.

Chữ ký:

export declare function cert(serviceAccountPathOrObject: string | ServiceAccount, httpAgent?: Agent): Credential;

Thông số

Thông số Loại Mô tả
serviceAccountPathOrObject string | ServiceAccount Đường dẫn đến tệp JSON của khoá tài khoản dịch vụ hoặc một đối tượng đại diện cho khoá tài khoản dịch vụ.
httpNhân viên hỗ trợ Nhân viên hỗ trợ Sử dụng Tác nhân HTTP không bắt buộc khi truy xuất mã truy cập từ các máy chủ mã thông báo của Google.

Trường hợp trả lại hàng:

Thông tin xác thực

Thông tin xác thực được xác thực qua tài khoản dịch vụ được cung cấp. Thông tin này có thể dùng để khởi chạy một ứng dụng.

Ví dụ 1

// Providing a path to a service account key JSON file
const serviceAccount = require("path/to/serviceAccountKey.json");
initializeApp({
  credential: cert(serviceAccount),
  databaseURL: "https://<DATABASE_NAME>.firebaseio.com"
});

Ví dụ 2

// Providing a service account object inline
initializeApp({
  credential: cert({
    projectId: "<PROJECT_ID>",
    clientEmail: "foo@<PROJECT_ID>.iam.gserviceaccount.com",
    privateKey: "-----BEGIN PRIVATE KEY-----<KEY>-----END PRIVATE KEY-----\n"
  }),
  databaseURL: "https://<DATABASE_NAME>.firebaseio.com"
});

xoá ứng dụng(ứng dụng)

Hiển thị App này khi không sử dụng được và giải phóng tài nguyên của tất cả dịch vụ liên kết (mặc dù chức năng này *không* dọn dẹp bất kỳ tài nguyên phụ trợ nào). Khi chạy SDK cục bộ, phương thức này phải được gọi để đảm bảo việc kết thúc quy trình một cách linh hoạt.

Chữ ký:

export declare function deleteApp(app: App): Promise<void>;

Thông số

Thông số Loại Mô tả
ứng dụng Ứng dụng

Trường hợp trả lại hàng:

Hứa hẹn<void>

Ví dụ

deleteApp(app)
  .then(function() {
    console.log("App deleted successfully");
  })
  .catch(function(error) {
    console.log("Error deleting app:", error);
  });

getApp(tên ứng dụng)

Chữ ký:

export declare function getApp(appName?: string): App;

Thông số

Thông số Loại Mô tả
tên ứng dụng chuỗi

Trường hợp trả lại hàng:

Ứng dụng

getApps()

Chữ ký:

export declare function getApps(): App[];

Trường hợp trả lại hàng:

Ứng dụng[]

LaunchApp(tuỳ chọn, appName)

Chữ ký:

export declare function initializeApp(options?: AppOptions, appName?: string): App;

Thông số

Thông số Loại Mô tả
tuỳ chọn AppOptions
tên ứng dụng chuỗi

Trường hợp trả lại hàng:

Ứng dụng

RefreshToken(refreshTokenPathOrObject, httpAgent)

Trả về thông tin xác thực được tạo từ mã làm mới được cung cấp để cấp quyền quản trị vào các dịch vụ của Firebase. Thông tin đăng nhập này có thể được sử dụng trong lệnh gọi đến initializeApp().

Hãy xem bài viết Khởi chạy SDK để biết thêm thông tin chi tiết.

Chữ ký:

export declare function refreshToken(refreshTokenPathOrObject: string | object, httpAgent?: Agent): Credential;

Thông số

Thông số Loại Mô tả
làm mớiTokenPathOrObject chuỗi | đối tượng Đường dẫn đến tệp JSON mã làm mới Google OAuth2 hoặc một đối tượng đại diện cho mã làm mới OAuth2 của Google.
httpNhân viên hỗ trợ Nhân viên hỗ trợ Sử dụng Tác nhân HTTP không bắt buộc khi truy xuất mã truy cập từ các máy chủ mã thông báo của Google.

Trường hợp trả lại hàng:

Thông tin xác thực

Thông tin xác thực được xác thực qua tài khoản dịch vụ được cung cấp. Thông tin này có thể dùng để khởi chạy một ứng dụng.

Ví dụ

// Providing a path to a refresh token JSON file
const refreshToken = require("path/to/refreshToken.json");
initializeApp({
  credential: refreshToken(refreshToken),
  databaseURL: "https://<DATABASE_NAME>.firebaseio.com"
});

PHIÊN_BẢN_SDK

Chữ ký:

SDK_VERSION: string