מבוא ל- API של אחסון בענן Admin

אחסון ענן עבור Firebase שומר את המידע שלך בתוך ענן אחסון Google דלי - פתרון אחסון אקסה בייט מידת אובייקט עם זמינות גבוהה ויתירות העולמית. ה- Firkase Admin SDK מאפשר לך לגשת ישירות לדליים שלך לאחסון ענן מסביבות מיוחדות. ואז אתה יכול להשתמש Google Cloud Storage APIs לתפעל אובייקטים מאוחסנים דליים.

השתמש בדלי ברירת מחדל

ניתן לציין שם ברירת מחדל של דלי בעת אתחול ה- SDK למנהלי מערכת. אז אתה יכול לאחזר הפניה מאומתת לדלי זה. השם הדלי אין לכלול gs:// או כול קידומות פרוטוקול אחרות. לדוגמה, אם כתובת האתר דלי המוצג Firebase קונסולת הוא gs://bucket-name.appspot.com , להעביר את המחרוזת bucket-name.appspot.com כדי SDK של מנהל המערכת.

Node.js

const admin = require('firebase-admin');

const serviceAccount = require('./path/to/serviceAccountKey.json');

admin.initializeApp({
  credential: admin.credential.cert(serviceAccount),
  storageBucket: '<BUCKET_NAME>.appspot.com'
});

const bucket = admin.storage().bucket();

// 'bucket' is an object defined in the @google-cloud/storage library.
// See https://googlecloudplatform.github.io/google-cloud-node/#/docs/storage/latest/storage/bucket
// for more details.

ג'אווה

FileInputStream serviceAccount = new FileInputStream("path/to/serviceAccountKey.json");

FirebaseOptions options = FirebaseOptions.builder()
    .setCredentials(GoogleCredentials.fromStream(serviceAccount))
    .setStorageBucket("<BUCKET_NAME>.appspot.com")
    .build();
FirebaseApp.initializeApp(options);

Bucket bucket = StorageClient.getInstance().bucket();

// 'bucket' is an object defined in the google-cloud-storage Java library.
// See http://googlecloudplatform.github.io/google-cloud-java/latest/apidocs/com/google/cloud/storage/Bucket.html
// for more details.

פִּיתוֹן

import firebase_admin
from firebase_admin import credentials
from firebase_admin import storage

cred = credentials.Certificate('path/to/serviceAccountKey.json')
firebase_admin.initialize_app(cred, {
    'storageBucket': '<BUCKET_NAME>.appspot.com'
})

bucket = storage.bucket()

# 'bucket' is an object defined in the google-cloud-storage Python library.
# See https://googlecloudplatform.github.io/google-cloud-python/latest/storage/buckets.html
# for more details.

ללכת

import (
	"context"
	"log"

	firebase "firebase.google.com/go/v4"
	"firebase.google.com/go/v4/auth"
	"google.golang.org/api/option"
)

config := &firebase.Config{
	StorageBucket: "<BUCKET_NAME>.appspot.com",
}
opt := option.WithCredentialsFile("path/to/serviceAccountKey.json")
app, err := firebase.NewApp(context.Background(), config, opt)
if err != nil {
	log.Fatalln(err)
}

client, err := app.Storage(context.Background())
if err != nil {
	log.Fatalln(err)
}

bucket, err := client.DefaultBucket()
if err != nil {
	log.Fatalln(err)
}
// 'bucket' is an object defined in the cloud.google.com/go/storage package.
// See https://godoc.org/cloud.google.com/go/storage#BucketHandle
// for more details.

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

השתמש בדליים בהתאמה אישית

אם ברצונך להשתמש בדלי אחסון בענן שאינו ברירת המחדל שצוינה לעיל, או להשתמש בדליים אחסון ענן באפליקציה אחת, תוכל לאחזר הפניה לדלי מותאם אישית כמוצג להלן:

Node.js

const bucket = admin.storage().bucket('my-custom-bucket');

ג'אווה

Bucket bucket = StorageClient.getInstance().bucket("my-custom-bucket");

פִּיתוֹן

bucket = storage.bucket('my-custom-bucket')

ללכת

 bucket, err := client.Bucket("my-custom-bucket")

השתמש ביישום Firebase מותאם אישית

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

Node.js

const bucket = customApp.storage().bucket();

ג'אווה

Bucket bucket = StorageClient.getInstance(customApp).bucket();

פִּיתוֹן

bucket = storage.bucket(app=custom_app)

ללכת

otherClient, err := otherApp.Storage(context.Background())
bucket, err := otherClient.Bucket("other-app-bucket")

ספריות לקוחות של Cloud Cloud Storage

ערכת פיתוח התוכנה Admin Firebase תלוי ספריות לקוח Google Cloud Storage לספק גישה לאחסון בענן. הפניות לדלי שהוחזרו על ידי מנהל ה- SDK הן אובייקטים המוגדרים בספריות אלה. עיין אזכור תיעוד API של ספריות לקוח Google Cloud Storage ללמוד כיצד להשתמש אזכור דלי חזר במקרים לשימוש כמו קובץ להעלות ו הורדה .