Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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

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

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

ניתן לציין שם ברירת מחדל של דלי בעת אתחול ה- SDK למנהלי מערכת. אז אתה יכול לאחזר הפניה מאומתת לדלי זה. שם הדלי לא יכול להכיל gs:// או קידומות פרוטוקול אחרות. לדוגמה, אם כתובת ה- bucket המוצגת במסוף 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

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