firebase-admin.app package

Inisialisasi Aplikasi Firebase dan SDK.

Functions

Fungsi Deskripsi
applicationDefault(httpAgent) Menampilkan kredensial yang dibuat dari Kredensial Default Aplikasi Google yang memberikan akses admin ke layanan Firebase. Kredensial ini dapat digunakan dalam panggilan ke initializeApp().Kredensial Default Aplikasi Google tersedia pada semua infrastruktur Google, seperti Google App Engine dan Google Compute Engine.Lihat Menginisialisasi SDK untuk detail selengkapnya.
cert(serviceAccountPathOrObject, httpAgent) Menampilkan kredensial yang dibuat dari akun layanan yang disediakan yang memberikan akses admin ke layanan Firebase. Kredensial ini dapat digunakan dalam panggilan ke initializeApp().Lihat Menginisialisasi SDK untuk detail selengkapnya.
deleteApp(app) Merender App karena tidak dapat digunakan dan mengosongkan resource semua layanan terkait (meskipun *tidak* membersihkan resource backend). Saat menjalankan SDK secara lokal, metode ini harus dipanggil untuk memastikan penghentian proses secara halus.
getApp(appName)
getApps()
InitializeApp(options, appName)
refreshToken(refreshTokenPathOrObject, httpAgent) Menampilkan kredensial yang dibuat dari token refresh yang disediakan yang memberikan akses admin ke layanan Firebase. Kredensial ini dapat digunakan dalam panggilan ke initializeApp().Lihat Menginisialisasi SDK untuk detail selengkapnya.

Antarmuka

Antarmuka Deskripsi
Aplikasi Aplikasi Firebase menyimpan informasi inisialisasi untuk kumpulan layanan.
AppOptions Opsi yang tersedia untuk diteruskan ke initializeApp().
Kredensial Antarmuka yang menyediakan token akses Google OAuth2 yang digunakan untuk melakukan autentikasi dengan layanan Firebase.Pada umumnya, Anda tidak perlu menerapkannya sendiri dan dapat menggunakan implementasi default yang disediakan oleh modul firebase-admin/app.
FirebaseArrayIndexError Jenis komposit yang menyertakan objek FirebaseError dan indeks yang dapat digunakan untuk mendapatkan item yang mengalami error.
FirebaseError FirebaseError adalah subclass dari objek Error JavaScript standar. Selain string pesan dan pelacakan tumpukan, string ini berisi kode string.
GoogleOAuthAccessToken Antarmuka untuk token akses Google OAuth 2.0.
AkunLayanan

Variabel

Variabel Deskripsi
SDK_VERSION

applicationDefault(httpAgent)

Menampilkan kredensial yang dibuat dari Kredensial Default Aplikasi Google yang memberikan akses admin ke layanan Firebase. Kredensial ini dapat digunakan dalam panggilan ke InitializeApp().

Kredensial Default Aplikasi Google tersedia di semua infrastruktur Google, seperti Google App Engine dan Google Compute Engine.

Lihat Menginisialisasi SDK untuk mengetahui detail lebih lanjut.

Tanda Tangan:

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

Parameter

Parameter Jenis Deskripsi
Agen Agen Opsional Agen HTTP yang akan digunakan saat mengambil token akses dari server token Google.

Hasil:

Kredensial

Kredensial yang diautentikasi melalui Kredensial Default Aplikasi Google yang dapat digunakan untuk menginisialisasi aplikasi.

Contoh

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

cert(serviceAccountPathOrObject, httpAgent)

Menampilkan kredensial yang dibuat dari akun layanan yang disediakan yang memberikan akses admin ke layanan Firebase. Kredensial ini dapat digunakan dalam panggilan ke InitializeApp().

Lihat Menginisialisasi SDK untuk mengetahui detail lebih lanjut.

Tanda Tangan:

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

Parameter

Parameter Jenis Deskripsi
serviceAccountPathOrObject string | ServiceAccount Jalur ke file JSON kunci akun layanan atau objek yang mewakili kunci akun layanan.
Agen Agen Opsional Agen HTTP yang akan digunakan saat mengambil token akses dari server token Google.

Hasil:

Kredensial

Kredensial yang diautentikasi melalui akun layanan yang disediakan dan dapat digunakan untuk menginisialisasi aplikasi.

Contoh 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"
});

Contoh 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"
});

deleteApp(aplikasi)

Merender App karena tidak dapat digunakan dan mengosongkan resource semua layanan terkait (meskipun *tidak* membersihkan resource backend). Saat menjalankan SDK secara lokal, metode ini harus dipanggil untuk memastikan penghentian proses secara halus.

Tanda Tangan:

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

Parameter

Parameter Jenis Deskripsi
aplikasi Aplikasi

Hasil:

Promise<void>

Contoh

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

getApp(appName)

Tanda Tangan:

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

Parameter

Parameter Jenis Deskripsi
namaaplikasi string

Hasil:

Aplikasi

getApps()

Tanda Tangan:

export declare function getApps(): App[];

Hasil:

Aplikasi[]

inisialisasiApp(opsi, appName)

Tanda Tangan:

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

Parameter

Parameter Jenis Deskripsi
opsi AppOptions
namaaplikasi string

Hasil:

Aplikasi

refreshToken(refreshTokenPathOrObject, httpAgent)

Menampilkan kredensial yang dibuat dari token refresh yang disediakan yang memberikan akses admin ke layanan Firebase. Kredensial ini dapat digunakan dalam panggilan ke InitializeApp().

Lihat Menginisialisasi SDK untuk mengetahui detail lebih lanjut.

Tanda Tangan:

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

Parameter

Parameter Jenis Deskripsi
refreshTokenPathOrObject string | objek Jalur ke file JSON token refresh Google OAuth2 atau objek yang mewakili token refresh Google OAuth2.
Agen Agen Opsional Agen HTTP yang akan digunakan saat mengambil token akses dari server token Google.

Hasil:

Kredensial

Kredensial yang diautentikasi melalui akun layanan yang disediakan dan dapat digunakan untuk menginisialisasi aplikasi.

Contoh

// 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"
});

SDK_VERSION

Tanda Tangan:

SDK_VERSION: string